@wildo-ai/framework-knowledge 1.1.5 → 1.1.6
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 +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +320 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- 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 +0 -3
- 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 +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- 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 +8 -5
- 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 +55 -10
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- 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 +1 -6
- 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 +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 +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -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 +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- 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 +10 -3
- 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 +7 -3
- 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 +8 -3
- 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 +1 -1
- 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 +0 -1
- 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 +7 -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 +9 -4
- 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 +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- 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 +1 -1
- 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 +1 -3
- 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 +1 -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 +0 -1
- 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 +10 -3
- 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 +8 -3
- 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 +12 -5
- 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 +33 -5
- 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 +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- 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 +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +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 +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- 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 +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +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 +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +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 +0 -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 +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -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 +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -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 +0 -1
- 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 +1 -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 +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.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 +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- 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 +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1238 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3191 -1126
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5887 -1695
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: provider-operation-calls
|
|
3
|
-
description: Call a connected third-party provider's operation — from a backend service through the provider's
|
|
3
|
+
description: Call a connected third-party provider's operation — from a backend service through the provider's typed client, or from a frontend component through the authenticated browser door that only opens for operations the application declares in `providers.browserOperations`. Use when the user says "call the Asana API from my service", "post to a vendor from the backend", "use the provider client", "call a provider operation from a component", "my component needs data from a third-party API", "let the user pick a workspace", "load the choices for a provider input", "PROVIDER_OPERATION_REFUSED", "not_browser_reachable", "PROVIDER_OPERATION_SCOPE_NOT_GRANTED", or "the connected account needs one more permission".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Calling Provider Operations
|
|
@@ -23,7 +24,7 @@ An installed, scoped provider (see `provider-backend-package`) exposes OPERATION
|
|
|
23
24
|
`sendMessage` — that always run on the BACKEND, so the credential never leaves it. There are two ways
|
|
24
25
|
in, and they answer different callers:
|
|
25
26
|
|
|
26
|
-
1. **A backend service** calls the provider's
|
|
27
|
+
1. **A backend service** calls the provider's typed client, fed by the executor's
|
|
27
28
|
`forExecution(executionContext)`. The compiler checks the arguments.
|
|
28
29
|
2. **A frontend component** calls `executeProviderOperation`, which reaches an authenticated backend
|
|
29
30
|
route. It runs ONLY operations the application lists in `providers.browserOperations`, for the
|
|
@@ -37,7 +38,7 @@ is spent: the application's own (the default), an organization's, or the person'
|
|
|
37
38
|
| Surface | Glob (relative to app root) |
|
|
38
39
|
|---|---|
|
|
39
40
|
| Backend service calling a provider | `backend-api/src/**/*.backend.service.ts` |
|
|
40
|
-
|
|
|
41
|
+
| Typed client import | the `./backend` door of the provider's package — for a module installed with `wildo registry add wildo/providers/asana`, `@<your-scope>/provider-asana/backend` exports `createAsanaClient` (source in `providers/asana/backend/`) |
|
|
41
42
|
| Browser reachability policy | `wildo.saas.config.ts` → `providers.browserOperations.<ref>.<operationId>` |
|
|
42
43
|
| Which connections the product offers | `wildo.saas.config.ts` → `providers.connections.<ref>` |
|
|
43
44
|
| Component calling the browser door | `frontend/src/**/*.tsx` |
|
|
@@ -54,6 +55,10 @@ is spent: the application's own (the default), an organization's, or the person'
|
|
|
54
55
|
- Installing or scoping the provider in the first place — `provider-backend-package`.
|
|
55
56
|
- Reading a vendor's records INTO a resource (listing, syncing) — `resource-external-data`.
|
|
56
57
|
- A browser-side SDK or picker that must run in the browser — `provider-frontend-file-picker`.
|
|
58
|
+
- Making the application's OWN ERP do something (post an Odoo invoice, an OData action) — that ERP is
|
|
59
|
+
a system of record, never a provider, and no provider operation can name it. Declare the action on
|
|
60
|
+
its binding and call it through the system-of-record lane — `resource-external-data`
|
|
61
|
+
(`references/system-of-record-actions.md`).
|
|
57
62
|
|
|
58
63
|
## Workflow
|
|
59
64
|
|
|
@@ -63,6 +68,13 @@ Logic that runs in the backend (a hook, a batch, a custom operation): **typed cl
|
|
|
63
68
|
component that needs the answer on screen: **browser door**, Steps 3–4. Prefer the backend when the
|
|
64
69
|
call is a side effect of something the backend already does — it needs no policy and exposes nothing.
|
|
65
70
|
|
|
71
|
+
Either caller makes the vendor a RECIPIENT of whatever your code passes it, and no declaration says which fields
|
|
72
|
+
those are. So the compliance reports list the vendor with its categories NOT DERIVABLE ("flow undeclared"), and a
|
|
73
|
+
notice must say what it receives is not established. When the data comes from a resource, reaching the vendor
|
|
74
|
+
through a declared `httpApiBinding` or `externalDataPipeline` instead makes the categories derivable from the
|
|
75
|
+
resource's `.dataCategories()`. Either way, link the vendor to the purpose it serves with
|
|
76
|
+
`providerComplianceChoices.<ref>.purposeRefs` — see `compliance-document-authoring`.
|
|
77
|
+
|
|
66
78
|
### Step 2 — Backend: call through the typed client
|
|
67
79
|
|
|
68
80
|
Inject `SAAS_SERVICE_TYPES.ProviderOperationExecutorService`, build the client with
|
|
@@ -74,8 +86,9 @@ the request being served — never a synthesised one — or the call is attribut
|
|
|
74
86
|
|
|
75
87
|
Add `providers.browserOperations.<ref>.<operationId>` to `wildo.saas.config.ts`, listing the
|
|
76
88
|
`connections` a browser may spend and, where it matters, `allowedRoles`. Declaring an
|
|
77
|
-
application-owned connection REQUIRES roles.
|
|
78
|
-
|
|
89
|
+
application-owned connection REQUIRES roles. Every browser-triggered call is also counted per person and per
|
|
90
|
+
operation — `callerRateLimit` when declared, a framework default otherwise. Read
|
|
91
|
+
`references/framework-browser-operation-policy-api.md`, then run `wildo config sync`.
|
|
79
92
|
|
|
80
93
|
### Step 4 — Browser: call it from the component
|
|
81
94
|
|
|
@@ -94,6 +107,31 @@ such input's choices come from (`inputOptions` on the operation, see
|
|
|
94
107
|
which returns `{ optionsOperationId, options: [{ value, label }] }`. Pass a choice the list depends on
|
|
95
108
|
(Asana's projects depend on the workspace) in `input`; without it the answer is a 400 naming it.
|
|
96
109
|
|
|
110
|
+
### Step 4c — A missing permission: grow the connection, do not reconnect it
|
|
111
|
+
|
|
112
|
+
An operation that needs a scope the connected account was not granted is refused before anything is sent —
|
|
113
|
+
`409 PROVIDER_OPERATION_SCOPE_NOT_GRANTED` at the browser door, the executor's scope refusal in a backend
|
|
114
|
+
service — and the refusal carries a `reauthorization` offer. Start the connect flow for the same target with
|
|
115
|
+
`addScopes: offer.requestableScopes` and `forOperationId: offer.operationId`: the person is asked for the missing
|
|
116
|
+
scope only, and the grant keeps everything granted before. Scopes only an administrator can grant, or that the
|
|
117
|
+
connection cannot request, are listed apart with their remedy. Read
|
|
118
|
+
`references/framework-provider-scope-reauthorization-api.md`.
|
|
119
|
+
|
|
120
|
+
You do not have to build that button yourself. The frontend client (`executeProviderOperation`) records every
|
|
121
|
+
offer a refusal carries, and the engine's connected-accounts settings screen shows "grant more access" on the
|
|
122
|
+
row of the connection it belongs to — one row per connection, however many refs spend it. A feature may
|
|
123
|
+
therefore just tell the person the account needs more access and link to that screen; build your own action
|
|
124
|
+
only when the grant must grow without leaving the feature.
|
|
125
|
+
|
|
126
|
+
### Step 4d — A vendor's rate limit: the connection's budget waits for you
|
|
127
|
+
|
|
128
|
+
Every call spends its CONNECTION's rate budgets — keyed by what the vendor meters: the registration, and each account
|
|
129
|
+
under it — plus the ref's own ceiling, counted in the application's Redis for every process. Refs sharing one
|
|
130
|
+
connection share one allowance. A full budget WAITS (up to the provider's timeout) instead of sending a request the
|
|
131
|
+
vendor would answer `429`; past that it is refused as `RATE_BUDGET_EXHAUSTED`, and the call's audit row names the
|
|
132
|
+
budget (`rateBudget.exhaustedBudgetKey`). Pass `rateBudgetWaitMs: 0` to `execute` to refuse at once instead. Read
|
|
133
|
+
`references/framework-connection-rate-budgets-api.md`.
|
|
134
|
+
|
|
97
135
|
### Step 5 — Non-JSON answers and binary bodies
|
|
98
136
|
|
|
99
137
|
A hand-authored operation declares `responseDecoding: TEXT` for CSV/XML or `NONE` for a 204, and
|
|
@@ -103,44 +141,46 @@ the call.
|
|
|
103
141
|
|
|
104
142
|
## Worked Example
|
|
105
143
|
|
|
106
|
-
A backend service
|
|
144
|
+
A backend service listing the projects of one Asana workspace, from a person's own connected Asana account:
|
|
107
145
|
|
|
108
146
|
|
|
109
147
|
## Usage Example
|
|
110
148
|
|
|
111
149
|
```typescript
|
|
112
|
-
// import {
|
|
150
|
+
// import { createAsanaClient } from '@acme-app/provider-asana/backend';
|
|
113
151
|
//
|
|
114
152
|
// Inject the executor with `@inject(SAAS_SERVICE_TYPES.ProviderOperationExecutorService)`.
|
|
115
|
-
export async function
|
|
153
|
+
export async function listMyAsanaProjects(
|
|
116
154
|
providerOperations: ProviderOperationExecutorBackendService,
|
|
117
155
|
executionContext: ExecutionContext<any>,
|
|
118
|
-
|
|
119
|
-
|
|
156
|
+
userId: string,
|
|
157
|
+
workspaceGid: string,
|
|
120
158
|
): Promise<unknown> {
|
|
121
159
|
// `forExecution` binds the caller's execution context: the call is authorized and audited as THEM.
|
|
122
|
-
const
|
|
160
|
+
const asana = createAsanaClient(providerOperations.forExecution(executionContext));
|
|
123
161
|
|
|
124
|
-
// The second argument names WHOSE ACCOUNT is spent. Omitted, it is the application's own; here it is
|
|
125
|
-
//
|
|
126
|
-
return
|
|
127
|
-
{
|
|
162
|
+
// The second argument names WHOSE ACCOUNT is spent. Omitted, it is the application's own; here it is the
|
|
163
|
+
// person's own connected Asana account, which only that person may spend.
|
|
164
|
+
return asana.listProjects(
|
|
165
|
+
{ workspace: workspaceGid },
|
|
128
166
|
{
|
|
129
|
-
ownerScope: ExternalProvider_Connection_OwnerScope.
|
|
130
|
-
ownerId:
|
|
167
|
+
ownerScope: ExternalProvider_Connection_OwnerScope.USER,
|
|
168
|
+
ownerId: userId,
|
|
131
169
|
delegation: ExternalProvider_Connection_DelegationMode.SERVICE,
|
|
132
170
|
},
|
|
133
171
|
);
|
|
134
172
|
}
|
|
135
173
|
```
|
|
136
174
|
|
|
137
|
-
- `forExecution(executionContext)` is the whole of the wiring: authorization, the
|
|
138
|
-
|
|
139
|
-
- The connection names the
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
175
|
+
- `forExecution(executionContext)` is the whole of the wiring: authorization, the connection's rate
|
|
176
|
+
budgets and the audit row all follow from it.
|
|
177
|
+
- The connection names the PERSON'S own account, which only that person may spend. An organization's
|
|
178
|
+
account is named the same way, with `ownerScope: ORGANIZATION`, and the executor then checks the caller
|
|
179
|
+
belongs to that organization organization-wide before spending anything.
|
|
180
|
+
- The return type is what the provider's client declares: a described answer is typed with every field
|
|
181
|
+
optional (a vendor adding a field never breaks the call), and an undescribed one — like `listProjects`
|
|
182
|
+
here — is `unknown`, which is honest rather than a guess. An installed module is your code, so you may
|
|
183
|
+
describe the answer in `providers/<ref>/backend/` when you rely on its fields.
|
|
144
184
|
|
|
145
185
|
## References
|
|
146
186
|
|
|
@@ -149,6 +189,8 @@ export async function findDealMentions(
|
|
|
149
189
|
- `references/framework-rest-operation-contract-api.md` — the operation declaration, decodings, encodings (source-backed)
|
|
150
190
|
- `references/framework-frontend-execute-operation-api.md` — the component-side call (source-backed)
|
|
151
191
|
- `references/browser-door-answers.md` — every refusal and failure status, and what to do about each
|
|
192
|
+
- `references/framework-provider-scope-reauthorization-api.md` — the re-authorization offer a scope refusal carries, and growing the connection with `addScopes` (source-backed)
|
|
193
|
+
- `references/framework-connection-rate-budgets-api.md` — the connection's rate budgets, who shares them, waiting versus refusing, and declaring a vendor's limits (source-backed)
|
|
152
194
|
|
|
153
195
|
## Verification
|
|
154
196
|
|
|
@@ -159,6 +201,8 @@ export async function findDealMentions(
|
|
|
159
201
|
- [ ] Components handle a 403 by `reason`, not by message text
|
|
160
202
|
- [ ] `wildo config sync` ran after changing `providers.browserOperations`
|
|
161
203
|
- [ ] Every options operation an input picker calls is itself listed in `providers.browserOperations`
|
|
204
|
+
- [ ] A `PROVIDER_OPERATION_SCOPE_NOT_GRANTED` answer offers `reauthorization.requestableScopes` through `addScopes`, never a full reconnect
|
|
205
|
+
- [ ] No application code throttles a vendor with its own counter or `setTimeout` loop — the connection budget does it once for every process
|
|
162
206
|
|
|
163
207
|
### Grep invariants
|
|
164
208
|
|
|
@@ -168,6 +212,8 @@ export async function findDealMentions(
|
|
|
168
212
|
| No credential handled in application code | `rg -in "accessToken\|apiKey\|botToken" backend-api/src frontend/src` (must be empty) |
|
|
169
213
|
| Browser calls name declared operations | `rg -n "executeProviderOperation" frontend/src` then check each against `rg -n "browserOperations" wildo.saas.config.ts` |
|
|
170
214
|
| No component calls a vendor directly | `rg -n "fetch\(['\"]https://" frontend/src` (must be empty) |
|
|
215
|
+
| A scope refusal grows the connection | `rg -n "SCOPE_NOT_GRANTED" frontend/src` then check each handler passes `addScopes` to `startProviderConnection` |
|
|
216
|
+
| No hand-rolled vendor throttle | `rg -n "setTimeout\|sleep\|RATE_BUDGET" backend-api/src` (review each hit near a provider call) |
|
|
171
217
|
|
|
172
218
|
## Common Rationalizations
|
|
173
219
|
|
|
@@ -177,7 +223,10 @@ export async function findDealMentions(
|
|
|
177
223
|
| "Listing each operation is tedious; allow the whole provider" | There is no such switch, on purpose: a READ still spends a tenant's credential and returns whatever the vendor holds. One declaration per operation is the review. |
|
|
178
224
|
| "Any signed-in user may use the app's account" | Only if `allowedRoles` says who. The config refuses an application-owned connection without roles. |
|
|
179
225
|
| "I'll build an execution context for the call" | A synthesised context has no real roles or identity: organization targets are refused and the audit row names nobody. Use the request's. |
|
|
226
|
+
| "Odoo is our ERP; I'll declare a browser operation for `action_post`" | Odoo here is a system of record, reached only with the deployment's identity. The door refuses a provider ref it does not know, and there is no Odoo provider. Declare the action on the binding. |
|
|
180
227
|
| "The vendor returns CSV; I'll parse around the JSON error" | Declare `responseDecoding: TEXT`; the output is the CSV string. |
|
|
228
|
+
| "The operation needs one more permission; I'll ask for every scope up front" | An over-broad consent screen is the one a person refuses. Ask for the missing scope when the operation needs it — the refusal's offer names it — and the grant keeps what was granted before. |
|
|
229
|
+
| "The vendor keeps answering 429; I'll add a delay loop around the client" | A loop in one process cannot see the others, so replicas still overrun together. Declare (or ask the provider to declare) the vendor's limit; the connection budget waits across every process. |
|
|
181
230
|
| "I'll store the chosen workspace on the connection" | A workspace is a choice per call within the account; load it with `loadProviderOperationInputOptions` and pass it as input. The connection only records what the vendor reported at authorization. |
|
|
182
231
|
|
|
183
232
|
## Red Flags
|
|
@@ -187,6 +236,8 @@ export async function findDealMentions(
|
|
|
187
236
|
- A client built from something other than `forExecution` (catch with the **built from `forExecution`** grep)
|
|
188
237
|
- `executeProviderOperation` naming an operation absent from `providers.browserOperations` (catch with the **declared operations** grep)
|
|
189
238
|
- A 403 handled by matching its message text instead of `reason`
|
|
239
|
+
- A scope refusal answered by disconnecting and reconnecting with every scope (catch with the **scope refusal grows the connection** grep)
|
|
240
|
+
- A hand-written sleep or counter around a provider call (catch with the **no hand-rolled vendor throttle** grep)
|
|
190
241
|
|
|
191
242
|
## Related Skills
|
|
192
243
|
|
|
@@ -25,9 +25,9 @@ Checked in this order; the first that fails is the reason.
|
|
|
25
25
|
| 400 | `PROVIDER_OPERATION_INPUT_REJECTED` | The operation's own input schema refused `input`; `message` says which field |
|
|
26
26
|
| 401 | `UNAUTHENTICATED` | Not signed in |
|
|
27
27
|
| 409 | `PROVIDER_OPERATION_ACCESS_UNRESOLVED` | No credential for that account — usually "not connected yet" |
|
|
28
|
-
| 409 | `PROVIDER_OPERATION_SCOPE_NOT_GRANTED` | The connected account was not granted a scope the operation declares in `requiredScopes`; `missingScopes` names them and nothing was sent.
|
|
29
|
-
| 409 | `PROVIDER_OPERATION_NOT_EXECUTABLE` | The application enabled an operation its provider cannot run |
|
|
30
|
-
| 429 | `PROVIDER_OPERATION_RATE_LIMITED` |
|
|
28
|
+
| 409 | `PROVIDER_OPERATION_SCOPE_NOT_GRANTED` | The connected account was not granted a scope the operation declares in `requiredScopes`; `missingScopes` names them and nothing was sent. `reauthorization` offers the fix: start the connection again with `addScopes: reauthorization.requestableScopes` — only those are asked for and the grant keeps what it had (`framework-provider-scope-reauthorization-api.md`). Scopes in `administratorConsentScopes` need an administrator of the account |
|
|
29
|
+
| 409 | `PROVIDER_OPERATION_NOT_EXECUTABLE` | The application enabled an operation its provider cannot run — including one whose URL would leave the provider's base-URL origin (the detail is in the application log) |
|
|
30
|
+
| 429 | `PROVIDER_OPERATION_RATE_LIMITED` | Either this PERSON called the operation more often than its `callerRateLimit` allows (the framework default when none is declared: 60 a minute, 1000 an hour) — the answer then carries `retryAfterSeconds` and a `Retry-After` header — or the provider's own rate budget in this deployment is spent |
|
|
31
31
|
| 502 | `PROVIDER_OPERATION_VENDOR_FAILED` / `PROVIDER_OPERATION_CONTRACT_BREACH` | The vendor failed, or answered in a shape the operation does not declare |
|
|
32
32
|
| 503 | `PROVIDER_OPERATION_CATALOGUE_UNAVAILABLE` | The provider's operations could not be loaded |
|
|
33
33
|
| 504 | `PROVIDER_OPERATION_VENDOR_TIMEOUT` | The vendor did not answer in time |
|
|
@@ -46,14 +46,44 @@ receives `PROVIDER_OPERATION_REFUSED`.
|
|
|
46
46
|
* for a person's own account or a member acting for their own tenant, and it is REFUSED at parse time
|
|
47
47
|
* when the policy admits an `application`-owned connection: without roles, every signed-in person could
|
|
48
48
|
* spend the application's own vendor account.
|
|
49
|
+
*
|
|
50
|
+
* ## `callerRateLimit` — how often ONE person may trigger it (#561)
|
|
51
|
+
*
|
|
52
|
+
* Counted per signed-in person, per provider operation. Before it, the door's only limits were a
|
|
53
|
+
* per-provider window (off unless a provider declared one) and the IP-keyed perimeter limiter, so one
|
|
54
|
+
* person's typing into an address lookup could spend a vendor allowance the whole application shares.
|
|
55
|
+
*
|
|
56
|
+
* Absent does NOT mean unlimited: the framework applies
|
|
57
|
+
* {@link DEFAULT_PROVIDER_BROWSER_OPERATION_CALLER_RATE_LIMIT}, generous enough for a person typing into a
|
|
58
|
+
* lookup. The two differ in one way that matters, and it is the same split the rest of the engine draws
|
|
59
|
+
* between an authored and a default limit: a DECLARED limit fails CLOSED when the limiter's store is
|
|
60
|
+
* unavailable (the application stated it, so an outage must not quietly lift it), while the framework
|
|
61
|
+
* default fails OPEN (nobody declared it, so it must never be why a door stops working).
|
|
49
62
|
*/
|
|
50
63
|
export const ProviderBrowserOperationPolicySchema = z.strictObject({
|
|
51
64
|
connections: z.array(ExternalProvider_ConnectionShapeSchema).min(1),
|
|
52
65
|
allowedRoles: z.array(z.string().trim().min(1)).min(1).optional(),
|
|
66
|
+
callerRateLimit: RateLimitConfigurationSchema.optional(),
|
|
53
67
|
}).superRefine((policy, ctx) => {
|
|
54
68
|
const admitsApplicationAccount = policy.connections.some(
|
|
55
69
|
(shape) => shape.ownerScope === ExternalProvider_Connection_OwnerScope.APPLICATION,
|
|
56
70
|
);
|
|
71
|
+
// A declared limit with no window counts nothing, yet reads as DECLARED — the framework default is then not applied
|
|
72
|
+
// either. A control that looks enforced and enforces nothing is refused where it is written (#561).
|
|
73
|
+
const limit = policy.callerRateLimit;
|
|
74
|
+
if (limit !== undefined
|
|
75
|
+
&& limit.requestsPerMinute === undefined
|
|
76
|
+
&& limit.requestsPerHour === undefined
|
|
77
|
+
&& limit.requestsPerDay === undefined
|
|
78
|
+
&& (limit.customWindows === undefined || limit.customWindows.length === 0)) {
|
|
79
|
+
ctx.addIssue({
|
|
80
|
+
code: 'custom',
|
|
81
|
+
path: ['callerRateLimit'],
|
|
82
|
+
message:
|
|
83
|
+
'`callerRateLimit` declares no window, so it would count nothing and replace the framework default. '
|
|
84
|
+
+ 'Declare at least one of requestsPerMinute, requestsPerHour, requestsPerDay or customWindows, or omit it.',
|
|
85
|
+
});
|
|
86
|
+
}
|
|
57
87
|
if (admitsApplicationAccount && policy.allowedRoles === undefined) {
|
|
58
88
|
ctx.addIssue({
|
|
59
89
|
code: 'custom',
|
|
@@ -66,6 +96,37 @@ export const ProviderBrowserOperationPolicySchema = z.strictObject({
|
|
|
66
96
|
});
|
|
67
97
|
export type ProviderBrowserOperationPolicy = z.infer<typeof ProviderBrowserOperationPolicySchema>;
|
|
68
98
|
|
|
99
|
+
/**
|
|
100
|
+
* The per-person limit a browser-reachable operation gets when its policy declares none (#561).
|
|
101
|
+
*
|
|
102
|
+
* Sized for the most frequent legitimate caller, a person typing into an address lookup: suggestions start at
|
|
103
|
+
* three characters and are debounced, so one address is a handful of calls, and sixty a minute is a person
|
|
104
|
+
* typing without pause. The hourly window is what stops a script holding a session from draining a vendor
|
|
105
|
+
* allowance at a steady sixty a minute.
|
|
106
|
+
*/
|
|
107
|
+
export const DEFAULT_PROVIDER_BROWSER_OPERATION_CALLER_RATE_LIMIT: RateLimitConfiguration = Object.freeze({
|
|
108
|
+
requestsPerMinute: 60,
|
|
109
|
+
requestsPerHour: 1000,
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
/** Where the limit a browser-triggered call is counted against came from — and so how an outage of the limiter is treated. */
|
|
113
|
+
export enum ProviderBrowserOperationCallerRateLimitSource {
|
|
114
|
+
/** Declared on the policy: fails CLOSED on a limiter outage. */
|
|
115
|
+
DECLARED = 'DECLARED',
|
|
116
|
+
/** The framework default: fails OPEN on a limiter outage. */
|
|
117
|
+
FRAMEWORK_DEFAULT = 'FRAMEWORK_DEFAULT',
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/** The one reading of a policy's per-person limit: its own, or the framework default, and which. */
|
|
121
|
+
export function resolveProviderBrowserOperationCallerRateLimit(policy: Pick<ProviderBrowserOperationPolicy, 'callerRateLimit'>): {
|
|
122
|
+
readonly limit: RateLimitConfiguration;
|
|
123
|
+
readonly source: ProviderBrowserOperationCallerRateLimitSource;
|
|
124
|
+
} {
|
|
125
|
+
return policy.callerRateLimit === undefined
|
|
126
|
+
? { limit: DEFAULT_PROVIDER_BROWSER_OPERATION_CALLER_RATE_LIMIT, source: ProviderBrowserOperationCallerRateLimitSource.FRAMEWORK_DEFAULT }
|
|
127
|
+
: { limit: policy.callerRateLimit, source: ProviderBrowserOperationCallerRateLimitSource.DECLARED };
|
|
128
|
+
}
|
|
129
|
+
|
|
69
130
|
/**
|
|
70
131
|
* `providerRef` → `operationId` → policy. The operation id is the catalogue's own, exactly as a typed
|
|
71
132
|
* client or an ETL binding reference names it.
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
# Connection rate budgets — one vendor allowance, however many refs and processes spend it
|
|
2
|
+
|
|
3
|
+
Read this when:
|
|
4
|
+
|
|
5
|
+
- a call is refused with `RATE_BUDGET_EXHAUSTED`, or its audit row carries `rateBudget.exhaustedBudgetKey`;
|
|
6
|
+
- a vendor answers `429` and you want the engine to wait before sending instead;
|
|
7
|
+
- you author a provider that owns a vendor's registration and want to declare the vendor's published limits;
|
|
8
|
+
- several refs of one vendor share a connection (`providers.sharedConnections`) and you wonder whose limit they spend.
|
|
9
|
+
|
|
10
|
+
## What is counted, and where
|
|
11
|
+
|
|
12
|
+
A vendor limits the APPLICATION REGISTRATION a call spends — Microsoft Graph "per app across all tenants", Google
|
|
13
|
+
"per project" — and, under it, often each account the registration acts for. So every provider call spends:
|
|
14
|
+
|
|
15
|
+
| budget | key | declared by |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| the connection's allowance | `connection:<connectionRef>[:audience:<id>[@<host>]]:per<N>s` | the connection's BASE provider, `partition: connection` |
|
|
18
|
+
| each account's allowance | `…:owner:<scope>:<ownerId>:per<N>s` | the base provider, `partition: owner` |
|
|
19
|
+
| this ref's share | `provider:<ref>` | the ref's own `remoteCallSemantics.maxRequestsPerMinute` |
|
|
20
|
+
|
|
21
|
+
Refs on one shared connection spend the SAME connection budget: `microsoft`, `microsoft-teams` and
|
|
22
|
+
`microsoft-planner` are one Graph application to Microsoft. A member ref's own declarations are ignored, like its
|
|
23
|
+
OAuth client; a ref's `maxRequestsPerMinute` is a narrower ceiling inside the connection, never the vendor's limit.
|
|
24
|
+
|
|
25
|
+
Budgets are counted in the application's Redis, once for every backend replica, minion and worker. A process with no
|
|
26
|
+
Redis (or a Redis that does not answer) counts on its own, and the call's audit row says so with
|
|
27
|
+
`rateBudget.counting: "process"` instead of `"shared"`.
|
|
28
|
+
|
|
29
|
+
## Every lane that spends a connection spends the same budget
|
|
30
|
+
|
|
31
|
+
A connection's grant is spent by more than provider operations, and every one of those lanes draws on the same budgets,
|
|
32
|
+
with the same keys:
|
|
33
|
+
|
|
34
|
+
- **provider operations** (`execute`), as above;
|
|
35
|
+
- **Google Drive file storage**: a file read or upload through a person's Google connection is a spend of that
|
|
36
|
+
connection, so a Drive read and a Google provider operation for that person share one window;
|
|
37
|
+
- **file storages a provider package contributes** (`fileStorageAdapters`): each call to the adapter spends ONE unit
|
|
38
|
+
of the contributing provider's connection, for the owner whose grant it spends (the uploader, or the file's
|
|
39
|
+
organization), on the connection's primary audience when it declares audiences. The engine cannot see the requests
|
|
40
|
+
inside an adapter call, so the unit is the act, not the wire;
|
|
41
|
+
- **MCP servers an agent reaches**: every request of a session (`initialize`, `tools/list`, each `tools/call`) spends
|
|
42
|
+
the connection its credential is stored under, keyed on the audience the server's host selects. A request refused
|
|
43
|
+
for budget is reported to the agent as `rate_budget_exhausted`, and nothing is sent.
|
|
44
|
+
|
|
45
|
+
So a limit you declare on a connection's base binds all of them. Declaring it on one lane's behalf is enough.
|
|
46
|
+
|
|
47
|
+
A vendor that meters in weighted UNITS rather than requests is left undeclared. Google Drive is the example: a read
|
|
48
|
+
costs 5 units and a download 200, so any per-request number would either admit far more than the quota or refuse
|
|
49
|
+
reads the vendor would serve. Its own `403`/`429` is the limit until a budget can weigh a call.
|
|
50
|
+
|
|
51
|
+
## A full budget waits, then refuses
|
|
52
|
+
|
|
53
|
+
A call whose budget is full WAITS for room, up to the provider's per-attempt timeout, and records the wait
|
|
54
|
+
(`rateBudget.waitedMs`). Past that bound it is refused before anything is sent, as `RATE_BUDGET_EXHAUSTED`, and the
|
|
55
|
+
audit row names the budget that was full. A caller that would rather refuse at once passes `rateBudgetWaitMs: 0` to
|
|
56
|
+
`execute`; a longer-running caller (a batch) may pass a larger bound.
|
|
57
|
+
|
|
58
|
+
## Declaring a vendor's limits (provider authors)
|
|
59
|
+
|
|
60
|
+
Declare each published limit where it applies: on the REST contract (`rest.rateBudgets`) for a connection whose tokens
|
|
61
|
+
serve one resource, and on each OAuth2 audience (`oauth2.audiences.<id>.rateBudgets`) for a connection spanning
|
|
62
|
+
several — each resource is metered by its own service. Both at once is refused at boot, as is a non-positive number.
|
|
63
|
+
Take the numbers from the vendor's own documentation and cite it; a limit that counts OTHER applications' traffic
|
|
64
|
+
("per tenant for all apps") cannot be counted locally and is not declared.
|
|
65
|
+
|
|
66
|
+
## Import Origins
|
|
67
|
+
|
|
68
|
+
- `@wildo-ai/external-connectors-models`
|
|
69
|
+
|
|
70
|
+
## Source Excerpts
|
|
71
|
+
|
|
72
|
+
### Origin Package: `@wildo-ai/external-connectors-models`
|
|
73
|
+
|
|
74
|
+
```typescript
|
|
75
|
+
/**
|
|
76
|
+
* WHOSE allowance a vendor counts a request against, under one connection (#1729).
|
|
77
|
+
*
|
|
78
|
+
* A connection is one application registration at the vendor (one OAuth client, one API project) — the
|
|
79
|
+
* base provider's, however many refs spend it. Vendors meter on two axes of it, and a provider declares the
|
|
80
|
+
* one each of its limits uses:
|
|
81
|
+
*
|
|
82
|
+
* | vendor wording | member |
|
|
83
|
+
* |---|---|
|
|
84
|
+
* | Microsoft Graph "per app across all tenants"; Google "per minute per project" | {@link CONNECTION} |
|
|
85
|
+
* | Google "per minute per user per project"; Dataverse "for each user"; Graph "per app per tenant" / "per app and mailbox" when the grant owner IS that tenant or mailbox | {@link OWNER} |
|
|
86
|
+
*
|
|
87
|
+
* spec-cite: https://learn.microsoft.com/en-us/graph/throttling-limits — the global-limits table ("Per app across all
|
|
88
|
+
* tenants") and the scope list "per app across all tenants, per tenant for all apps, per app per tenant"; and
|
|
89
|
+
* https://developers.google.com/workspace/drive/api/guides/limits — "per minute per project" / "per minute per user per
|
|
90
|
+
* project". Fetched 2026-09-28.
|
|
91
|
+
*
|
|
92
|
+
* Deliberately NOT a member: "per tenant for all apps" (Graph). It counts OTHER applications' calls, which this
|
|
93
|
+
* deployment cannot see, so no local counter can hold it; the vendor's `429` is the only honest signal there.
|
|
94
|
+
*/
|
|
95
|
+
export enum ProviderRateBudgetPartition {
|
|
96
|
+
/** One allowance for the whole connection — every ref, every account it acts for, every process. */
|
|
97
|
+
CONNECTION = 'connection',
|
|
98
|
+
/** One allowance per account the connection acts for — the grant's owner (a person, an organization, the deployment). */
|
|
99
|
+
OWNER = 'owner',
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* One limit a vendor publishes, as the connection's BASE provider declares it (#1729).
|
|
104
|
+
*
|
|
105
|
+
* Read only from the connection's base: a member ref's declaration is inert, exactly like a member's OAuth client,
|
|
106
|
+
* because the limit belongs to the registration and the base owns the registration. Declared on the REST contract
|
|
107
|
+
* (`rest.rateBudgets`) for a connection whose tokens serve one resource, and on each OAuth2 AUDIENCE
|
|
108
|
+
* (`oauth2.audiences.<id>.rateBudgets`) for a connection spanning several — Microsoft Graph and a Dataverse
|
|
109
|
+
* environment are metered by different services with different numbers, so one list for both would be wrong for one.
|
|
110
|
+
*
|
|
111
|
+
* Counted by the engine BEFORE a request leaves: a call waits for room (bounded, see the executor's
|
|
112
|
+
* `rateBudgetWaitMs`) instead of spending a request the vendor would answer with `429`. The window is SLIDING, which
|
|
113
|
+
* is at least as strict as a vendor's fixed window of the same length.
|
|
114
|
+
*/
|
|
115
|
+
export interface ProviderRateBudgetDeclaration {
|
|
116
|
+
/** How many requests the window admits. */
|
|
117
|
+
readonly maxRequests: number;
|
|
118
|
+
/** The window's length, in seconds, as the vendor states it (Graph's global limit is per 10 s, Dataverse's per 300 s). */
|
|
119
|
+
readonly windowSeconds: number;
|
|
120
|
+
/** Whose allowance it is — see {@link ProviderRateBudgetPartition}. */
|
|
121
|
+
readonly partition: ProviderRateBudgetPartition;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* Where a budget was COUNTED, as the call that spent it observed (#1729): `shared` when the deployment's shared store
|
|
126
|
+
* (Redis) counted it for every process of the application — backend replicas, minions, workers — and `process` when
|
|
127
|
+
* only this process did, because no shared store is configured here or it did not answer. Recorded on the call's audit
|
|
128
|
+
* row, so a per-process count is visible rather than implied.
|
|
129
|
+
*/
|
|
130
|
+
export enum RateBudgetCounting {
|
|
131
|
+
SHARED = 'shared',
|
|
132
|
+
PROCESS = 'process',
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* The defects of a connection's rate-budget declarations: a non-positive number, and a contract-level list beside
|
|
137
|
+
* `oauth2.audiences` — which would apply to nothing, since every call of such a connection is on one audience. A pure
|
|
138
|
+
* function so the registry refuses it at boot and a test pins it without a host.
|
|
139
|
+
*/
|
|
140
|
+
export function describeProviderRateBudgetDefects(input: {
|
|
141
|
+
readonly contractRateBudgets?: readonly ProviderRateBudgetDeclaration[];
|
|
142
|
+
readonly audiences?: Readonly<Record<string, { readonly rateBudgets?: readonly ProviderRateBudgetDeclaration[] }>>;
|
|
143
|
+
}): string[] {
|
|
144
|
+
const defects: string[] = [];
|
|
145
|
+
const check = (where: string, declarations: readonly ProviderRateBudgetDeclaration[] | undefined): void => {
|
|
146
|
+
for (const [index, declaration] of (declarations ?? []).entries()) {
|
|
147
|
+
if (!Number.isInteger(declaration.maxRequests) || declaration.maxRequests < 1) {
|
|
148
|
+
defects.push(`${where}[${index}].maxRequests must be a positive integer (got ${String(declaration.maxRequests)})`);
|
|
149
|
+
}
|
|
150
|
+
if (!Number.isFinite(declaration.windowSeconds) || declaration.windowSeconds <= 0) {
|
|
151
|
+
defects.push(`${where}[${index}].windowSeconds must be positive (got ${String(declaration.windowSeconds)})`);
|
|
152
|
+
}
|
|
153
|
+
if (!Object.values(ProviderRateBudgetPartition).includes(declaration.partition)) {
|
|
154
|
+
defects.push(`${where}[${index}].partition '${String(declaration.partition)}' is not a ProviderRateBudgetPartition`);
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
};
|
|
158
|
+
check('rest.rateBudgets', input.contractRateBudgets);
|
|
159
|
+
for (const [id, audience] of Object.entries(input.audiences ?? {})) check(`oauth2.audiences.${id}.rateBudgets`, audience.rateBudgets);
|
|
160
|
+
if ((input.contractRateBudgets?.length ?? 0) > 0 && Object.keys(input.audiences ?? {}).length > 0) {
|
|
161
|
+
defects.push('rest.rateBudgets is declared beside oauth2.audiences and would apply to no call — declare each limit on the audience it meters');
|
|
162
|
+
}
|
|
163
|
+
return defects;
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* The declarations that apply to one call: the audience's own when the call's token is for an audience, else the
|
|
168
|
+
* contract's. Nothing is inherited between the two — see {@link describeProviderRateBudgetDefects}.
|
|
169
|
+
*/
|
|
170
|
+
export function selectProviderRateBudgetDeclarations(input: {
|
|
171
|
+
readonly contractRateBudgets?: readonly ProviderRateBudgetDeclaration[];
|
|
172
|
+
readonly audience?: { readonly rateBudgets?: readonly ProviderRateBudgetDeclaration[] };
|
|
173
|
+
}): readonly ProviderRateBudgetDeclaration[] {
|
|
174
|
+
return input.audience !== undefined ? input.audience.rateBudgets ?? [] : input.contractRateBudgets ?? [];
|
|
175
|
+
}
|
|
176
|
+
```
|
|
@@ -39,7 +39,15 @@ credential never reaches the browser.
|
|
|
39
39
|
const url = `${API_CALL_PREFIX}${routeTemplate
|
|
40
40
|
.replace(':providerRef', encodeURIComponent(providerRef))
|
|
41
41
|
.replace(':operationId', encodeURIComponent(operationId))}`;
|
|
42
|
-
|
|
42
|
+
try {
|
|
43
|
+
return await this.post<{ status: number; output: TOutput }>(url, body, options);
|
|
44
|
+
} catch (error) {
|
|
45
|
+
// A refusal for a missing scope carries a re-authorization offer (#1671). Recorded here, once, so the
|
|
46
|
+
// connected-accounts screen can offer "grant more access" on the connection it belongs to (#1727) whatever
|
|
47
|
+
// feature made the call — then rethrown unchanged: the caller still decides what to show where it asked.
|
|
48
|
+
recordScopeRefusalOffer(error, body.connection);
|
|
49
|
+
throw error;
|
|
50
|
+
}
|
|
43
51
|
}
|
|
44
52
|
|
|
45
53
|
/**
|
|
@@ -66,6 +74,13 @@ credential never reaches the browser.
|
|
|
66
74
|
.replace(':providerRef', encodeURIComponent(providerRef))
|
|
67
75
|
.replace(':operationId', encodeURIComponent(operationId))
|
|
68
76
|
.replace(':inputField', encodeURIComponent(inputField))}`;
|
|
69
|
-
|
|
77
|
+
try {
|
|
78
|
+
return await this.post<{ optionsOperationId: string; options: Array<{ value: string; label: string }> }>(url, body, options);
|
|
79
|
+
} catch (error) {
|
|
80
|
+
// The options operation runs through the same connection and the same door, so it is refused for a missing
|
|
81
|
+
// scope the same way — and its offer reaches the connected-accounts screen the same way (#1727).
|
|
82
|
+
recordScopeRefusalOffer(error, body.connection);
|
|
83
|
+
throw error;
|
|
84
|
+
}
|
|
70
85
|
}
|
|
71
86
|
```
|
|
@@ -6,6 +6,21 @@ Read this when a backend service needs to call a connected provider, or to under
|
|
|
6
6
|
- `forExecution(executionContext)` is what a generated typed client takes: the call is authorized
|
|
7
7
|
against, and audited as, the person or machine that context belongs to.
|
|
8
8
|
- `execute(...)` is the untyped door the typed client wraps; reach for it only when no client exists.
|
|
9
|
+
- Every call writes one `PROVIDER_OPERATION_CALL` audit row. When the operation was contributed by an
|
|
10
|
+
opted-in AUGMENTATION package rather than the provider's own module, the row also carries
|
|
11
|
+
`augmentationPackage` and `augmentationPackageVersion` — see `provider-backend-package`'s
|
|
12
|
+
`references/framework-provider-augmentation-api.md`.
|
|
13
|
+
- A call whose compiled URL would reach a different origin (scheme, host, port) than the provider's
|
|
14
|
+
resolved base URL is refused before anything leaves the process, with
|
|
15
|
+
`URL_LEAVES_BASE_ORIGIN`, and the refusal is recorded in the audit trail. The browser door answers it
|
|
16
|
+
as `409 NOT_EXECUTABLE`: it is an operator's declaration problem, never the caller's input.
|
|
17
|
+
- The row also names the GRANT the call spent — `connectionRef`, which differs from `providerRef` when the ref
|
|
18
|
+
is a member of a `providers.sharedConnections` entry — and `providerPackageName`, whose code the ref is.
|
|
19
|
+
- When the connection's grant spans several resources (Microsoft Graph and a Dataverse environment), each call
|
|
20
|
+
carries only the token of the resource its host belongs to, recorded as `tokenAudience`. A host outside every
|
|
21
|
+
audience is refused with `TOKEN_AUDIENCE_HOST_MISMATCH` — at resolution, and again on the compiled request —
|
|
22
|
+
and recorded; the browser door answers the compiled-request refusal as `409 NOT_EXECUTABLE` too. See
|
|
23
|
+
`provider-backend-package`'s `references/framework-provider-shared-connection-api.md`.
|
|
9
24
|
|
|
10
25
|
## Import Origins
|
|
11
26
|
|