@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
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# saas.backend.flows-actors.autonomous-agent-declaration
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* An agent the application lets run with NOBODY on a socket (#1611): on a schedule
|
|
14
|
+
* (`createAutonomousAgentScheduleBatch`) or when an inbound handler hands it a delivery
|
|
15
|
+
* (`ctx.agents.startAutonomousTurn`).
|
|
16
|
+
*
|
|
17
|
+
* Declare it on a backend module's `flowsActors.autonomousAgents`; give it a `schedule` to run it on a cron.
|
|
18
|
+
* Declaring it grants nothing: a turn
|
|
19
|
+
* runs in an organization only while an administrator of that organization has BOUND one of its OAuth
|
|
20
|
+
* clients to the ref (`setAutonomousAgents` on the client) — or while the organization admits, on a
|
|
21
|
+
* service-provider relationship, a firm's client bound to it. The turn's tools then act under that
|
|
22
|
+
* client's CURRENT roles, re-read every time a turn starts and again before a reviewer's decision resumes
|
|
23
|
+
* one. There is no application-wide autonomous agent.
|
|
24
|
+
*
|
|
25
|
+
* A gated tool the agent calls pauses only when its gate routes to a REVIEWER (`humanApproval` with a
|
|
26
|
+
* ROLE or ASSIGNEE route); an OWNER-gated call is denied, because a machine turn has no owner to ask.
|
|
27
|
+
*
|
|
28
|
+
* Import path: `@wildo-ai/saas-backend-lib`.
|
|
29
|
+
*
|
|
30
|
+
* @example
|
|
31
|
+
* flowsActors: {
|
|
32
|
+
* autonomousAgents: [{
|
|
33
|
+
* ref: 'todos.overdue-triage',
|
|
34
|
+
* systemRef: 'todo-assistant',
|
|
35
|
+
* instruction: 'Review the overdue todos of this organization and propose a new due date for each.',
|
|
36
|
+
* concurrency: AutonomousAgentConcurrency.SKIP_IF_ACTIVE,
|
|
37
|
+
* }],
|
|
38
|
+
* }
|
|
39
|
+
*/
|
|
40
|
+
export interface FlowsActors_AutonomousAgentDeclaration {
|
|
41
|
+
/**
|
|
42
|
+
* Stable id, lower-case, dotted or hyphenated (`todos.overdue-triage`). What an administrator binds a
|
|
43
|
+
* client to, what a schedule and an inbound handler name, and what every audit row records.
|
|
44
|
+
*/
|
|
45
|
+
ref: string;
|
|
46
|
+
/** The ACTOR system the turn converses with; its chat actor's agent runs, with that agent's tools. */
|
|
47
|
+
systemRef: string;
|
|
48
|
+
/**
|
|
49
|
+
* What the agent is asked to do on every turn. Declared HERE and never taken from the trigger: a
|
|
50
|
+
* schedule has nothing to say, and an inbound delivery's content is data the instruction refers to,
|
|
51
|
+
* never an instruction itself.
|
|
52
|
+
*/
|
|
53
|
+
instruction: string;
|
|
54
|
+
/** Whether an occurrence may start while an earlier turn in the same organization is still active or awaiting a reviewer. */
|
|
55
|
+
concurrency: AutonomousAgentConcurrency;
|
|
56
|
+
/**
|
|
57
|
+
* Run the agent on a schedule: each tick starts one turn in every organization where it may run. The
|
|
58
|
+
* engine registers the batch itself (`autonomous-agent.<ref>`), so the declaration is the one place the
|
|
59
|
+
* schedule lives. Omit it for an agent only inbound handlers start.
|
|
60
|
+
*/
|
|
61
|
+
schedule?: {
|
|
62
|
+
/** A cron expression (`'0 8 * * *'` = every day at 08:00). */
|
|
63
|
+
cronJobExpression: string;
|
|
64
|
+
};
|
|
65
|
+
}
|
|
66
|
+
```
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# saas.backend.flows-actors.autonomous-agent-schedule
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The batch behind a declared autonomous agent's schedule (#1611). You do not call this: give the agent's
|
|
14
|
+
* declaration a `schedule: { cronJobExpression }` and the engine registers this batch for it at startup,
|
|
15
|
+
* under {@link autonomousAgentScheduleBatchRef}. Registering it yourself as well is refused at startup — the
|
|
16
|
+
* same batch ref twice — so the declaration stays the one place an agent's schedule lives.
|
|
17
|
+
*
|
|
18
|
+
* Each tick starts ONE turn in each organization where the agent may run — an organization with one of its
|
|
19
|
+
* own clients bound to the ref, or admitting a firm's client bound to it — and each turn is keyed by the
|
|
20
|
+
* scheduled occurrence, so a tick re-run after a crash starts nothing twice. An organization whose binding
|
|
21
|
+
* no longer holds, whose budget is spent, or whose previous turn is still active (`SKIP_IF_ACTIVE`) is
|
|
22
|
+
* refused and recorded, never retried in a loop. Import path: `@wildo-ai/saas-backend-lib`.
|
|
23
|
+
*/
|
|
24
|
+
export function createAutonomousAgentScheduleBatch(
|
|
25
|
+
autonomousAgentRef: string,
|
|
26
|
+
options: {
|
|
27
|
+
/** When the agent runs, as a cron expression (`'0 8 * * *'` = every day at 08:00). */
|
|
28
|
+
readonly cronJobExpression: string;
|
|
29
|
+
},
|
|
30
|
+
): ReturnType<typeof createCustomBatchExecutionService> {
|
|
31
|
+
```
|
|
@@ -29,8 +29,48 @@ export interface FunctionToolExecutionContext {
|
|
|
29
29
|
* can list what it started; the engine supplies it and reads nothing back from it.
|
|
30
30
|
*/
|
|
31
31
|
executionId?: string;
|
|
32
|
+
/**
|
|
33
|
+
* The actors system the execution runs in, when the tool runs inside one. Supplied by the engine;
|
|
34
|
+
* like `executionId`, it is recorded on the agent frame the call runs in, so every audit row the tool
|
|
35
|
+
* causes names the agent, the execution and the system without the tool doing anything.
|
|
36
|
+
*/
|
|
37
|
+
systemRef?: string;
|
|
32
38
|
/** Backend services the tool may use. */
|
|
33
39
|
services: FunctionToolExecutionServices;
|
|
40
|
+
/**
|
|
41
|
+
* The human decision this call runs under, when a resumed turn is carrying out an approval (#1594).
|
|
42
|
+
* The agent frame copies it onto `agentActor.decisionRef`, so the write the approved tool makes names
|
|
43
|
+
* the decision that authorized it. Absent on every call no one had to approve.
|
|
44
|
+
*/
|
|
45
|
+
decisionRef?: string;
|
|
46
|
+
/**
|
|
47
|
+
* Which door opened the turn this call belongs to (#1594), read by the engine from the execution ROW —
|
|
48
|
+
* at turn start and again at a decision's resume — never from the caller. It decides whether a gated call
|
|
49
|
+
* may pause for a person or must be denied (`admitsDecisionSuspension`). Tools do not need to read it.
|
|
50
|
+
*/
|
|
51
|
+
initiationKind?: FlowsActors_InitiationKind | null;
|
|
52
|
+
/**
|
|
53
|
+
* AUTONOMOUS turns only (#1611): what started the turn, read from the row. An `INBOUND_DELIVERY` turn
|
|
54
|
+
* runs on content from outside, so the engine offers it only tools that READ or that are gated on a
|
|
55
|
+
* reviewer — see {@link FunctionTool.effect}.
|
|
56
|
+
*/
|
|
57
|
+
autonomousTrigger?: AutonomousTurnTrigger;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* What a tool can do to the world, as its author DECLARES it (#1611). Read by the engine to decide which
|
|
62
|
+
* tools an agent is offered when the turn's input is untrusted — an autonomous turn started by an inbound
|
|
63
|
+
* delivery, whose content came from outside and must never steer a write nobody reviews.
|
|
64
|
+
*/
|
|
65
|
+
export enum FunctionToolEffect {
|
|
66
|
+
/** The tool only reads. Offered to every turn. */
|
|
67
|
+
READ = 'read',
|
|
68
|
+
/**
|
|
69
|
+
* The tool may change something — a record, a message sent, money moved. The meaning of an ABSENT
|
|
70
|
+
* declaration too: an unclassified tool is treated as a write, so forgetting to declare it withholds the
|
|
71
|
+
* tool from untrusted turns rather than exposing it.
|
|
72
|
+
*/
|
|
73
|
+
WRITE = 'write',
|
|
34
74
|
}
|
|
35
75
|
|
|
36
76
|
/**
|
|
@@ -82,7 +122,167 @@ export interface FunctionTool {
|
|
|
82
122
|
* 2. **This is Wildo's declaration, not the model SDK's.** The engine translates it into the
|
|
83
123
|
* SDK's call-level approval configuration. Do not reach for the SDK's own tool-level
|
|
84
124
|
* `needsApproval`: it is deprecated, and approval is handled at the call level now.
|
|
125
|
+
*
|
|
126
|
+
* `true` means the person whose turn it is answers (an OWNER route). To route the decision to a
|
|
127
|
+
* reviewer instead, declare {@link FunctionTool.humanApproval}; when both are set, `humanApproval` wins.
|
|
85
128
|
*/
|
|
86
129
|
requiresHumanApproval?: boolean;
|
|
130
|
+
/**
|
|
131
|
+
* WHO must approve this tool call before it runs (#1594). Declaring it gates the tool exactly as
|
|
132
|
+
* `requiresHumanApproval` does, and routes the decision:
|
|
133
|
+
*
|
|
134
|
+
* - `OWNER` — the person whose turn it is (what `requiresHumanApproval: true` means);
|
|
135
|
+
* - `ROLE` — anyone holding `eligibleRole` in the organization the work belongs to, EXCEPT the person
|
|
136
|
+
* whose turn raised it. Any holder may claim it for themselves;
|
|
137
|
+
* - `ASSIGNEE` — the one person `assignee` resolves, who must hold `eligibleRole`.
|
|
138
|
+
*
|
|
139
|
+
* Whoever answers only decides WHETHER the call runs. It always runs under the authority of the
|
|
140
|
+
* person (or machine) whose turn raised it, re-checked when the answer arrives — a reviewer's
|
|
141
|
+
* wider rights never reach the agent.
|
|
142
|
+
*
|
|
143
|
+
* A malformed declaration (a ROLE route with no role, an ASSIGNEE route with no resolver) stops the
|
|
144
|
+
* application at startup: a gate nobody can answer is refused before it can strand a turn.
|
|
145
|
+
*/
|
|
146
|
+
humanApproval?: FunctionTool_HumanApprovalGate;
|
|
147
|
+
/**
|
|
148
|
+
* What this tool can do, as you declare it (#1611). `READ` tools are offered to every turn, including an
|
|
149
|
+
* autonomous turn started by an inbound delivery. Anything else — `WRITE`, or no declaration at all — is
|
|
150
|
+
* offered to such a turn only when it is gated on a REVIEWER (`humanApproval` with a ROLE or ASSIGNEE
|
|
151
|
+
* route), because the delivery's content came from outside and must not steer a write nobody reviews.
|
|
152
|
+
* `resourceReadTool` declares `READ` and `resourceWriteTool` declares `WRITE` for you; declare it on a
|
|
153
|
+
* tool you write by hand.
|
|
154
|
+
*/
|
|
155
|
+
effect?: FunctionToolEffect;
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* How an approval-gated tool routes its decision. See {@link FunctionTool.humanApproval}.
|
|
160
|
+
*/
|
|
161
|
+
export interface FunctionTool_HumanApprovalGate {
|
|
162
|
+
route: HumanDecision_RouteKind;
|
|
163
|
+
/**
|
|
164
|
+
* ROLE and ASSIGNEE: the role every answerer must hold. For ROLE it is the role the decision is
|
|
165
|
+
* routed to. It is also the floor for anyone the decision is later reassigned, escalated or claimed
|
|
166
|
+
* to: a move can never hand it to someone this gate would not have admitted.
|
|
167
|
+
*/
|
|
168
|
+
eligibleRole?: string;
|
|
169
|
+
/**
|
|
170
|
+
* ASSIGNEE only: resolves the ONE person to route to, when the call pauses, from its arguments and
|
|
171
|
+
* context (for example, the record's account manager). Returning `undefined`, or a person without
|
|
172
|
+
* `eligibleRole`, refuses the pause and the call is denied — a decision nobody may answer is never
|
|
173
|
+
* created.
|
|
174
|
+
*/
|
|
175
|
+
assignee?: (args: unknown, context: FunctionToolExecutionContext) => Promise<string | undefined>;
|
|
176
|
+
/**
|
|
177
|
+
* Where ESCALATE moves the decision when the person escalating names nobody. Resolves one person,
|
|
178
|
+
* who is vetted against `eligibleRole` like any other target. Without it, an escalation must name
|
|
179
|
+
* its target; there is no default escalation to administrators.
|
|
180
|
+
*/
|
|
181
|
+
escalateTo?: (args: unknown, context: FunctionToolExecutionContext) => Promise<string | undefined>;
|
|
182
|
+
/**
|
|
183
|
+
* When the decision should be taken, answered, and given up on (#1628). Optional: a gate declaring
|
|
184
|
+
* nothing still gets a 24-hour lapse and two reminders — at half of it nobody has taken the decision,
|
|
185
|
+
* at three quarters nobody has answered — sent to the people who may answer it.
|
|
186
|
+
*
|
|
187
|
+
* A deadline changes who is ASKED and who is TOLD, never what is decided. Missing one never approves
|
|
188
|
+
* and never rejects; only the lapse ends the decision, as LAPSED, which is never counted as a refusal.
|
|
189
|
+
*
|
|
190
|
+
* ```ts
|
|
191
|
+
* deadlines: {
|
|
192
|
+
* lapseAfter: 'PT48H', // ISO-8601; always elapsed time
|
|
193
|
+
* claim: { at: 'PT4H', basis: ReviewClockBasis.CALENDAR }, // counted in the application's reviewCalendar
|
|
194
|
+
* decision: { at: { fractionOfLapse: 0.75 }, warnBefore: 'PT2H' },
|
|
195
|
+
* rules: [
|
|
196
|
+
* { stage: ReviewDeadlineStage.DECISION_WARNING, action: ReviewEscalationActionKind.NOTIFY },
|
|
197
|
+
* { stage: ReviewDeadlineStage.DECISION_MISSED, action: ReviewEscalationActionKind.REASSIGN, target: resolveTeamLead },
|
|
198
|
+
* ],
|
|
199
|
+
* pauseStates: ['awaiting-requester-information'],
|
|
200
|
+
* }
|
|
201
|
+
* ```
|
|
202
|
+
*
|
|
203
|
+
* A declaration that could never do what it says stops the application at startup: a CALENDAR clock in
|
|
204
|
+
* an application with no `reviewCalendar`, a target at or after the lapse, a REASSIGN rule with no
|
|
205
|
+
* target or on an OWNER gate.
|
|
206
|
+
*/
|
|
207
|
+
deadlines?: FunctionTool_HumanApprovalDeadlines;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/**
|
|
211
|
+
* A gate's deadline declaration: the data {@link ReviewDeadlinesDeclaration} with a REASSIGN rule's
|
|
212
|
+
* target resolver beside it. See {@link FunctionTool_HumanApprovalGate.deadlines}.
|
|
213
|
+
*/
|
|
214
|
+
export interface FunctionTool_HumanApprovalDeadlines extends Omit<ReviewDeadlinesDeclaration, 'rules'> {
|
|
215
|
+
rules?: FunctionTool_ReviewEscalationRule[];
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
/** What one deadline stage does. Declared rules replace the default reminders. */
|
|
219
|
+
export interface FunctionTool_ReviewEscalationRule {
|
|
220
|
+
stage: ReviewDeadlineStage;
|
|
221
|
+
action: ReviewEscalationActionKind;
|
|
222
|
+
/**
|
|
223
|
+
* REASSIGN only, and required there: resolves the one person the decision moves to, from the call's
|
|
224
|
+
* arguments, under the REQUESTER's authority as it stands when the stage fires. That person must be able
|
|
225
|
+
* to answer it (hold the gate's `eligibleRole`, and not be the requester); if not, or if nobody resolves,
|
|
226
|
+
* the rule notifies instead and the refusal is recorded. When several REASSIGN rules fire at one stage,
|
|
227
|
+
* the first declared wins.
|
|
228
|
+
*/
|
|
229
|
+
target?: (args: unknown, context: FunctionToolExecutionContext) => Promise<string | undefined>;
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
/**
|
|
233
|
+
* Whether a tool may be OFFERED to a turn, given where the turn's input came from (#1611). The one place
|
|
234
|
+
* this is decided; the agents service asks it for every declared tool.
|
|
235
|
+
*
|
|
236
|
+
* Every tool is offered to an ordinary turn. An autonomous turn started by an inbound delivery is offered
|
|
237
|
+
* only a tool that READS, or one gated on a REVIEWER — so a write that content from outside asks for is
|
|
238
|
+
* either impossible or seen by a person first. An OWNER-gated tool is not offered there either: a machine
|
|
239
|
+
* turn has no owner to ask, so the call could only ever be denied.
|
|
240
|
+
*/
|
|
241
|
+
export function isFunctionToolOfferedToTurn(
|
|
242
|
+
tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'effect'>,
|
|
243
|
+
autonomousTrigger: AutonomousTurnTrigger | undefined,
|
|
244
|
+
): boolean {
|
|
245
|
+
if (autonomousTrigger !== AutonomousTurnTrigger.INBOUND_DELIVERY) return true;
|
|
246
|
+
if (tool.effect === FunctionToolEffect.READ) return true;
|
|
247
|
+
const route = resolveFunctionToolApprovalGate(tool)?.route;
|
|
248
|
+
return route === HumanDecision_RouteKind.ROLE || route === HumanDecision_RouteKind.ASSIGNEE;
|
|
249
|
+
}
|
|
250
|
+
|
|
251
|
+
/** Refused because a tool's approval gate cannot be answered as declared. */
|
|
252
|
+
export class FunctionToolApprovalGateError extends Error {}
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* The approval gate a tool actually has, or `undefined` for an ungated tool. The ONE reader of the two
|
|
256
|
+
* declarations, so no caller re-derives which one wins.
|
|
257
|
+
*
|
|
258
|
+
* Throws {@link FunctionToolApprovalGateError} for a declaration nobody could answer. The registry
|
|
259
|
+
* calls it at registration, so that surfaces at startup rather than on the first gated call.
|
|
260
|
+
*/
|
|
261
|
+
export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval'>): FunctionTool_HumanApprovalGate | undefined {
|
|
262
|
+
const gate = tool.humanApproval ?? (tool.requiresHumanApproval ? { route: HumanDecision_RouteKind.OWNER } : undefined);
|
|
263
|
+
if (!gate) return undefined;
|
|
264
|
+
const refuse = (why: string): never => {
|
|
265
|
+
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" declares an approval gate nobody can answer: ${why}`);
|
|
266
|
+
};
|
|
267
|
+
refuseUnsoundDeadlines(tool.functionRef, gate);
|
|
268
|
+
switch (gate.route) {
|
|
269
|
+
case HumanDecision_RouteKind.OWNER:
|
|
270
|
+
if (gate.eligibleRole || gate.assignee || gate.escalateTo) {
|
|
271
|
+
refuse('an OWNER route is answered by the person whose turn it is, so it takes no role, assignee or escalation target.');
|
|
272
|
+
}
|
|
273
|
+
return gate;
|
|
274
|
+
case HumanDecision_RouteKind.ROLE:
|
|
275
|
+
if (!gate.eligibleRole) refuse('a ROLE route must name `eligibleRole`, the role it is routed to.');
|
|
276
|
+
if (gate.assignee) refuse('a ROLE route is answered by any holder of its role; `assignee` belongs to an ASSIGNEE route.');
|
|
277
|
+
return gate;
|
|
278
|
+
case HumanDecision_RouteKind.ASSIGNEE:
|
|
279
|
+
if (!gate.eligibleRole) refuse('an ASSIGNEE route must name `eligibleRole`, the floor its assignee must meet.');
|
|
280
|
+
if (!gate.assignee) refuse('an ASSIGNEE route must declare `assignee`, the resolver of the one person it is routed to.');
|
|
281
|
+
return gate;
|
|
282
|
+
default: {
|
|
283
|
+
const unmapped: never = gate.route;
|
|
284
|
+
return refuse(`unknown route "${String(unmapped)}".`);
|
|
285
|
+
}
|
|
286
|
+
}
|
|
87
287
|
}
|
|
88
288
|
```
|
|
@@ -75,6 +75,8 @@ export function resourceWriteTool(
|
|
|
75
75
|
* approve things reflexively, which is how an approval prompt stops being read.
|
|
76
76
|
*/
|
|
77
77
|
requiresHumanApproval?: boolean;
|
|
78
|
+
/** Route this write's approval to a reviewer (see {@link FunctionTool.humanApproval}). */
|
|
79
|
+
humanApproval?: FunctionTool_HumanApprovalGate;
|
|
78
80
|
},
|
|
79
81
|
): FunctionTool {
|
|
80
82
|
```
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# saas.backend.pdf-template.collection-definition
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Input to a collection-export PDF template: the rows a listing's export returned (#1645).
|
|
14
|
+
*
|
|
15
|
+
* The rows are exactly what the source LIST/SEARCH operation answered for this caller — same tenant
|
|
16
|
+
* scope, roles, contextual filters and field stripping — because the export re-runs that operation.
|
|
17
|
+
* A template therefore cannot show more than the caller could read in the listing itself.
|
|
18
|
+
*/
|
|
19
|
+
export interface PdfCollectionBuildContextInput<TRow = Record<string, unknown>> {
|
|
20
|
+
/** The exported rows, in the listing's order. */
|
|
21
|
+
rows: readonly TRow[];
|
|
22
|
+
/** The resource the listing belongs to. */
|
|
23
|
+
resourceType: ResourceType;
|
|
24
|
+
/** Execution context of the SOURCE listing: auth, scope and audit attribution. */
|
|
25
|
+
executionContext: ExecutionContext<any>;
|
|
26
|
+
/** Locale chosen for this render. */
|
|
27
|
+
locale: string;
|
|
28
|
+
/** When the export was requested — print it rather than reading the clock inside `body`. */
|
|
29
|
+
generatedAt: Date;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Backend-only PDF template that renders a WHOLE collection export into one document (#1645).
|
|
34
|
+
*
|
|
35
|
+
* ## Why this is not `PdfTemplateDefinition`
|
|
36
|
+
*
|
|
37
|
+
* A `PdfTemplateDefinition` renders ONE record into a stored file field: its input is the record being
|
|
38
|
+
* created or regenerated. A collection template renders the rows of a listing into a document the
|
|
39
|
+
* caller downloads and nothing stores. Different input, different lifecycle, so a different type; the
|
|
40
|
+
* two share only the renderer.
|
|
41
|
+
*
|
|
42
|
+
* Declared on a LIST/SEARCH operation by `collectionExport: { formats: [PDF], pdfTemplateId }`, and
|
|
43
|
+
* bound at startup through the backend module's `pdfCollectionExportTemplates` slot. The backend
|
|
44
|
+
* refuses to boot when an export names a template nothing provides.
|
|
45
|
+
*
|
|
46
|
+
* @example
|
|
47
|
+
* export const invoicesDigestTemplate = definePdfCollectionTemplate<InvoiceRow, { rows: InvoiceRow[] }>({
|
|
48
|
+
* id: 'my-app.invoices.digest.v1',
|
|
49
|
+
* buildContext: async ({ rows }) => ({ rows: [...rows] }),
|
|
50
|
+
* body: ({ context }) => createElement(Document, null, ...),
|
|
51
|
+
* });
|
|
52
|
+
*/
|
|
53
|
+
export interface PdfCollectionTemplateDefinition<TRow = Record<string, unknown>, TContext = unknown> {
|
|
54
|
+
/** Stable id, named by `collectionExport.pdfTemplateId`. */
|
|
55
|
+
id: string;
|
|
56
|
+
/**
|
|
57
|
+
* Optional locale-keyed label maps, resolved exact-locale, then base language, then the first
|
|
58
|
+
* declared locale, and handed to `body()` as one flat map.
|
|
59
|
+
*/
|
|
60
|
+
labels?: Record<string, Record<string, string>>;
|
|
61
|
+
/** Build the render context. The only hook intended to perform I/O. */
|
|
62
|
+
buildContext(input: PdfCollectionBuildContextInput<TRow>): Promise<TContext>;
|
|
63
|
+
/** Build the React-PDF document from the context. No I/O here. */
|
|
64
|
+
body(props: { context: TContext; locale: string; labels: Record<string, string> }): ReactElement;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
/** Authoring helper: keeps the row and context types at the call site; performs no registration. */
|
|
68
|
+
export function definePdfCollectionTemplate<TRow, TContext>(
|
|
69
|
+
template: PdfCollectionTemplateDefinition<TRow, TContext>,
|
|
70
|
+
): PdfCollectionTemplateDefinition<TRow, TContext> {
|
|
71
|
+
return template;
|
|
72
|
+
}
|
|
73
|
+
```
|
package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md
CHANGED
|
@@ -66,6 +66,13 @@
|
|
|
66
66
|
providerRef: string,
|
|
67
67
|
protocolKind: ExternalProvider_ExchangeProtocol_Kind,
|
|
68
68
|
secretRef: string,
|
|
69
|
+
/**
|
|
70
|
+
* A resource AUDIENCE other than the grant's primary (#1725): the token is minted from the stored grant's
|
|
71
|
+
* refresh token for these scopes (or read from the audience cache), never the stored primary token. Absent:
|
|
72
|
+
* the stored credential, as always. Meaningless for an APPLICATION target, which holds no grant to mint from,
|
|
73
|
+
* and refused there.
|
|
74
|
+
*/
|
|
75
|
+
options?: { readonly audience?: ProviderOAuth2RefreshAudience },
|
|
69
76
|
): Promise<{
|
|
70
77
|
value: string;
|
|
71
78
|
source: ProviderCredentialResolutionSource;
|
|
@@ -109,7 +116,9 @@
|
|
|
109
116
|
+ 'This is a wiring fault rather than a missing credential.',
|
|
110
117
|
);
|
|
111
118
|
}
|
|
112
|
-
|
|
119
|
+
// The row's ADDRESS: the connection the ref belongs to (#1670) and the contract KEY of the slot,
|
|
120
|
+
// never the env-var spelling a rename can move (#624). One answer for every read path.
|
|
121
|
+
const { connectionRef: userConnectionRef, secretSlug: userSecretSlug } = this.resolveCredentialAddress(providerRef, secretRef);
|
|
113
122
|
// A name the provider no longer declares is never sent to the store: its row would still open,
|
|
114
123
|
// because the seal binds the name it was stored under, and spend a credential this subsystem
|
|
115
124
|
// reports as unusable (#624). The miss path below then names that row as retired.
|
|
@@ -117,16 +126,19 @@
|
|
|
117
126
|
const ownedByUser = userSlotRetired ? undefined : await userResolver.resolveUserCredential({
|
|
118
127
|
userId: target.ownerId!,
|
|
119
128
|
providerRef,
|
|
120
|
-
|
|
121
|
-
// See `canonicalCredentialSlug` (#624).
|
|
129
|
+
connectionRef: userConnectionRef,
|
|
122
130
|
secretSlug: userSecretSlug,
|
|
131
|
+
...(options?.audience === undefined ? {} : { audience: options.audience }),
|
|
123
132
|
});
|
|
124
133
|
if (!ownedByUser) {
|
|
125
134
|
const retiredSlots = await this.findRetiredSlotsBehindMiss(providerRef, userSlotRetired ? undefined : userSecretSlug, ExternalProvider_Connection_OwnerScope.USER, () =>
|
|
126
|
-
userResolver.listStoredSecretSlugs({ userId: target.ownerId!, providerRef }));
|
|
135
|
+
userResolver.listStoredSecretSlugs({ userId: target.ownerId!, providerRef, connectionRef: userConnectionRef }));
|
|
136
|
+
const storedBeforeJoining = await this.describeRowStoredBeforeJoining(providerRef, userConnectionRef, () =>
|
|
137
|
+
userResolver.listStoredSecretSlugs({ userId: target.ownerId!, providerRef, connectionRef: providerRef }));
|
|
127
138
|
throw this.buildConnectionRefusal(
|
|
128
139
|
providerRef,
|
|
129
|
-
|
|
140
|
+
storedBeforeJoining
|
|
141
|
+
+ (retiredSlots.length === 0
|
|
130
142
|
? `user '${target.ownerId}' has not connected '${secretRef}'. `
|
|
131
143
|
: `user '${target.ownerId}' has no credential for '${secretRef}' under the provider's current secrets contract. `
|
|
132
144
|
+ `${describeCredentialsStoredUnderRetiredSlots(retiredSlots)} `)
|
|
@@ -144,6 +156,13 @@
|
|
|
144
156
|
}
|
|
145
157
|
|
|
146
158
|
if (target.ownerScope === ExternalProvider_Connection_OwnerScope.APPLICATION) {
|
|
159
|
+
if (options?.audience !== undefined) {
|
|
160
|
+
throw this.buildConnectionRefusal(
|
|
161
|
+
providerRef,
|
|
162
|
+
`the application's own credential cannot serve the '${options.audience.id}' audience: a token for another resource `
|
|
163
|
+
+ 'is minted from a connected account\'s refresh token, and the deployment\'s credential is a pasted token with none.',
|
|
164
|
+
);
|
|
165
|
+
}
|
|
147
166
|
const fromEnvironment = this.getProviderSecret(providerRef, protocolKind, secretRef);
|
|
148
167
|
if (fromEnvironment) {
|
|
149
168
|
return { value: fromEnvironment, source: ProviderCredentialResolutionSource.DEPLOYMENT_ENVIRONMENT };
|
|
@@ -166,21 +185,26 @@
|
|
|
166
185
|
+ 'This is a wiring fault rather than a missing credential.',
|
|
167
186
|
);
|
|
168
187
|
}
|
|
169
|
-
|
|
188
|
+
// The row's ADDRESS — connection and contract KEY — see the USER branch above (#1670, #624).
|
|
189
|
+
const { connectionRef: organizationConnectionRef, secretSlug: organizationSecretSlug } = this.resolveCredentialAddress(providerRef, secretRef);
|
|
170
190
|
// Never sends a RETIRED name to the store — see the USER branch above (#624).
|
|
171
191
|
const organizationSlotRetired = this.classifyStoredCredentialSlot(providerRef, organizationSecretSlug) === StoredCredentialSlotStanding.RETIRED;
|
|
172
192
|
const owned = organizationSlotRetired ? undefined : await resolver.resolveOrganizationCredential({
|
|
173
193
|
organizationId: target.ownerId!,
|
|
174
194
|
providerRef,
|
|
175
|
-
|
|
195
|
+
connectionRef: organizationConnectionRef,
|
|
176
196
|
secretSlug: organizationSecretSlug,
|
|
197
|
+
...(options?.audience === undefined ? {} : { audience: options.audience }),
|
|
177
198
|
});
|
|
178
199
|
if (!owned) {
|
|
179
200
|
const retiredSlots = await this.findRetiredSlotsBehindMiss(providerRef, organizationSlotRetired ? undefined : organizationSecretSlug, ExternalProvider_Connection_OwnerScope.ORGANIZATION, () =>
|
|
180
|
-
resolver.listStoredSecretSlugs({ organizationId: target.ownerId!, providerRef }));
|
|
201
|
+
resolver.listStoredSecretSlugs({ organizationId: target.ownerId!, providerRef, connectionRef: organizationConnectionRef }));
|
|
202
|
+
const storedBeforeJoining = await this.describeRowStoredBeforeJoining(providerRef, organizationConnectionRef, () =>
|
|
203
|
+
resolver.listStoredSecretSlugs({ organizationId: target.ownerId!, providerRef, connectionRef: providerRef }));
|
|
181
204
|
throw this.buildConnectionRefusal(
|
|
182
205
|
providerRef,
|
|
183
|
-
|
|
206
|
+
storedBeforeJoining
|
|
207
|
+
+ (retiredSlots.length === 0
|
|
184
208
|
? `organization '${target.ownerId}' has no credential for '${secretRef}'. `
|
|
185
209
|
: `organization '${target.ownerId}' has no credential for '${secretRef}' under the provider's current secrets contract. `
|
|
186
210
|
+ `${describeCredentialsStoredUnderRetiredSlots(retiredSlots)} `)
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
# saas.backend.submission-challenge
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* The check a PUBLIC submission answers before the backend accepts it (#1735, #1985).
|
|
14
|
+
*
|
|
15
|
+
* You do not call it. Declare `submissionChallenge: { action }` on the operation variant, and the framework asks it in
|
|
16
|
+
* the operation pipeline, before any hook of yours runs:
|
|
17
|
+
*
|
|
18
|
+
* - Required only when this backend declares a captcha provider (a module shipping a captcha verifier, such as
|
|
19
|
+
* `recaptcha`'s backend part), and only of a caller who proved no identity (see
|
|
20
|
+
* {@link SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE}). With no captcha provider declared, nobody is asked.
|
|
21
|
+
* - Otherwise it refuses with `400` and `SUBMISSION_CHALLENGE_REQUIRED` (no answer) or `SUBMISSION_CHALLENGE_REFUSED`
|
|
22
|
+
* (an answer it did not accept), unless the `x-submission-challenge-response` header carries EITHER a token the
|
|
23
|
+
* declared vendor accepts for the declared `action`, OR an unused, unexpired solution to a proof-of-work challenge from
|
|
24
|
+
* `GET /submission-challenges/proof-of-work`.
|
|
25
|
+
* - The proof of work is the consent-exempt answer: a visitor who declined the vendor's consent still submits.
|
|
26
|
+
* - The answer belongs to the operation the request addressed. A nested operation never receives it, so an unauthenticated
|
|
27
|
+
* request whose implementation calls a protected operation is refused there: nothing can answer for it.
|
|
28
|
+
*
|
|
29
|
+
* @example the framework's own contact form declares it on its public CREATE variant
|
|
30
|
+
* {
|
|
31
|
+
* variantType: ResourceOperationVariantType.API_CALL,
|
|
32
|
+
* isDefault: true,
|
|
33
|
+
* roles: [CORE_APP_ROLES.APP_ANONYMOUS],
|
|
34
|
+
* riskLevel: ResourceOperationRiskLevel.LOW,
|
|
35
|
+
* rateLimit: { requestsPerMinute: 5, requestsPerHour: 30 },
|
|
36
|
+
* submissionChallenge: { action: SubmissionChallengeAction.INBOUND_CONTACT },
|
|
37
|
+
* }
|
|
38
|
+
*/
|
|
39
|
+
export interface SubmissionChallengeVerifier {
|
|
40
|
+
/** Whether public submissions must answer a challenge: this backend declares a captcha provider. */
|
|
41
|
+
isChallengeRequired(): boolean;
|
|
42
|
+
/** Refuse (throw) unless the encoded answer is accepted for `action`; resolves when no challenge is required. */
|
|
43
|
+
assertSubmissionChallengeAnswered(params: {
|
|
44
|
+
readonly action: string;
|
|
45
|
+
readonly encodedResponse: string | undefined;
|
|
46
|
+
readonly executionContext?: ExecutionContext<any>;
|
|
47
|
+
}): Promise<void>;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Whether a caller of each execution type is asked a declared challenge: `true` when nobody authenticated.
|
|
52
|
+
*
|
|
53
|
+
* TOTAL over the enum on purpose, so a new execution type is a compile error here until someone decides whether it
|
|
54
|
+
* proved an identity: a set of types to ask would exempt a new unauthenticated type silently. A signed-in person, a
|
|
55
|
+
* machine credential, a consumable token and the application's own internal calls (seeds, jobs) are not asked, because a
|
|
56
|
+
* challenge tells a person from a script and those callers already proved who they are. A verified webhook sender and a
|
|
57
|
+
* declared inbound handler proved a signature, not a person, and cannot answer a browser challenge.
|
|
58
|
+
*/
|
|
59
|
+
export const SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE: Readonly<Record<ExecutionContext_ExecutionType, boolean>> = {
|
|
60
|
+
[ExecutionContext_ExecutionType.ANONYMOUS_SESSION]: true,
|
|
61
|
+
[ExecutionContext_ExecutionType.PUBLIC_EXECUTION]: true,
|
|
62
|
+
[ExecutionContext_ExecutionType.USER_REQUEST]: false,
|
|
63
|
+
[ExecutionContext_ExecutionType.ORGANIZATION_MACHINE]: false,
|
|
64
|
+
[ExecutionContext_ExecutionType.APPLICATION_MACHINE]: false,
|
|
65
|
+
[ExecutionContext_ExecutionType.CONSUMABLE_TOKEN]: false,
|
|
66
|
+
[ExecutionContext_ExecutionType.INTERNALLY_INITIATED_REQUEST]: false,
|
|
67
|
+
[ExecutionContext_ExecutionType.WEBHOOK_CALLBACK]: false,
|
|
68
|
+
[ExecutionContext_ExecutionType.INBOUND_DELIVERY]: false,
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Ask a public submission its challenge, refusing when there is nothing to ask it with.
|
|
73
|
+
*
|
|
74
|
+
* The verifier is optional on the service tier, because a minimal container (a test, a platform service) binds none.
|
|
75
|
+
* Skipping the check when it is absent would let an unauthenticated submission through unchecked wherever the binding is
|
|
76
|
+
* missing, and nothing would say so. This fails CLOSED instead: with no verifier it throws a CONFIGURATION error, since
|
|
77
|
+
* whether the application declared a captcha provider — the only thing that could make the check a no-op — is exactly
|
|
78
|
+
* what cannot be known without the verifier.
|
|
79
|
+
*/
|
|
80
|
+
export async function assertPublicSubmissionChallenge(params: {
|
|
81
|
+
readonly verifier: SubmissionChallengeVerifier | undefined;
|
|
82
|
+
readonly errorBuilder: Pick<ErrorBuilderBackendService, 'buildError'>;
|
|
83
|
+
readonly action: string;
|
|
84
|
+
readonly encodedResponse: string | undefined;
|
|
85
|
+
readonly executionContext?: ExecutionContext<any>;
|
|
86
|
+
}): Promise<void> {
|
|
87
|
+
const { verifier, errorBuilder, action, encodedResponse, executionContext } = params;
|
|
88
|
+
if (verifier === undefined) {
|
|
89
|
+
throw errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {
|
|
90
|
+
customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
|
|
91
|
+
context: { message: 'No submission-challenge verifier is bound, so an unauthenticated submission cannot be checked and is refused' },
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
await verifier.assertSubmissionChallengeAnswered({ action, encodedResponse, executionContext });
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* The operation pipeline's one enforcement of a DECLARED challenge (#1985): called by `doOperation` for every operation,
|
|
99
|
+
* on every transport, before anything else in the operation runs.
|
|
100
|
+
*
|
|
101
|
+
* Resolves at once when the operation declares no challenge, or when the caller's execution type proved an identity.
|
|
102
|
+
* Otherwise it asks {@link assertPublicSubmissionChallenge}, which fails closed on a missing verifier. An execution type
|
|
103
|
+
* outside {@link SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE} (a value the enum does not know) reads as `undefined` and
|
|
104
|
+
* is asked.
|
|
105
|
+
*/
|
|
106
|
+
export async function enforceDeclaredSubmissionChallenge(params: {
|
|
107
|
+
readonly declaration: ResourceOperationSubmissionChallenge | undefined;
|
|
108
|
+
readonly verifier: SubmissionChallengeVerifier | undefined;
|
|
109
|
+
readonly errorBuilder: Pick<ErrorBuilderBackendService, 'buildError'>;
|
|
110
|
+
readonly encodedResponse: string | undefined;
|
|
111
|
+
readonly executionContext: ExecutionContext<any>;
|
|
112
|
+
}): Promise<void> {
|
|
113
|
+
const { declaration, verifier, errorBuilder, encodedResponse, executionContext } = params;
|
|
114
|
+
if (declaration === undefined) return;
|
|
115
|
+
if (SUBMISSION_CHALLENGE_ASKED_BY_EXECUTION_TYPE[executionContext.executionType] === false) return;
|
|
116
|
+
await assertPublicSubmissionChallenge({ verifier, errorBuilder, action: declaration.action, encodedResponse, executionContext });
|
|
117
|
+
}
|
|
118
|
+
```
|