@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,800 @@
|
|
|
1
|
+
# Framework inbound channel API (source-backed)
|
|
2
|
+
|
|
3
|
+
The contracts an email channel handler is written against. Read when you declare a channel handler, choose
|
|
4
|
+
its minimum sender assurance, or read a conversation thread.
|
|
5
|
+
|
|
6
|
+
- The channel and sender-assurance vocabulary, the per-channel ladders and the reply mode:
|
|
7
|
+
|
|
8
|
+
## Import Origins
|
|
9
|
+
|
|
10
|
+
- `@wildo-ai/saas-models`
|
|
11
|
+
|
|
12
|
+
## Source Excerpts
|
|
13
|
+
|
|
14
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
15
|
+
|
|
16
|
+
```typescript
|
|
17
|
+
/**
|
|
18
|
+
* What a message arrived on.
|
|
19
|
+
*
|
|
20
|
+
* SMS, chat and Slack join this vocabulary when a provider can fill them — a channel nothing can
|
|
21
|
+
* receive on is a slot no configuration can satisfy.
|
|
22
|
+
*/
|
|
23
|
+
export enum InboundChannelKind {
|
|
24
|
+
/** Email received through the application's `EMAIL_INBOUND` provider and routed to an organization. */
|
|
25
|
+
EMAIL = 'email',
|
|
26
|
+
/**
|
|
27
|
+
* A signed HTTP delivery from another system (#1596). Derived for provider and application endpoint
|
|
28
|
+
* deliveries; a handler never declares it.
|
|
29
|
+
*/
|
|
30
|
+
WEBHOOK = 'webhook',
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* How much is known about who SENT a message.
|
|
35
|
+
*
|
|
36
|
+
* **Identification, never authentication.** An address, a domain or even a reply token identifies a
|
|
37
|
+
* sender to some degree; none of them authenticates a person. Assurance therefore GATES what a handler
|
|
38
|
+
* accepts (a handler declares the minimum it will act on) and grants NO authority: the handler acts
|
|
39
|
+
* with the roles it declares, whoever wrote.
|
|
40
|
+
*
|
|
41
|
+
* spec-cite: NIST SP 800-63B rev. 4 §3.1.3.1 ("Email SHALL NOT be used for out-of-band authentication");
|
|
42
|
+
* RFC 7489 §3.1 (DMARC authenticates the RFC5322.From DOMAIN by alignment with an authenticated
|
|
43
|
+
* identifier, not the person). Both as recorded in #1630's decisions log, 2026-09-25.
|
|
44
|
+
*
|
|
45
|
+
* **Ordered only within a channel.** Each channel has its own ladder ({@link INBOUND_SENDER_ASSURANCE_LADDERS});
|
|
46
|
+
* a signed webhook is not "more" or "less" than a domain-aligned email, so there is no total order and
|
|
47
|
+
* comparing across channels is refused.
|
|
48
|
+
*/
|
|
49
|
+
export enum InboundSenderAssurance {
|
|
50
|
+
/** Nothing about the sender verified. The floor of every ladder. */
|
|
51
|
+
UNVERIFIED = 'unverified',
|
|
52
|
+
/** WEBHOOK: the delivery carried a valid signature under the source's secret. Identifies the SOURCE system. */
|
|
53
|
+
SOURCE_SIGNED = 'source_signed',
|
|
54
|
+
/** EMAIL: DMARC passed and is aligned with the `From` domain — the domain, not the mailbox, is authenticated. */
|
|
55
|
+
DOMAIN_ALIGNED = 'domain_aligned',
|
|
56
|
+
/**
|
|
57
|
+
* EMAIL: domain-aligned, and the address is known to the routed organization — a verified member, or a
|
|
58
|
+
* contact the application's resolver recognises.
|
|
59
|
+
*/
|
|
60
|
+
KNOWN_CONTACT = 'known_contact',
|
|
61
|
+
/**
|
|
62
|
+
* EMAIL: domain-aligned, arrived on an unrevoked reply token the application issued for this thread,
|
|
63
|
+
* and `From` is the address that token was issued to.
|
|
64
|
+
*/
|
|
65
|
+
THREAD_TOKEN_BOUND = 'thread_token_bound',
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/** The assurance levels meaningful on each channel — the type a channel's ladder and minimum are drawn from. */
|
|
69
|
+
export interface InboundSenderAssuranceByChannel {
|
|
70
|
+
[InboundChannelKind.EMAIL]:
|
|
71
|
+
| InboundSenderAssurance.UNVERIFIED
|
|
72
|
+
| InboundSenderAssurance.DOMAIN_ALIGNED
|
|
73
|
+
| InboundSenderAssurance.KNOWN_CONTACT
|
|
74
|
+
| InboundSenderAssurance.THREAD_TOKEN_BOUND;
|
|
75
|
+
[InboundChannelKind.WEBHOOK]: InboundSenderAssurance.UNVERIFIED | InboundSenderAssurance.SOURCE_SIGNED;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** An assurance level of channel `C`. `SenderAssuranceOf<EMAIL>` does not admit `SOURCE_SIGNED`. */
|
|
79
|
+
export type SenderAssuranceOf<C extends InboundChannelKind> = InboundSenderAssuranceByChannel[C];
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Each channel's ladder, lowest first. Total over {@link InboundChannelKind}: a channel added without a
|
|
83
|
+
* ladder does not compile.
|
|
84
|
+
*/
|
|
85
|
+
export const INBOUND_SENDER_ASSURANCE_LADDERS: { readonly [C in InboundChannelKind]: readonly SenderAssuranceOf<C>[] } = {
|
|
86
|
+
[InboundChannelKind.EMAIL]: [
|
|
87
|
+
InboundSenderAssurance.UNVERIFIED,
|
|
88
|
+
InboundSenderAssurance.DOMAIN_ALIGNED,
|
|
89
|
+
InboundSenderAssurance.KNOWN_CONTACT,
|
|
90
|
+
InboundSenderAssurance.THREAD_TOKEN_BOUND,
|
|
91
|
+
],
|
|
92
|
+
[InboundChannelKind.WEBHOOK]: [InboundSenderAssurance.UNVERIFIED, InboundSenderAssurance.SOURCE_SIGNED],
|
|
93
|
+
};
|
|
94
|
+
|
|
95
|
+
/** Thrown when an assurance level is asked about on a channel whose ladder does not contain it. */
|
|
96
|
+
export class InboundSenderAssuranceChannelError extends Error {
|
|
97
|
+
constructor(channel: InboundChannelKind, level: InboundSenderAssurance) {
|
|
98
|
+
super(`Sender assurance '${level}' is not on the ${channel} channel's ladder; assurance is compared only within one channel`);
|
|
99
|
+
this.name = 'InboundSenderAssuranceChannelError';
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* The rank of `level` on `channel`'s ladder, 0 for the floor.
|
|
105
|
+
*
|
|
106
|
+
* The type admits only that channel's levels, so `senderAssuranceRank(InboundChannelKind.WEBHOOK,
|
|
107
|
+
* InboundSenderAssurance.DOMAIN_ALIGNED)` does not compile; a value that reached here untyped (a stored
|
|
108
|
+
* row, a JSON payload) and is not on the ladder throws rather than ranking as anything.
|
|
109
|
+
*/
|
|
110
|
+
export function senderAssuranceRank<C extends InboundChannelKind>(channel: C, level: SenderAssuranceOf<C>): number {
|
|
111
|
+
const ladder = INBOUND_SENDER_ASSURANCE_LADDERS[channel] as readonly InboundSenderAssurance[];
|
|
112
|
+
const rank = ladder.indexOf(level);
|
|
113
|
+
if (rank < 0) throw new InboundSenderAssuranceChannelError(channel, level);
|
|
114
|
+
return rank;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** Whether `level` is at least `minimum`, both on `channel`'s ladder. */
|
|
118
|
+
export function meetsMinimumSenderAssurance<C extends InboundChannelKind>(channel: C, level: SenderAssuranceOf<C>, minimum: SenderAssuranceOf<C>): boolean {
|
|
119
|
+
return senderAssuranceRank(channel, level) >= senderAssuranceRank(channel, minimum);
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/** Whether `level` is a level of `channel` — for narrowing a value read back from storage. */
|
|
123
|
+
export function isSenderAssuranceOf<C extends InboundChannelKind>(channel: C, level: InboundSenderAssurance): level is SenderAssuranceOf<C> {
|
|
124
|
+
return (INBOUND_SENDER_ASSURANCE_LADDERS[channel] as readonly InboundSenderAssurance[]).includes(level);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* Whether a channel handler answers, and how. Required on every handler, with no default: a handler
|
|
129
|
+
* that answers and one that does not are different programs, and the type system knows which one it
|
|
130
|
+
* is holding (`ctx.reply` exists only under {@link InboundReplyMode.THREAD}).
|
|
131
|
+
*/
|
|
132
|
+
export enum InboundReplyMode {
|
|
133
|
+
/** Replies go back on the thread the message arrived on, through the channel's outbound path. */
|
|
134
|
+
THREAD = 'thread',
|
|
135
|
+
/** The handler never answers. Every endpoint handler (#1596) and billing declare this. */
|
|
136
|
+
NONE = 'none',
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* What happened to a channel message whose sender assurance is below the selected handler's minimum
|
|
141
|
+
* (#1630). A below-minimum message never reaches the main handler (I11). What it causes instead is the
|
|
142
|
+
* application's binding: a declared below-minimum handler, or nothing but storage and an audit row.
|
|
143
|
+
*/
|
|
144
|
+
export enum InboundBelowMinimumDisposition {
|
|
145
|
+
/** The handler declared a below-minimum handler, and the message was dispatched to it instead. */
|
|
146
|
+
ROUTED_TO_BELOW_MINIMUM_HANDLER = 'routed_to_below_minimum_handler',
|
|
147
|
+
/** No below-minimum handler: stored in its channel record and audited, and dispatched to nobody. */
|
|
148
|
+
STORED_NOT_DISPATCHED = 'stored_not_dispatched',
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
152
|
+
// EMAIL: deriving sender assurance
|
|
153
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
154
|
+
|
|
155
|
+
/** What the routed organization knows about a sender's address. */
|
|
156
|
+
export enum EmailSenderContactMatch {
|
|
157
|
+
/** Neither a member nor a contact the application recognises. */
|
|
158
|
+
NONE = 'none',
|
|
159
|
+
/** A verified, active member of the routed organization (engine-known; sets `memberUserId`). */
|
|
160
|
+
ORGANIZATION_MEMBER = 'organization_member',
|
|
161
|
+
/** The application's contact resolver answered true. The engine keeps no contacts of its own. */
|
|
162
|
+
APPLICATION_CONTACT = 'application_contact',
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
/** How the reply token a message arrived on (if any) relates to its sender. */
|
|
166
|
+
export enum EmailReplyTokenSenderMatch {
|
|
167
|
+
/** The message did not arrive on a live token of the routed organization. */
|
|
168
|
+
NO_TOKEN = 'no_token',
|
|
169
|
+
/** A live token, and `From` is the address it was issued to. */
|
|
170
|
+
MATCHES_RECIPIENT = 'matches_recipient',
|
|
171
|
+
/** A live token, `From` is on the recipient's domain but is another mailbox. */
|
|
172
|
+
OTHER_ADDRESS_SAME_DOMAIN = 'other_address_same_domain',
|
|
173
|
+
/** A live token, `From` is on another domain than the address it was issued to. */
|
|
174
|
+
OTHER_DOMAIN = 'other_domain',
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/** Why a live reply token did not bind its message — recorded on `INBOUND_REPLY_TOKEN_DOWNGRADED`. */
|
|
178
|
+
export enum ReplyTokenDowngradeReason {
|
|
179
|
+
/** `From` is not the address the token was issued to, though on its domain. */
|
|
180
|
+
SENDER_ADDRESS_MISMATCH = 'sender_address_mismatch',
|
|
181
|
+
/** `From` is on another domain than the address the token was issued to — the case a leaked token looks like. */
|
|
182
|
+
SENDER_DOMAIN_MISMATCH = 'sender_domain_mismatch',
|
|
183
|
+
/** The token is live but DMARC did not pass aligned, so the `From` domain itself is unauthenticated. */
|
|
184
|
+
DOMAIN_NOT_ALIGNED = 'domain_not_aligned',
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/** The inputs {@link deriveEmailSenderAssurance} reads. All of them are facts, never answers a sender gave. */
|
|
188
|
+
export interface EmailSenderAssuranceInput {
|
|
189
|
+
readonly authentication: StandardInboundEmail_Authentication;
|
|
190
|
+
readonly contactMatch: EmailSenderContactMatch;
|
|
191
|
+
readonly tokenMatch: EmailReplyTokenSenderMatch;
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
export interface EmailSenderAssuranceDerivation {
|
|
195
|
+
readonly assurance: SenderAssuranceOf<InboundChannelKind.EMAIL>;
|
|
196
|
+
/** Set when a live token arrived and did not bind the message; the caller audits it. */
|
|
197
|
+
readonly tokenDowngrade?: ReplyTokenDowngradeReason;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** DMARC passed AND aligned with the `From` domain — the one fact every level above the floor rests on. */
|
|
201
|
+
export function isEmailDomainAligned(authentication: StandardInboundEmail_Authentication): boolean {
|
|
202
|
+
return authentication.dmarc === EmailAuthenticationVerdict.PASS && authentication.dmarcAligned;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* Derive an email's sender assurance. PURE: every input is a fact the engine established (the
|
|
207
|
+
* provider's authentication results, a member or contact lookup, a token lookup).
|
|
208
|
+
*
|
|
209
|
+
* - `UNVERIFIED`: DMARC did not pass aligned with `From`. Nothing below is consulted: a token or a
|
|
210
|
+
* known address on an unauthenticated domain proves nothing, since anyone can write that `From`.
|
|
211
|
+
* - `THREAD_TOKEN_BOUND`: aligned, and the message arrived on a live token issued to `From`.
|
|
212
|
+
* - `KNOWN_CONTACT`: aligned, and the address is a member or a recognised contact.
|
|
213
|
+
* - `DOMAIN_ALIGNED`: aligned, and nothing more is known.
|
|
214
|
+
*
|
|
215
|
+
* A live token that did not bind — `From` is someone else, or the domain did not align — falls back to
|
|
216
|
+
* the level the rest derives and reports why in `tokenDowngrade`, which the caller audits.
|
|
217
|
+
*/
|
|
218
|
+
export function deriveEmailSenderAssurance(input: EmailSenderAssuranceInput): EmailSenderAssuranceDerivation {
|
|
219
|
+
const aligned = isEmailDomainAligned(input.authentication);
|
|
220
|
+
if (!aligned) {
|
|
221
|
+
return input.tokenMatch === EmailReplyTokenSenderMatch.NO_TOKEN
|
|
222
|
+
? { assurance: InboundSenderAssurance.UNVERIFIED }
|
|
223
|
+
: { assurance: InboundSenderAssurance.UNVERIFIED, tokenDowngrade: ReplyTokenDowngradeReason.DOMAIN_NOT_ALIGNED };
|
|
224
|
+
}
|
|
225
|
+
if (input.tokenMatch === EmailReplyTokenSenderMatch.MATCHES_RECIPIENT) {
|
|
226
|
+
return { assurance: InboundSenderAssurance.THREAD_TOKEN_BOUND };
|
|
227
|
+
}
|
|
228
|
+
const assurance = input.contactMatch === EmailSenderContactMatch.NONE
|
|
229
|
+
? InboundSenderAssurance.DOMAIN_ALIGNED
|
|
230
|
+
: InboundSenderAssurance.KNOWN_CONTACT;
|
|
231
|
+
switch (input.tokenMatch) {
|
|
232
|
+
case EmailReplyTokenSenderMatch.NO_TOKEN: return { assurance };
|
|
233
|
+
case EmailReplyTokenSenderMatch.OTHER_ADDRESS_SAME_DOMAIN: return { assurance, tokenDowngrade: ReplyTokenDowngradeReason.SENDER_ADDRESS_MISMATCH };
|
|
234
|
+
case EmailReplyTokenSenderMatch.OTHER_DOMAIN: return { assurance, tokenDowngrade: ReplyTokenDowngradeReason.SENDER_DOMAIN_MISMATCH };
|
|
235
|
+
default: {
|
|
236
|
+
const unhandled: never = input.tokenMatch;
|
|
237
|
+
return unhandled;
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/** The domain of an address, lower-cased; `undefined` when there is no `@`. */
|
|
243
|
+
export function emailAddressDomain(address: string): string | undefined {
|
|
244
|
+
const at = address.lastIndexOf('@');
|
|
245
|
+
return at < 0 ? undefined : address.slice(at + 1).trim().toLowerCase();
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/**
|
|
249
|
+
* Whether two addresses are on the same domain. An address with no domain shares a domain with nothing —
|
|
250
|
+
* not even another address with no domain — so a malformed `From` can never pass as a colleague's.
|
|
251
|
+
*/
|
|
252
|
+
export function emailAddressesShareDomain(first: string, second: string): boolean {
|
|
253
|
+
const domain = emailAddressDomain(first);
|
|
254
|
+
return domain !== undefined && domain.length > 0 && domain === emailAddressDomain(second);
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
/** How `from` relates to the address a reply token was issued to. Addresses compare case-insensitively. */
|
|
258
|
+
export function matchReplyTokenSender(from: string, recipient: string): Exclude<EmailReplyTokenSenderMatch, EmailReplyTokenSenderMatch.NO_TOKEN> {
|
|
259
|
+
if (from.trim().toLowerCase() === recipient.trim().toLowerCase()) return EmailReplyTokenSenderMatch.MATCHES_RECIPIENT;
|
|
260
|
+
return emailAddressesShareDomain(from, recipient)
|
|
261
|
+
? EmailReplyTokenSenderMatch.OTHER_ADDRESS_SAME_DOMAIN
|
|
262
|
+
: EmailReplyTokenSenderMatch.OTHER_DOMAIN;
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
/**
|
|
266
|
+
* One RFC 5322 `msg-id` — angle brackets, one `@`, no whitespace and no CR/LF. The one check for a
|
|
267
|
+
* Message-ID wherever the engine reads one from a sender (`In-Reply-To`, `References`) or writes one into
|
|
268
|
+
* a header, so a value that could inject a header or break threading is dropped where it arrives.
|
|
269
|
+
*/
|
|
270
|
+
export const EMAIL_MESSAGE_ID_PATTERN = /^<[^<>\s@]+@[^<>\s@]+>$/;
|
|
271
|
+
|
|
272
|
+
export function isEmailMessageId(value: unknown): value is string {
|
|
273
|
+
return typeof value === 'string' && EMAIL_MESSAGE_ID_PATTERN.test(value);
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
/**
|
|
277
|
+
* What an inbound handler's `ref` looks like: lower-case, dot-separated segments of `[a-z0-9-]`
|
|
278
|
+
* (`todos.intake`, `matters.mail-intake`). One definition for the backend's `inboundHandlerRef()`, which
|
|
279
|
+
* refuses anything else at module load, and for a build plan naming the handler a task produces.
|
|
280
|
+
*/
|
|
281
|
+
export const INBOUND_HANDLER_REF_PATTERN = /^[a-z][a-z0-9-]*(\.[a-z][a-z0-9-]*)*$/;
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
- The channel handler contract — `defineInboundChannelHandler`, the source (channel, route tag, default),
|
|
285
|
+
`replyMode`, `minimumSenderAssurance`, `contactResolver`, the message envelope and `ctx`:
|
|
286
|
+
|
|
287
|
+
## Import Origins
|
|
288
|
+
|
|
289
|
+
- `@wildo-ai/saas-backend-lib`
|
|
290
|
+
|
|
291
|
+
## Source Excerpts
|
|
292
|
+
|
|
293
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
294
|
+
|
|
295
|
+
```typescript
|
|
296
|
+
/**
|
|
297
|
+
* Which channel messages a handler takes.
|
|
298
|
+
*
|
|
299
|
+
* Selection among a channel's handlers: an exact `routeTag` match wins; otherwise the ONE handler with
|
|
300
|
+
* `isDefault: true` takes the message. With the channel's capability enabled, exactly one default is
|
|
301
|
+
* required, and two handlers claiming one `routeTag` stop the application at startup. A handler with
|
|
302
|
+
* neither is reachable only as another handler's `belowMinimumHandlerRef`.
|
|
303
|
+
*/
|
|
304
|
+
export interface InboundChannelSource<C extends InboundChannelKind = InboundChannelKind> {
|
|
305
|
+
readonly kind: InboundSourceKind.CHANNEL;
|
|
306
|
+
readonly channel: C;
|
|
307
|
+
/**
|
|
308
|
+
* The tag routing names — for email, `tag` in `cases+tag@firm.example`. Lower-case letters, digits
|
|
309
|
+
* and hyphens.
|
|
310
|
+
*/
|
|
311
|
+
readonly routeTag?: string;
|
|
312
|
+
/** Take every message no `routeTag` claims. */
|
|
313
|
+
readonly isDefault?: boolean;
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
/** Who sent a message, as far as the engine could establish. */
|
|
317
|
+
export interface InboundMessageSender<C extends InboundChannelKind = InboundChannelKind> {
|
|
318
|
+
readonly address: string;
|
|
319
|
+
readonly name?: string;
|
|
320
|
+
/** Identification, never authentication — see `InboundSenderAssurance`. It grants nothing. */
|
|
321
|
+
readonly assurance: SenderAssuranceOf<C>;
|
|
322
|
+
/** Set when the sender is a verified, active member of the routed organization. */
|
|
323
|
+
readonly memberUserId?: string;
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
/** The thread a message was recorded in. */
|
|
327
|
+
export interface InboundMessageThread {
|
|
328
|
+
readonly id: string;
|
|
329
|
+
readonly subject: string;
|
|
330
|
+
/** The case the thread is about, once a handler linked it; `null` until then. */
|
|
331
|
+
readonly linkedResource: WorkUnitRef | null;
|
|
332
|
+
/** True when this message opened the thread. */
|
|
333
|
+
readonly isNew: boolean;
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
/** A scanned attachment, stored as a file the handler may link. */
|
|
337
|
+
export interface InboundMessageAttachment {
|
|
338
|
+
readonly fileId: string;
|
|
339
|
+
readonly filename: string;
|
|
340
|
+
readonly contentType: string;
|
|
341
|
+
readonly sizeBytes: number;
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
/** An attachment that was NOT made available, and why (an infected file is never exposed). */
|
|
345
|
+
export interface InboundMessageWithheldAttachment {
|
|
346
|
+
readonly filename: string;
|
|
347
|
+
readonly reason: string;
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
/**
|
|
351
|
+
* What an email handler receives about the message beyond its text: the addressing and the subject.
|
|
352
|
+
* Never a provider's own payload — the handler does not know which provider received the mail.
|
|
353
|
+
*/
|
|
354
|
+
export interface InboundEmailPayload {
|
|
355
|
+
readonly subject: string;
|
|
356
|
+
readonly to: readonly string[];
|
|
357
|
+
readonly cc: readonly string[];
|
|
358
|
+
readonly messageId?: string;
|
|
359
|
+
/** The tag the message was routed on, when it carried one. */
|
|
360
|
+
readonly routeTag?: string;
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
/** The payload each channel carries — total over the channels a handler can be declared for. */
|
|
364
|
+
export interface InboundChannelPayloadByChannel {
|
|
365
|
+
[InboundChannelKind.EMAIL]: InboundEmailPayload;
|
|
366
|
+
}
|
|
367
|
+
|
|
368
|
+
/** A channel a handler may be declared for. `WEBHOOK` is the endpoint handlers' channel, never declared here. */
|
|
369
|
+
export type DeclarableInboundChannel = keyof InboundChannelPayloadByChannel;
|
|
370
|
+
|
|
371
|
+
/**
|
|
372
|
+
* The envelope a channel handler receives.
|
|
373
|
+
*
|
|
374
|
+
* Inbound content is DATA, never instructions: `text` and `strippedReply` are whatever the sender wrote,
|
|
375
|
+
* and nothing in them is a command the handler must follow (OWASP LLM01:2025 when a model reads it).
|
|
376
|
+
*/
|
|
377
|
+
export interface InboundMessage<C extends DeclarableInboundChannel = DeclarableInboundChannel> {
|
|
378
|
+
readonly deliveryId: string;
|
|
379
|
+
readonly channel: C;
|
|
380
|
+
readonly thread: InboundMessageThread;
|
|
381
|
+
readonly sender: InboundMessageSender<C>;
|
|
382
|
+
/** The message text. */
|
|
383
|
+
readonly text: string;
|
|
384
|
+
/** The new part of a reply, without the quoted history, when the channel could separate it. */
|
|
385
|
+
readonly strippedReply?: string;
|
|
386
|
+
readonly attachments: readonly InboundMessageAttachment[];
|
|
387
|
+
readonly withheldAttachments: readonly InboundMessageWithheldAttachment[];
|
|
388
|
+
readonly payload: InboundChannelPayloadByChannel[C];
|
|
389
|
+
}
|
|
390
|
+
|
|
391
|
+
/** Read-only lookups a contact resolver may use, confined to the routed organization's own rows. */
|
|
392
|
+
export interface InboundContactLookups {
|
|
393
|
+
/** Whether a row of an ORGANIZATIONS-scoped `resourceType` in the routed organization has `field` equal to `value`. */
|
|
394
|
+
exists(resourceType: string, field: string, value: string): Promise<boolean>;
|
|
395
|
+
}
|
|
396
|
+
|
|
397
|
+
/**
|
|
398
|
+
* The application's answer to "is this address a contact of this organization?" (#1630 M6). The engine
|
|
399
|
+
* keeps no contacts: without a resolver, only members of the organization reach `KNOWN_CONTACT`. Asked
|
|
400
|
+
* only for a domain-aligned sender, and a resolver that throws counts as "no".
|
|
401
|
+
*/
|
|
402
|
+
export type InboundContactResolver = (input: {
|
|
403
|
+
readonly organizationId: string;
|
|
404
|
+
readonly address: string;
|
|
405
|
+
readonly lookups: InboundContactLookups;
|
|
406
|
+
}) => Promise<boolean>;
|
|
407
|
+
|
|
408
|
+
/** What a handler asks `ctx.reply` to send. The HANDLER chooses the template; the engine chooses nothing. */
|
|
409
|
+
export interface InboundReplyRequest {
|
|
410
|
+
/** An email template the application registered, e.g. `todos.intake_received`. */
|
|
411
|
+
readonly templateRef: string;
|
|
412
|
+
/** Rendered into the template as `additionalContext`. Stored on the reply's message row until the reply's retention ends. */
|
|
413
|
+
readonly variables: Readonly<Record<string, unknown>>;
|
|
414
|
+
}
|
|
415
|
+
|
|
416
|
+
/** The reply that was queued — one per call, idempotent per delivery and template (see `ctx.reply`). */
|
|
417
|
+
export interface InboundQueuedReply {
|
|
418
|
+
readonly conversationMessageId: string;
|
|
419
|
+
readonly submissionId: string;
|
|
420
|
+
}
|
|
421
|
+
|
|
422
|
+
/** The thread operations a handler may take, on its own thread only. */
|
|
423
|
+
export interface InboundThreadOperations {
|
|
424
|
+
/**
|
|
425
|
+
* Link the thread to the case it is about. The case must be a row the handler can READ with its own
|
|
426
|
+
* roles in the delivery's organization — linking is not a way to reach a record the handler cannot.
|
|
427
|
+
*/
|
|
428
|
+
link(ref: WorkUnitRef): Promise<void>;
|
|
429
|
+
}
|
|
430
|
+
|
|
431
|
+
/**
|
|
432
|
+
* What every channel handler receives beside the message: every door an ENDPOINT handler has (resource
|
|
433
|
+
* operations through the same gate, and whatever further door the worker gives handlers — the autonomous
|
|
434
|
+
* agent entry point, #1611), with the delivery described in the channel's terms, plus its thread.
|
|
435
|
+
*
|
|
436
|
+
* Derived from the endpoint context rather than restated, so a channel handler can never hold a door an
|
|
437
|
+
* endpoint handler with the same roles does not.
|
|
438
|
+
*/
|
|
439
|
+
export type InboundChannelHandlerContextBase = Omit<InboundHandlerContext, 'delivery'> & {
|
|
440
|
+
readonly delivery: {
|
|
441
|
+
readonly id: string;
|
|
442
|
+
readonly handlerRef: InboundHandlerRef;
|
|
443
|
+
readonly receivedAt: Date;
|
|
444
|
+
readonly attempt: number;
|
|
445
|
+
readonly organizationId: string;
|
|
446
|
+
};
|
|
447
|
+
readonly thread: InboundThreadOperations;
|
|
448
|
+
};
|
|
449
|
+
|
|
450
|
+
/**
|
|
451
|
+
* The context a handler of reply mode `M` receives. Under `THREAD` it can answer; under `NONE` `reply`
|
|
452
|
+
* is `never`, so calling it does not compile.
|
|
453
|
+
*/
|
|
454
|
+
export type InboundChannelHandlerContext<M extends InboundReplyMode> = InboundChannelHandlerContextBase & (
|
|
455
|
+
M extends InboundReplyMode.THREAD
|
|
456
|
+
? {
|
|
457
|
+
/**
|
|
458
|
+
* Answer on the thread the message arrived on, and only there (I7). Writes the reply as an OUTBOUND
|
|
459
|
+
* message and queues it; the reply worker sends it through the application's transactional email
|
|
460
|
+
* provider with the thread's headers. Calling it twice with the same template in one delivery
|
|
461
|
+
* queues ONE reply — a retried handler does not answer twice.
|
|
462
|
+
*/
|
|
463
|
+
readonly reply: (request: InboundReplyRequest) => Promise<InboundQueuedReply>;
|
|
464
|
+
}
|
|
465
|
+
: { readonly reply?: never }
|
|
466
|
+
);
|
|
467
|
+
|
|
468
|
+
/** One channel handler. Build it with {@link defineInboundChannelHandler} so the channel and reply mode are inferred. */
|
|
469
|
+
export interface InboundChannelHandlerDefinition<C extends DeclarableInboundChannel = DeclarableInboundChannel, M extends InboundReplyMode = InboundReplyMode> {
|
|
470
|
+
readonly ref: InboundHandlerRef;
|
|
471
|
+
readonly source: InboundChannelSource<C>;
|
|
472
|
+
/** Required, no default: whether this handler answers. */
|
|
473
|
+
readonly replyMode: M;
|
|
474
|
+
/** The least sender assurance this handler acts on, from its channel's ladder. */
|
|
475
|
+
readonly minimumSenderAssurance: SenderAssuranceOf<C>;
|
|
476
|
+
/**
|
|
477
|
+
* Where a message below the minimum goes instead. Without one, it is stored in its channel record,
|
|
478
|
+
* audited `INBOUND_DELIVERY_BELOW_ASSURANCE`, and dispatched to nobody — who sees it is the
|
|
479
|
+
* application's decision, not the framework's.
|
|
480
|
+
*/
|
|
481
|
+
readonly belowMinimumHandlerRef?: InboundHandlerRef;
|
|
482
|
+
/** Recognises the application's own contacts, lifting a domain-aligned sender to `KNOWN_CONTACT`. */
|
|
483
|
+
readonly contactResolver?: InboundContactResolver;
|
|
484
|
+
/** The handler's whole authority, in the routed organization. Never the super-administrator role. */
|
|
485
|
+
readonly actingRoles: { readonly organization: readonly string[] };
|
|
486
|
+
readonly retry?: InboundRetryPolicy;
|
|
487
|
+
handle(ctx: InboundChannelHandlerContext<M>, message: InboundMessage<C>): Promise<void>;
|
|
488
|
+
}
|
|
489
|
+
|
|
490
|
+
/** Identity function that infers the channel and the reply mode, so `ctx.reply` is typed from the declaration. */
|
|
491
|
+
export function defineInboundChannelHandler<C extends DeclarableInboundChannel, M extends InboundReplyMode>(
|
|
492
|
+
definition: InboundChannelHandlerDefinition<C, M>,
|
|
493
|
+
): InboundChannelHandlerDefinition<C, M> {
|
|
494
|
+
return definition;
|
|
495
|
+
}
|
|
496
|
+
```
|
|
497
|
+
|
|
498
|
+
- The conversation thread, message and reply-token resources a channel writes:
|
|
499
|
+
|
|
500
|
+
## Import Origins
|
|
501
|
+
|
|
502
|
+
- `@wildo-ai/saas-models`
|
|
503
|
+
|
|
504
|
+
## Source Excerpts
|
|
505
|
+
|
|
506
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
507
|
+
|
|
508
|
+
```typescript
|
|
509
|
+
/** Whether a thread still takes messages. */
|
|
510
|
+
export enum ConversationThreadStatus {
|
|
511
|
+
OPEN = 'open',
|
|
512
|
+
/**
|
|
513
|
+
* The exchange is over. Closing revokes every reply token of the thread, and starts the thread's
|
|
514
|
+
* retention clock: a closed thread is kept for the `RESOURCE_DATA` period from `closedAt`. Its messages
|
|
515
|
+
* keep their own, statutory, clock.
|
|
516
|
+
*/
|
|
517
|
+
CLOSED = 'closed',
|
|
518
|
+
}
|
|
519
|
+
|
|
520
|
+
/** Which way a message travelled. */
|
|
521
|
+
export enum ConversationMessageDirection {
|
|
522
|
+
/** Received from the counterpart; its handler run is recorded on the inbound delivery. */
|
|
523
|
+
INBOUND = 'inbound',
|
|
524
|
+
/** Sent by the application, as a handler's reply. */
|
|
525
|
+
OUTBOUND = 'outbound',
|
|
526
|
+
}
|
|
527
|
+
|
|
528
|
+
/** Where an OUTBOUND message stands with the sending provider. */
|
|
529
|
+
export enum ConversationOutboundStatus {
|
|
530
|
+
/** Written by `ctx.reply` and waiting for the reply worker. */
|
|
531
|
+
QUEUED = 'queued',
|
|
532
|
+
/** The sending provider accepted the submission. Terminal: a retry of the same submission never sends again. */
|
|
533
|
+
ACCEPTED_BY_PROVIDER = 'accepted_by_provider',
|
|
534
|
+
/** The provider refused it, or the reply could not be sent at all. Terminal; the reason is `failureCode`. */
|
|
535
|
+
FAILED = 'failed',
|
|
536
|
+
}
|
|
537
|
+
|
|
538
|
+
/** Why a reply token stopped binding replies. */
|
|
539
|
+
export enum ReplyTokenRevocationReason {
|
|
540
|
+
/** Its thread was closed. */
|
|
541
|
+
THREAD_CLOSED = 'thread_closed',
|
|
542
|
+
/** The thread's counterpart changed, so a token issued to the previous one names nobody on the thread. */
|
|
543
|
+
COUNTERPART_CHANGED = 'counterpart_changed',
|
|
544
|
+
/**
|
|
545
|
+
* It was issued to a member of the organization who is no longer one. Detected when the token is next
|
|
546
|
+
* USED, which is the one place every removal door converges: whether the member left, was removed,
|
|
547
|
+
* suspended or erased, the token no longer binds from that moment.
|
|
548
|
+
*/
|
|
549
|
+
MEMBER_REMOVED = 'member_removed',
|
|
550
|
+
/** A newer token was issued to the same recipient on the same thread; one live address per recipient. */
|
|
551
|
+
ROTATED = 'rotated',
|
|
552
|
+
}
|
|
553
|
+
|
|
554
|
+
/** Placeholder written over free text an erasure scrubs. */
|
|
555
|
+
export const ERASED_CONVERSATION_TEXT = '[erased]';
|
|
556
|
+
|
|
557
|
+
const address = () => addImpersonalizeWith(
|
|
558
|
+
z.string().min(1).max(320).dataCategories(PersonalDataCategory.CONTACT_DETAILS),
|
|
559
|
+
RedactionType.MASK,
|
|
560
|
+
{ maskValue: ERASED_CONVERSATION_TEXT },
|
|
561
|
+
);
|
|
562
|
+
|
|
563
|
+
/** What a message's channel record is. The record's resource type is decided by the channel. */
|
|
564
|
+
export const ConversationChannelRecordRefSchema = z.strictObject({
|
|
565
|
+
resourceType: z.string().min(1).describe('The resource holding what the message was on its channel — `inboundEmails` for email.'),
|
|
566
|
+
resourceId: z.string().min(1).describe('The id of that row.'),
|
|
567
|
+
});
|
|
568
|
+
|
|
569
|
+
export type ConversationChannelRecordRef = z.infer<typeof ConversationChannelRecordRefSchema>;
|
|
570
|
+
|
|
571
|
+
/**
|
|
572
|
+
* One exchange with one counterpart on one channel.
|
|
573
|
+
*
|
|
574
|
+
* `threadKey` is the channel's correlation key — for email, the `Message-ID` of the message that opened
|
|
575
|
+
* the thread — unique per organization and channel: the same message delivered to two organizations
|
|
576
|
+
* opens a thread in each.
|
|
577
|
+
*/
|
|
578
|
+
export const ConversationThreadSchema = z.object({
|
|
579
|
+
_id: z.string().min(1).isPrimaryKey().isSummaryField(),
|
|
580
|
+
organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),
|
|
581
|
+
channel: z.enum(InboundChannelKind).systemEnum('InboundChannelKind').isSummaryField().excludeFromUpdate()
|
|
582
|
+
.describe('The channel the thread runs on. Replies go out on this channel only.'),
|
|
583
|
+
threadKey: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
|
|
584
|
+
.describe("The channel's correlation key: for email, the Message-ID of the message that opened the thread."),
|
|
585
|
+
/** The address the application is exchanging messages with. Changing it revokes the previous counterpart's tokens. */
|
|
586
|
+
counterpartAddress: address().isDBIndexed().isSummaryField()
|
|
587
|
+
.describe('The address the application is exchanging messages with on this thread.'),
|
|
588
|
+
subject: addImpersonalizeWith(
|
|
589
|
+
z.string().max(998).default('').isSummaryField().dataCategories(PersonalDataCategory.USER_CONTENT),
|
|
590
|
+
RedactionType.MASK,
|
|
591
|
+
{ maskValue: ERASED_CONVERSATION_TEXT },
|
|
592
|
+
).describe('The subject the thread opened with.'),
|
|
593
|
+
/**
|
|
594
|
+
* The case the thread is about, set by the handler once it knows (a todo it created, a matter it
|
|
595
|
+
* found). A `WorkUnitRef`: the one name for a case across the backbone epic.
|
|
596
|
+
*/
|
|
597
|
+
linkedResource: WorkUnitRefSchema.nullable().default(null)
|
|
598
|
+
.describe('The case this thread is about — the record a handler linked it to — or null while it is linked to none.'),
|
|
599
|
+
status: z.enum(ConversationThreadStatus).systemEnum('ConversationThreadStatus').default(ConversationThreadStatus.OPEN)
|
|
600
|
+
.isDBIndexed().isSummaryField().describe('Whether the thread still takes messages.'),
|
|
601
|
+
lastMessageAt: z.date().isDBIndexed().isSummaryField().describe('When the latest message, in either direction, was recorded.'),
|
|
602
|
+
/** Set when the thread closes — the retention clock's start. Server-owned: a caller setting it could order a deletion. */
|
|
603
|
+
closedAt: z.date().isDBIndexed().nullable().default(null).excludeFromCreate().excludeFromUpdate()
|
|
604
|
+
.describe('When the thread was closed; null while it is open.'),
|
|
605
|
+
createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),
|
|
606
|
+
updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
|
|
607
|
+
}).businessKeySet(['organizationId', 'channel', 'threadKey']);
|
|
608
|
+
|
|
609
|
+
export type ConversationThread = z.infer<typeof ConversationThreadSchema>;
|
|
610
|
+
|
|
611
|
+
/** The threading identity of an OUTBOUND message, as it went on the wire. */
|
|
612
|
+
export const ConversationOutboundThreadingSchema = z.strictObject({
|
|
613
|
+
inReplyTo: z.string().max(998).optional().describe('The Message-ID this reply answers.'),
|
|
614
|
+
references: z.array(z.string().max(998)).max(100).default([]).describe('The thread\'s Message-IDs, oldest first, ending with the one answered.'),
|
|
615
|
+
});
|
|
616
|
+
|
|
617
|
+
/** One message of a thread, in either direction. */
|
|
618
|
+
export const ConversationMessageSchema = z.object({
|
|
619
|
+
_id: z.string().min(1).isPrimaryKey().isSummaryField(),
|
|
620
|
+
organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),
|
|
621
|
+
threadId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate()
|
|
622
|
+
.describe('The thread this message belongs to.'),
|
|
623
|
+
direction: z.enum(ConversationMessageDirection).systemEnum('ConversationMessageDirection').isSummaryField().excludeFromUpdate()
|
|
624
|
+
.describe('Whether the message was received from the counterpart or sent by the application.'),
|
|
625
|
+
/** The RFC 5322 Message-ID on the wire — what a later In-Reply-To or References names. */
|
|
626
|
+
rfcMessageId: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
|
|
627
|
+
.describe('The Message-ID the message carried on the wire, angle brackets included.'),
|
|
628
|
+
fromAddress: address().isSummaryField().describe('Who sent the message.'),
|
|
629
|
+
// RESET, not MASK: the treatment belongs to the ARRAY, and a mask string is not an array. Erasure returns
|
|
630
|
+
// the list to its default — empty.
|
|
631
|
+
toAddresses: addImpersonalizeWith(
|
|
632
|
+
z.array(z.string().min(1).max(320)).default([]).dataCategories(PersonalDataCategory.CONTACT_DETAILS),
|
|
633
|
+
RedactionType.RESET,
|
|
634
|
+
).describe('Who the message was addressed to.'),
|
|
635
|
+
subject: addImpersonalizeWith(
|
|
636
|
+
z.string().max(998).default('').dataCategories(PersonalDataCategory.USER_CONTENT),
|
|
637
|
+
RedactionType.MASK,
|
|
638
|
+
{ maskValue: ERASED_CONVERSATION_TEXT },
|
|
639
|
+
).describe('The message subject.'),
|
|
640
|
+
/**
|
|
641
|
+
* The first characters of the message text, for the thread view. The whole message stays in its channel
|
|
642
|
+
* record; this is a preview, never the record.
|
|
643
|
+
*/
|
|
644
|
+
textPreview: addImpersonalizeWith(
|
|
645
|
+
z.string().max(500).default('').dataCategories(PersonalDataCategory.USER_CONTENT),
|
|
646
|
+
RedactionType.MASK,
|
|
647
|
+
{ maskValue: ERASED_CONVERSATION_TEXT },
|
|
648
|
+
).describe('The first 500 characters of the message text.'),
|
|
649
|
+
occurredAt: z.date().isDBIndexed().isSummaryField().describe('When the message was received, or queued to send.'),
|
|
650
|
+
|
|
651
|
+
// INBOUND ─────────────────────────────────────────────────────────────────
|
|
652
|
+
/** INBOUND: the delivery that carried it. Its status is this message's handler status — there is no second one. */
|
|
653
|
+
inboundDeliveryId: z.string().isDBIndexed().nullable().default(null).excludeFromUpdate()
|
|
654
|
+
.describe('For a received message, the inbound delivery that carried it; its status is the handler run\'s.'),
|
|
655
|
+
/** INBOUND: what the message was on its channel (the `INBOUND_EMAILS` row for email). */
|
|
656
|
+
channelRecordRef: ConversationChannelRecordRefSchema.nullable().default(null).excludeFromUpdate()
|
|
657
|
+
.describe('For a received message, the channel record holding the whole message.'),
|
|
658
|
+
|
|
659
|
+
// OUTBOUND ────────────────────────────────────────────────────────────────
|
|
660
|
+
/**
|
|
661
|
+
* OUTBOUND: the one logical submission this row stands for — deterministic, derived from the row, and
|
|
662
|
+
* handed to the sending provider as its idempotency key, so a retried reply is accepted at most once.
|
|
663
|
+
*/
|
|
664
|
+
// `.optional()`, never `.nullable().default(null)`: a sparse unique index skips a MISSING field, not a
|
|
665
|
+
// stored null, so every received message would collide on `null` under MongoDB.
|
|
666
|
+
submissionId: z.string().min(1).isUnique({ scope: 'global', sparse: true }).optional().excludeFromUpdate()
|
|
667
|
+
.describe('For a reply, the idempotency key of its one submission to the sending provider.'),
|
|
668
|
+
outboundStatus: z.enum(ConversationOutboundStatus).systemEnum('ConversationOutboundStatus').isDBIndexed().nullable().default(null)
|
|
669
|
+
.excludeFromCreate().excludeFromUpdate()
|
|
670
|
+
.describe('For a reply, where it stands with the sending provider; null for a received message.'),
|
|
671
|
+
/** OUTBOUND: the template the HANDLER chose, and the variables it rendered with. */
|
|
672
|
+
templateRef: z.string().max(200).nullable().default(null).excludeFromUpdate()
|
|
673
|
+
.describe('For a reply, the email template the handler chose.'),
|
|
674
|
+
// RESET to the default (`null`): a field carrying a `.default()` is not clearable, so REMOVE is refused.
|
|
675
|
+
templateVariables: addImpersonalizeWith(
|
|
676
|
+
z.record(z.string(), z.unknown()).nullable().default(null).excludeFromUpdate().dataCategories(PersonalDataCategory.USER_CONTENT),
|
|
677
|
+
RedactionType.RESET,
|
|
678
|
+
).describe('For a reply, the variables the template rendered with.'),
|
|
679
|
+
locale: z.string().max(35).nullable().default(null).excludeFromUpdate()
|
|
680
|
+
.describe('For a reply, the locale the template rendered in.'),
|
|
681
|
+
/**
|
|
682
|
+
* For a reply, while it is QUEUED: the Reply-To address its first send attempt composed. It carries the
|
|
683
|
+
* reply token IN PLAINTEXT (I12), so it is backend-only — no API returns it — and it is cleared when the
|
|
684
|
+
* reply settles (accepted or failed). It is kept that long only so a retried attempt sends the same address.
|
|
685
|
+
*/
|
|
686
|
+
replyToAddress: z.string().max(320).isBackendOnly().nullable().default(null).excludeFromUpdate()
|
|
687
|
+
.describe('For a queued reply only, the Reply-To address its send composed; cleared when the reply settles.'),
|
|
688
|
+
threading: ConversationOutboundThreadingSchema.nullable().default(null).excludeFromUpdate()
|
|
689
|
+
.describe('For a reply, the In-Reply-To and References it carried.'),
|
|
690
|
+
/** OUTBOUND: the provider's receipt, once accepted. */
|
|
691
|
+
providerMessageIds: z.array(z.string()).default([]).excludeFromCreate().excludeFromUpdate()
|
|
692
|
+
.describe('For an accepted reply, the ids the sending provider returned.'),
|
|
693
|
+
/** OUTBOUND: a classified failure, never an error message (which could quote the content). */
|
|
694
|
+
failureCode: z.string().max(200).nullable().default(null).excludeFromCreate().excludeFromUpdate()
|
|
695
|
+
.describe('For a failed reply, a classified failure code.'),
|
|
696
|
+
settledAt: z.date().nullable().default(null).excludeFromCreate().excludeFromUpdate()
|
|
697
|
+
.describe('For a reply, when it was accepted or failed.'),
|
|
698
|
+
|
|
699
|
+
createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),
|
|
700
|
+
updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
|
|
701
|
+
});
|
|
702
|
+
|
|
703
|
+
export type ConversationMessage = z.infer<typeof ConversationMessageSchema>;
|
|
704
|
+
|
|
705
|
+
/**
|
|
706
|
+
* One reply address issued to one recipient on one thread.
|
|
707
|
+
*
|
|
708
|
+
* The token itself is a bearer secret — whoever holds the address can post to the thread under that
|
|
709
|
+
* recipient's name, as with any reply-by-email system — so only its SHA-256 is stored, and the plaintext
|
|
710
|
+
* exists only in the address the reply carried. At least 128 bits from a CSPRNG.
|
|
711
|
+
*/
|
|
712
|
+
export const ConversationReplyTokenSchema = z.object({
|
|
713
|
+
_id: z.string().min(1).isPrimaryKey().isSummaryField(),
|
|
714
|
+
organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),
|
|
715
|
+
threadId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate()
|
|
716
|
+
.describe('The thread the token binds replies to.'),
|
|
717
|
+
recipientAddress: address().isSummaryField().excludeFromUpdate()
|
|
718
|
+
.describe('The address the token was issued to; only a reply from this address binds to the thread.'),
|
|
719
|
+
/**
|
|
720
|
+
* When the recipient was a member of the organization at issue, that member's user id — re-checked when
|
|
721
|
+
* the token is used, so a removed member's token stops binding.
|
|
722
|
+
*/
|
|
723
|
+
recipientMemberUserId: z.string().nullable().default(null).excludeFromUpdate()
|
|
724
|
+
.describe('The organization member the token was issued to, when the recipient was one.'),
|
|
725
|
+
/** SHA-256 (hex) of the token. Lookup is global by hash; the token's organization must be the routed one. */
|
|
726
|
+
tokenHash: z.string().length(64).isUnique({ scope: 'global', sparse: false }).isBackendOnly().excludeFromUpdate()
|
|
727
|
+
.describe('The SHA-256 of the token. The token itself is never stored.'),
|
|
728
|
+
issuedAt: z.date().isSummaryField().excludeFromUpdate().describe('When the token was issued.'),
|
|
729
|
+
revokedAt: z.date().isDBIndexed().nullable().default(null).excludeFromCreate().excludeFromUpdate()
|
|
730
|
+
.describe('When the token stopped binding replies; null while it is live.'),
|
|
731
|
+
revocationReason: z.enum(ReplyTokenRevocationReason).systemEnum('ReplyTokenRevocationReason').nullable().default(null)
|
|
732
|
+
.excludeFromCreate().excludeFromUpdate()
|
|
733
|
+
.describe('Why the token stopped binding replies.'),
|
|
734
|
+
createdAt: z.date().default(() => new Date()).isDBIndexed().excludeFromCreate().excludeFromUpdate(),
|
|
735
|
+
updatedAt: z.date().default(() => new Date()).excludeFromCreate().excludeFromUpdate(),
|
|
736
|
+
});
|
|
737
|
+
|
|
738
|
+
export type ConversationReplyToken = z.infer<typeof ConversationReplyTokenSchema>;
|
|
739
|
+
```
|
|
740
|
+
|
|
741
|
+
- The embed that shows a record's conversations on its page, in a READ template or a record composite view:
|
|
742
|
+
|
|
743
|
+
## Import Origins
|
|
744
|
+
|
|
745
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
746
|
+
|
|
747
|
+
## Source Excerpts
|
|
748
|
+
|
|
749
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
750
|
+
|
|
751
|
+
```tsx
|
|
752
|
+
export interface EmbedLinkedConversationsProps {
|
|
753
|
+
className?: string;
|
|
754
|
+
}
|
|
755
|
+
|
|
756
|
+
/**
|
|
757
|
+
* The conversations linked to the host record (#1630) — email threads an inbound channel handler tied to this
|
|
758
|
+
* record with `ctx.thread.link`, newest first. Each opens to its messages in both directions, and an organization
|
|
759
|
+
* administrator can close it.
|
|
760
|
+
*
|
|
761
|
+
* Place it in a READ template or a record composite of the resource your threads are linked to. It is the
|
|
762
|
+
* `conversationThreads` LIST, pinned to this record through `pinnedFilters`: the reader cannot widen it to another
|
|
763
|
+
* record, and it shows only what the reader's own roles may read (organization members read their organization's
|
|
764
|
+
* conversations).
|
|
765
|
+
*
|
|
766
|
+
* @example
|
|
767
|
+
* // frontend/src/modules/<slug>/resources/matters/MatterReadCustomView.tsx
|
|
768
|
+
* <ResourceLayoutPreset_Read_Default {...props}>
|
|
769
|
+
* <Section name="conversations"><EmbedLinkedConversations /></Section>
|
|
770
|
+
* </ResourceLayoutPreset_Read_Default>
|
|
771
|
+
*/
|
|
772
|
+
export function EmbedLinkedConversations({ className }: EmbedLinkedConversationsProps): React.JSX.Element {
|
|
773
|
+
const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
|
|
774
|
+
const compositeResourceContext = useEmbeddedResourceContext();
|
|
775
|
+
const { hostResourceType, hostResourceId } = compositeResourceContext;
|
|
776
|
+
|
|
777
|
+
const resourceContext = useMemo((): FrontendResourceOperationContext => {
|
|
778
|
+
if (!hostResourceId) {
|
|
779
|
+
throw buildResourceEmbedConfigurationError(
|
|
780
|
+
'EmbedLinkedConversations() needs a host RECORD: place it on a READ surface, where the record it lists conversations for exists.',
|
|
781
|
+
{ hostResourceType },
|
|
782
|
+
);
|
|
783
|
+
}
|
|
784
|
+
const threads = compositeResourceContext.buildOperationContext({
|
|
785
|
+
resourceType: CoreResourceType.CONVERSATION_THREADS,
|
|
786
|
+
operationLike: CoreResourceOperation.LIST,
|
|
787
|
+
requireAddressable: false,
|
|
788
|
+
});
|
|
789
|
+
return {
|
|
790
|
+
...threads,
|
|
791
|
+
pinnedFilters: {
|
|
792
|
+
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
|
|
793
|
+
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
|
|
794
|
+
},
|
|
795
|
+
};
|
|
796
|
+
}, [compositeResourceContext, hostResourceType, hostResourceId]);
|
|
797
|
+
|
|
798
|
+
return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
|
|
799
|
+
}
|
|
800
|
+
```
|