@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +180 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +30 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +87 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +19 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +70 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +21 -0
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +435 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +133 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.chart-dashboard-tile-sizes.md +40 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails-environment.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-dashboard-layout.md +61 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +90 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +240 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +78 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +34 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +188 -10
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +447 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +13 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -15
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +34 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +28 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +371 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# What makes a signature request SIGNED
|
|
2
|
+
|
|
3
|
+
## The life of a request
|
|
4
|
+
|
|
5
|
+
| State | Meaning | Final |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| SENT | Sent; nobody has signed yet, as far as the vendor reports. | no |
|
|
8
|
+
| PARTIALLY_SIGNED | The vendor reports that some signers signed. A claim, never evidence. | no |
|
|
9
|
+
| SIGNED | The signed document validated and proves every signer at the required level. | yes |
|
|
10
|
+
| DECLINED | A signer refused. | yes |
|
|
11
|
+
| EXPIRED | The vendor's deadline passed. | yes |
|
|
12
|
+
| CANCELLED | Withdrawn before it was signed, at the vendor or because its record went. | yes |
|
|
13
|
+
| FAILED | The evidence proves another signer or a lower level than required. | yes |
|
|
14
|
+
|
|
15
|
+
A final request absorbs every later event: a late notification changes nothing and is recorded.
|
|
16
|
+
|
|
17
|
+
## What the validation checks
|
|
18
|
+
|
|
19
|
+
A vendor's "completed" moves nothing by itself. The engine downloads the signed PDF and validates it:
|
|
20
|
+
|
|
21
|
+
- **Byte range.** Each signature covers the whole file except its own `/Contents`.
|
|
22
|
+
- **The bytes sent.** The file starts with exactly the approved bytes (their hash is the request's
|
|
23
|
+
`originalContentSha256`). A vendor that rewrites the file instead of appending to it is refused.
|
|
24
|
+
- **Nothing added but signing.** After those bytes, only signatures, their fields and appearances, the form, a page's
|
|
25
|
+
`/Annots` and a document security store (`/DSS`) may be added. After the last signature, only a `/DSS` update.
|
|
26
|
+
Every appended cross-reference section must be one the check read, chained to the one before it, so a section hidden
|
|
27
|
+
inside a stream's data cannot be the one a PDF reader follows.
|
|
28
|
+
- **The chain.** The signer's certificate chains, at the claimed signing time (which must fall within the request's
|
|
29
|
+
life), to an anchor the provider pins for its vendor environment.
|
|
30
|
+
- **Revocation.** Every certificate below the anchor has a CRL or OCSP response saying it is not revoked: the one the
|
|
31
|
+
signature carries, or a CRL fetched now from the certificate's distribution point.
|
|
32
|
+
- **Algorithms.** SHA-256, SHA-384 or SHA-512 throughout; SHA-1 and RSA keys under 2048 bits are refused.
|
|
33
|
+
- **Signer and level.** At ADVANCED, every signer's certificate names their e-mail address and carries a certificate
|
|
34
|
+
policy the provider declares as advanced.
|
|
35
|
+
|
|
36
|
+
A document that fails any check leaves the request open (the poll reads it again). One that validates but proves another
|
|
37
|
+
signer or a lower level ends it FAILED.
|
|
38
|
+
|
|
39
|
+
## The evidence it keeps
|
|
40
|
+
|
|
41
|
+
A SIGNED request names two files of its own, written in the same move: the signed PDF (a vendor-signed copy of the
|
|
42
|
+
original) and the validation's evidence as JSON (each signature, its chain, the check date, and every CRL and OCSP
|
|
43
|
+
response used). They go with the request when its record goes, and the record's legal holds keep them. Where your
|
|
44
|
+
application scans files, the signed PDF is linked to its request once its scan ends; the poll does it, so nothing is lost
|
|
45
|
+
while the scan runs. The audit trail records each sending, each move (with the hashes and the signers), each late event
|
|
46
|
+
and each cancellation.
|
|
47
|
+
|
|
48
|
+
## Watching it
|
|
49
|
+
|
|
50
|
+
The poll's batch output counts what each run sent, moved, linked and left pending. The metrics answer whether signing is
|
|
51
|
+
healthy without reading the audit rows:
|
|
52
|
+
|
|
53
|
+
| Metric | Labels | Worth an alert when |
|
|
54
|
+
|---|---|---|
|
|
55
|
+
| `signature_request_sent_total` | `outcome` (`sent` or the refusal), `required_level` | a refusal other than `already_open` keeps appearing |
|
|
56
|
+
| `signature_request_moved_total` | `provider`, `to` | `to="failed"` appears (a signer or level that can never be met) |
|
|
57
|
+
| `signature_request_evidence_refused_total` | `provider`, `failure` | any `failure` but `rejected`: the engine cannot validate or keep evidence |
|
|
58
|
+
| `signature_request_vendor_not_read_total` | `provider` | it rises steadily: the vendor is down |
|
|
59
|
+
| `signature_request_evidence_link_total` | `outcome` | `outcome="lost"`: a SIGNED request names evidence nothing keeps |
|
|
60
|
+
|
|
61
|
+
## Notifications
|
|
62
|
+
|
|
63
|
+
A vendor's notification names a request and nothing in it is believed: the request is re-read at the vendor's API, and
|
|
64
|
+
that answer decides. A notification about a request of an application-wide record (no organization) is dropped; the
|
|
65
|
+
poll re-reads that request within five minutes.
|
|
66
|
+
|
|
67
|
+
## Stated limits
|
|
68
|
+
|
|
69
|
+
- One document per request. A request the vendor split into several documents is left open.
|
|
70
|
+
- A signer's e-mail address is compared as it is now. One changed since the invitation does not match the certificate;
|
|
71
|
+
a signer with no address on record leaves the request open.
|
|
72
|
+
- An OCSP response the signature carries counts only once it verifies (signed by the certificate's issuer or a responder
|
|
73
|
+
it delegated to, and current).
|
|
74
|
+
- OCSP is read when the signature carries it, never fetched; the CRL is fetched instead.
|
|
75
|
+
- The appearance a signature field draws is not inspected.
|
|
76
|
+
- Signers are invited, and their certificate's e-mail compared, at the address in your database. Someone who can change
|
|
77
|
+
a signer's address can receive their invitation. Requiring identity proofing that does not rely on that data (an
|
|
78
|
+
identity document or eID checked by the vendor, proved by the certificate it issues) is designed and not yet available.
|
|
@@ -377,7 +377,7 @@ single self-contained reference shape for app developers.
|
|
|
377
377
|
|
|
378
378
|
## References
|
|
379
379
|
|
|
380
|
-
- `references/framework-email-attachments-and-limits.md` — `attachmentFileIds`, the framework's own size cap, and
|
|
380
|
+
- `references/framework-email-attachments-and-limits.md` — `attachmentFileIds`, the framework's own size cap, and when a send is handed to a declared `failover` vendor
|
|
381
381
|
- `references/email-artifact-paths.md` — where files live (template, labels, registry, type enum)
|
|
382
382
|
- `references/framework-email-template-api.md` — `EmailTemplateDefinition<TLabels>` + `EmailTemplateDefinitionsMap` types
|
|
383
383
|
- `references/framework-operation-email-template-ref-api.md` — the ref an operation's `userNotifications` email renders, and the directory it lives in, with worked cases (source-backed)
|
|
@@ -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
|
|
|
@@ -83,8 +83,18 @@ A screening or moderation declaration with no content-safety provider makes the
|
|
|
83
83
|
fails closed, by design, and it does so in EVERY environment that cannot serve it, so a provider and its
|
|
84
84
|
secrets authored for `local` only leave the agent refusing every turn in staging and production. The
|
|
85
85
|
backend warns at startup, one line per such agent, and `wildo local doctor` lists every authored
|
|
86
|
-
environment that cannot serve it.
|
|
87
|
-
|
|
86
|
+
environment that cannot serve it. On the development machine the classifier is usually a local double: the
|
|
87
|
+
provider's host secret names `127.0.0.1:<port>`, and `wildo local dev` starts the double on that port when the
|
|
88
|
+
application's root `package.json` declares `"@wildo-ai/provider-simulators": "*"` in its `devDependencies` (add it
|
|
89
|
+
in the same task that selects the provider). Without it nothing answers there, and every guarded turn is withheld
|
|
90
|
+
locally as `OUTPUT_NOT_MODERATED`. Two registry providers serve it: `azure-content-safety` screens and moderates
|
|
91
|
+
(its own Azure resource), `openai-moderation` moderates only, free, with an OpenAI key. An environment that is meant to
|
|
92
|
+
run without one (a staging stack with no key for it, while production has one) does not drop the declaration: it
|
|
93
|
+
states `agentContentGuardrails: { withoutClassifier: RUN_UNGUARDED, reason }` in its `wildo.infra.<env>.config.ts`, and
|
|
94
|
+
the agent runs unguarded there, named at startup. Never author that for an environment because a provider's setup is
|
|
95
|
+
pending; it is the operator's decision, and the infra-environment-config skill describes it. Until the application
|
|
96
|
+
selects a provider, declare `personalData`, and write one line at the agent saying which of the other two it will
|
|
97
|
+
declare and why. A guardrail that cannot treat
|
|
88
98
|
anything (an agent with no tools and no conversation, fed only text your code composes) is not declared at
|
|
89
99
|
all: a declaration that does nothing reads as a control. The contract and every refusal are in the
|
|
90
100
|
`flows-actors-chat-assistant` skill, `references/framework-agent-content-guardrails-api.md`.
|
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.
|
|
@@ -154,7 +162,9 @@ where none can serve it the agent refuses every turn, the backend warns at start
|
|
|
154
162
|
environment. To keep what it
|
|
155
163
|
**writes** within a content policy (no hate, sexual content, violence or self-harm reaching a person, a record or a
|
|
156
164
|
message), declare `contentGuardrails.outputModeration` with the severity to withhold per category. See
|
|
157
|
-
`references/framework-agent-content-guardrails-api.md`.
|
|
165
|
+
`references/framework-agent-content-guardrails-api.md`. When a reply instead reads *"This reply couldn't be checked
|
|
166
|
+
against the content policy"*, the classifier is configured and did not answer (on a development machine, usually its
|
|
167
|
+
local double is not running): that reference's section of the same name diagnoses it from the turn's audit event.
|
|
158
168
|
|
|
159
169
|
Every agent call leaves an **operation record** (`agentOperationRecords`): the model the provider answered with, each tool
|
|
160
170
|
call and how it ended, what the guardrails decided and how the call ended, never what a tool returned. You write
|
|
@@ -197,7 +207,7 @@ is not established. Read the `ai-use-declaration` skill before choosing the valu
|
|
|
197
207
|
|
|
198
208
|
| Declaration | Declare it when | Needs |
|
|
199
209
|
|---|---|---|
|
|
200
|
-
| `personalData: { treatment }` | always, on a language-model agent
|
|
210
|
+
| `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
211
|
| `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
212
|
| `outputModeration: { blockAtOrAbove }` | what the agent writes reaches a person, a record or a message | the same provider |
|
|
203
213
|
|
|
@@ -205,8 +215,18 @@ A screening or moderation declaration with no content-safety provider makes the
|
|
|
205
215
|
fails closed, by design, and it does so in EVERY environment that cannot serve it, so a provider and its
|
|
206
216
|
secrets authored for `local` only leave the agent refusing every turn in staging and production. The
|
|
207
217
|
backend warns at startup, one line per such agent, and `wildo local doctor` lists every authored
|
|
208
|
-
environment that cannot serve it.
|
|
209
|
-
|
|
218
|
+
environment that cannot serve it. On the development machine the classifier is usually a local double: the
|
|
219
|
+
provider's host secret names `127.0.0.1:<port>`, and `wildo local dev` starts the double on that port when the
|
|
220
|
+
application's root `package.json` declares `"@wildo-ai/provider-simulators": "*"` in its `devDependencies` (add it
|
|
221
|
+
in the same task that selects the provider). Without it nothing answers there, and every guarded turn is withheld
|
|
222
|
+
locally as `OUTPUT_NOT_MODERATED`. Two registry providers serve it: `azure-content-safety` screens and moderates
|
|
223
|
+
(its own Azure resource), `openai-moderation` moderates only, free, with an OpenAI key. An environment that is meant to
|
|
224
|
+
run without one (a staging stack with no key for it, while production has one) does not drop the declaration: it
|
|
225
|
+
states `agentContentGuardrails: { withoutClassifier: RUN_UNGUARDED, reason }` in its `wildo.infra.<env>.config.ts`, and
|
|
226
|
+
the agent runs unguarded there, named at startup. Never author that for an environment because a provider's setup is
|
|
227
|
+
pending; it is the operator's decision, and the infra-environment-config skill describes it. Until the application
|
|
228
|
+
selects a provider, declare `personalData`, and write one line at the agent saying which of the other two it will
|
|
229
|
+
declare and why. A guardrail that cannot treat
|
|
210
230
|
anything (an agent with no tools and no conversation, fed only text your code composes) is not declared at
|
|
211
231
|
all: a declaration that does nothing reads as a control. The contract and every refusal are in the
|
|
212
232
|
`flows-actors-chat-assistant` skill, `references/framework-agent-content-guardrails-api.md`.
|
|
@@ -475,11 +495,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
475
495
|
// owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
|
|
476
496
|
// DTO coerces the ISO `dueDate` string to a Date at the service boundary.
|
|
477
497
|
//
|
|
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
|
|
498
|
+
// `recurringType` IS declared (pinned to ONE_TIME): todos is a discriminated-union inheritance
|
|
499
|
+
// resource (one-time / recurring). Its CREATE DTO would fill the field's own default if this
|
|
500
|
+
// left it out (#2076), but the assistant only creates NON-recurring todos, so a literal is what
|
|
501
|
+
// states that: the model cannot select the recurring variant, whose extra fields
|
|
483
502
|
// (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
|
|
484
503
|
// defaulted (not merely optional) so they are always present for the discriminated base branch.
|
|
485
504
|
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
|
|
@@ -498,6 +517,10 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
498
517
|
.describe('Always "one_time"; the assistant creates non-recurring todos.'),
|
|
499
518
|
dueDate: z.string().optional()
|
|
500
519
|
.describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
|
|
520
|
+
// The todos CREATE takes an idempotency key (ACCEPTED, follow-up to #747): the tool takes it out of the arguments
|
|
521
|
+
// and the service tier answers the model's retry of the same create from the first outcome, so a retry after a
|
|
522
|
+
// lost answer does not add a second todo. Optional, like the operation's key.
|
|
523
|
+
idempotencyKey: z.string().describe(IDEMPOTENCY_KEY_TOOL_ARGUMENT_DESCRIPTION).optional(),
|
|
501
524
|
}),
|
|
502
525
|
}),
|
|
503
526
|
// WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
|
|
@@ -565,7 +588,7 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
565
588
|
- `references/framework-present-records-tool-api.md` — `presentRecordsTool()`: the agent shows its person records as summary cards in the conversation, kept as a reference and fetched with the viewer's session
|
|
566
589
|
- `references/framework-retrieval-tool-api.md` — `retrievalTool()`: the agent searches your `.ragSource()` fields as its person, cites the record and field of each passage, and reads `outcome` before answering
|
|
567
590
|
- `references/framework-ask-person-tool-api.md` — `askPersonTool()`: the agent pauses its turn to ask its person a structured question, answered through a form, and gets typed answers back
|
|
568
|
-
- `references/framework-agent-content-guardrails-api.md` — `contentGuardrails.personalData` (what the model is sent in place of a personal field's value, who reads the real values back, the `personalDataOutput` every tool declares), `contentGuardrails.promptInjection` (screening what others wrote before the model reads it), `contentGuardrails.outputModeration` (judging what the model writes before anyone reads, stores or sends it)
|
|
591
|
+
- `references/framework-agent-content-guardrails-api.md` — `contentGuardrails.personalData` (what the model is sent in place of a personal field's value, who reads the real values back, the `personalDataOutput` every tool declares), `contentGuardrails.promptInjection` (screening what others wrote before the model reads it), `contentGuardrails.outputModeration` (judging what the model writes before anyone reads, stores or sends it), `argumentsResource` on every write tool (what a guarded write may store), and how to diagnose a reply withheld because the classifier did not answer (`OUTPUT_NOT_MODERATED`, the local double `wildo local dev` starts)
|
|
569
592
|
- `references/framework-agent-suspension-api.md` — an administrator's runtime off switch for one agent: who may suspend and resume it (an organization's administrator, or the application's super-administrator for everybody), what a suspended agent's caller and conversation see, what is audited, and what a suspension does not stop
|
|
570
593
|
- `references/framework-agent-operation-record-api.md` — the `agentOperationRecords` row every agent call leaves: the model the provider reported, each tool call and how it ended, the guardrail verdicts and the end, never a tool's result; how to read it per run and as counts through the evidence door, and its retention
|
|
571
594
|
- `references/framework-agent-behavior-reports-api.md` — a person reports an agent's reply from the conversation (a closed category, an optional comment; the report points at the reply and never copies it), the organization's administrators triage, resolve or dismiss it against declared deadlines, and how it is audited, erased and measured
|
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
|
```
|