@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
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 +321 -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.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -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 +253 -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 +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- 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 +279 -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 +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -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 +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -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 +43 -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 +5957 -1729
- 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
|
@@ -9,8 +9,32 @@ decision table for that selection.
|
|
|
9
9
|
| Agent | Chosen with | Suits | Consequences it carries |
|
|
10
10
|
|---|---|---|---|
|
|
11
11
|
| Claude (default) | nothing — the default | anything, including runs that park on a question | none measured |
|
|
12
|
-
| Codex | `
|
|
13
|
-
| OpenCode | `
|
|
12
|
+
| Codex | `wildo prefs set --coding-agent openai` | single-turn tasks | does not ask before writing; cannot resume a parked run |
|
|
13
|
+
| OpenCode | `wildo prefs set --coding-agent opencode` | reaching a model no other agent serves | does not ask before writing UNLESS its permission config is supplied |
|
|
14
|
+
|
|
15
|
+
The choice belongs to the MACHINE, not the application: the same application
|
|
16
|
+
can be built from two machines with two agents. `WILDO_CODING_AGENT=<ref>` in
|
|
17
|
+
the environment overrides the preference for one shell. A name that is not an
|
|
18
|
+
admitted agent is refused, never silently replaced by the default.
|
|
19
|
+
|
|
20
|
+
## Signed in, on this host
|
|
21
|
+
|
|
22
|
+
Every agent runs on its operator's own login, never on a key the application
|
|
23
|
+
stores — sign in once with the agent's own command:
|
|
24
|
+
|
|
25
|
+
| Agent | Sign in | Checked with |
|
|
26
|
+
|---|---|---|
|
|
27
|
+
| Claude | `claude auth login` | `claude auth status --json` |
|
|
28
|
+
| Codex | `codex login` | `codex login status` |
|
|
29
|
+
| OpenCode | `opencode auth login` | `opencode auth list` |
|
|
30
|
+
|
|
31
|
+
`wildo local doctor` fails while the selected agent is signed out, and warns
|
|
32
|
+
when its status command is not installed (the Claude and Codex agents run
|
|
33
|
+
through adapters that do not need it, so that alone blocks nothing). `wildo
|
|
34
|
+
local dev` warns. A run dispatched while signed out is refused before it
|
|
35
|
+
starts, with the command to sign in — it is not charged to the task. The check
|
|
36
|
+
matters because an agent with no login still starts and answers the
|
|
37
|
+
handshake; it only fails at its first prompt.
|
|
14
38
|
|
|
15
39
|
Each agent was admitted on MEASUREMENT — `wildo acp probe` drives one real
|
|
16
40
|
mutating task and judges the result against the filesystem, not against the
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: email-add-template
|
|
3
3
|
description: Add an email template end-to-end — React Email `template.tsx`, co-located typed `labels.<locale>.ts`, the typed `EmailTemplateDefinition<TLabels>` shape, registration through the owning backend module’s compiled email definitions, and the i18n follow-up. Self-contained orchestrator that absorbs the three layer concerns (template authoring · label authoring · registry wiring). Use when the user says "add a transactional email for <event>", "introduce a new notification email", "scaffold an email template called <name>", "send users an email when <event happens>", "wire the new welcome email so it actually sends", "edit the password-reset email JSX", "add labels for the invoice email", or any request that produces a new entry in the module's email definitions map.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Email Add Template
|
|
@@ -50,7 +51,8 @@ here.
|
|
|
50
51
|
| Surface | Glob (relative to app root) |
|
|
51
52
|
|---------------------|------------------------------------------------------------------------------------------|
|
|
52
53
|
| Template source | `<email-root>/<template-name>/template.tsx` (typed `EmailTemplateDefinition<TLabels>`) |
|
|
53
|
-
|
|
|
54
|
+
| Primary-locale labels | `<email-root>/<template-name>/labels.<primary-locale>.ts` (authored; satisfies `TLabels`) |
|
|
55
|
+
| Other-locale labels | `<email-root>/<template-name>/labels.<locale>.ts` (GENERATED by `wildo generate translate` — never hand-edited) |
|
|
54
56
|
| Labels interface | Co-located in `template.tsx` (e.g. `interface WelcomeLabels { subject: string; ... }`) |
|
|
55
57
|
| Module definitions | Owning module’s scanner or explicit `EmailTemplateDefinitionsMap`, contributed through `emailTemplateDefinitions` |
|
|
56
58
|
| Email type enum | `shared-lib/src/modules/<module>/notifications/<module>-email-template-type.ts` (typed template ids) |
|
|
@@ -62,7 +64,7 @@ here.
|
|
|
62
64
|
- New notification variant that needs its own template id
|
|
63
65
|
- Editing an existing template's JSX, labels, or registration
|
|
64
66
|
(single skill covers all three layers)
|
|
65
|
-
-
|
|
67
|
+
- Enabling another locale for your emails (Step 6 generates the files)
|
|
66
68
|
- Renaming a template id (registration + sender call-site sweep
|
|
67
69
|
in one pass)
|
|
68
70
|
|
|
@@ -76,10 +78,11 @@ here.
|
|
|
76
78
|
- Sending an in-app notification (toast / inbox), not an email →
|
|
77
79
|
`notifications_in_app`
|
|
78
80
|
- App-wide UI label generation (not email-specific) →
|
|
79
|
-
`i18n-label-generation`. Email labels
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
`wildo generate
|
|
81
|
+
`i18n-label-generation`. Email labels are **template-colocated**:
|
|
82
|
+
you author the primary-locale `labels.<locale>.ts` beside each
|
|
83
|
+
template (Step 3), `wildo generate labels` never touches it, and
|
|
84
|
+
`wildo generate translate` writes the other locales beside it
|
|
85
|
+
(Step 6). None of them is read through `scanCustomLabelsDirectory`.
|
|
83
86
|
|
|
84
87
|
## Workflow
|
|
85
88
|
|
|
@@ -90,7 +93,7 @@ the same owning backend module. First locate its `emailTemplateDefinitions` cont
|
|
|
90
93
|
Mirror **structure**, not content:
|
|
91
94
|
|
|
92
95
|
- `template.tsx` co-located with the labels interface
|
|
93
|
-
- One `labels.<locale>.ts`
|
|
96
|
+
- One authored `labels.<primary-locale>.ts` (the other locales are generated)
|
|
94
97
|
- Sibling registration entry as the shape reference
|
|
95
98
|
|
|
96
99
|
This sets the right scaffolding before any of the three layers
|
|
@@ -133,10 +136,12 @@ Constraints:
|
|
|
133
136
|
Read `references/framework-email-template-api.md` for the full
|
|
134
137
|
`EmailTemplateDefinition` contract.
|
|
135
138
|
|
|
136
|
-
### Step 3: Author `labels.<locale>.ts`
|
|
139
|
+
### Step 3: Author `labels.<primary-locale>.ts` (label layer)
|
|
137
140
|
|
|
138
|
-
Co-locate
|
|
139
|
-
to `template.tsx`.
|
|
141
|
+
Co-locate ONE labels file, in the application's primary locale, next
|
|
142
|
+
to `template.tsx`. You author the words there; every other enabled
|
|
143
|
+
locale's file is written from it by `wildo generate translate` (Step 6).
|
|
144
|
+
The file:
|
|
140
145
|
|
|
141
146
|
- **Satisfies the `TLabels` interface key-for-key.** The compiler
|
|
142
147
|
rejects a labels file that omits a key the template references.
|
|
@@ -147,14 +152,29 @@ to `template.tsx`. Each file:
|
|
|
147
152
|
- **Includes the subject line as a label** when the app uses
|
|
148
153
|
localized subjects (typical). Subjects in the JSX are strings
|
|
149
154
|
too; route them through `labels.subject` so translation reaches them.
|
|
150
|
-
- **
|
|
151
|
-
the
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
155
|
+
- **Holds only strings and nested groups of strings.** The translator
|
|
156
|
+
reads the file without running it: a number, a template literal, a
|
|
157
|
+
`'a' + 'b'` concatenation or an imported constant is refused, and that
|
|
158
|
+
email is not translated. Group words by a vocabulary (per stage, per
|
|
159
|
+
alert type) with a nested object instead.
|
|
160
|
+
- **Keeps placeholders as single-brace `{name}` tokens** that the
|
|
161
|
+
template fills with `interpolateEmailLabel`. The translation must
|
|
162
|
+
carry every token as many times as the source does, or it is refused.
|
|
163
|
+
- **Keeps a fragment's edge spaces meaningful.** A value such as
|
|
164
|
+
`' in '` is joined to live values; the translator keeps its leading
|
|
165
|
+
and trailing spaces exactly.
|
|
166
|
+
|
|
167
|
+
**The other locales are generated, not authored.** `wildo generate
|
|
168
|
+
translate` writes `labels.<locale>.ts` beside this file for each locale
|
|
169
|
+
it translates to (`--locales`, default `fr` — pass your enabled
|
|
170
|
+
secondary locales): the same nesting, the same `labels` export, the same `as const`
|
|
171
|
+
and `export type` alias, and a DO-NOT-EDIT header. It writes an email
|
|
172
|
+
WHOLE or not at all — a missing word or a broken placeholder fails that
|
|
173
|
+
email in the command's output and leaves the previous file alone — and
|
|
174
|
+
it re-translates an email only when its primary file changed or the
|
|
175
|
+
generated file no longer matches what it wrote. So a hand edit to a
|
|
176
|
+
generated file is overwritten by the next run: change the words in the
|
|
177
|
+
primary file and re-run.
|
|
158
178
|
|
|
159
179
|
Read `references/email-artifact-paths.md` for naming /
|
|
160
180
|
co-location conventions.
|
|
@@ -187,10 +207,19 @@ Verify:
|
|
|
187
207
|
|
|
188
208
|
### Step 6: Trigger the i18n pipeline
|
|
189
209
|
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
`
|
|
193
|
-
|
|
210
|
+
Whenever the primary-locale words changed (Step 3), run
|
|
211
|
+
`wildo generate translate` from the application root with its companion
|
|
212
|
+
running (`--locales` names the target locales, default `fr`). Its email
|
|
213
|
+
lane translates every template whose primary file changed, or whose
|
|
214
|
+
generated file drifted, since the last run, and only those; each email is a unit named
|
|
215
|
+
`email_template:<templateRef>` (`wildo generate labels plan --list`
|
|
216
|
+
shows them), so one email can be done alone with
|
|
217
|
+
`wildo generate translate --units email_template:<templateRef>`.
|
|
218
|
+
`wildo generate email translate --templates <ref>` runs the same lane.
|
|
219
|
+
A `failed` row names the email and why; fix the primary file (or re-run
|
|
220
|
+
for a model hiccup) — never write the other locale's file by hand. The
|
|
221
|
+
backend's startup warning about an enabled locale falling back to the
|
|
222
|
+
primary one disappears once every template has its file.
|
|
194
223
|
|
|
195
224
|
### Re-run Translation When Text Changes
|
|
196
225
|
|
|
@@ -352,6 +381,7 @@ Run from the app root. Replace `<email-root>` with the actual owning scanner dir
|
|
|
352
381
|
| Definition declares `type:` | `rg -n "type:\s+EmailTemplateType\." <email-root>/<template>/template.tsx` |
|
|
353
382
|
| Subject / body read from `labels.` | `rg -n "labels\.[a-zA-Z]+" <email-root>/<template>/template.tsx` |
|
|
354
383
|
| Locale files exist for every supported locale | `ls <email-root>/<template>/labels.*.ts` |
|
|
384
|
+
| Other-locale files are the generated ones (must return empty) | `rg -L "DO NOT EDIT THIS FILE MANUALLY" <email-root>/<template>/labels.<locale>.ts` (run for each non-primary locale) |
|
|
355
385
|
| Owning registry/scanner and ref mapping are present | `rg -n "scanEmailTemplateDirectory\|keyFromPath\|emailTemplateDefinitions" <registry-file>` (inspect the mapping; scanned templates need no per-template map entry) |
|
|
356
386
|
| Per-locale label files share the same key set | `comm -23 <(rg -o '\\w+:' <email-root>/<template>/labels.<primary-locale>.ts \| sort -u) <(rg -o '\\w+:' <email-root>/<template>/labels.<locale>.ts \| sort -u)` (output should be empty) |
|
|
357
387
|
| Sender resolves template by typed id | `rg -n "EmailTemplateType\.[A-Z_]+" backend-api/src/modules/<module>/` |
|
|
@@ -374,7 +404,8 @@ second guarantees the registry is the integration seam.
|
|
|
374
404
|
| "Custom `<div>` layout is fine, my mail client renders it" | Inbox rendering varies wildly across Gmail / Outlook / Apple Mail. React Email primitives are inlined-CSS-tested against the major clients; raw HTML is not. |
|
|
375
405
|
| "Use the app's `<Button>` component for consistency" | Email compiles in a separate bundle without React DOM context. App components pull browser-only globals that fail at render. Use React Email's `<Button>`. |
|
|
376
406
|
| "Import the template directly in the sender — fewer indirection" | The registry is the integration seam for tooling (companion preview, audit, dispatch service). Direct imports bypass it and break the typed-id contract. |
|
|
377
|
-
| "English-only labels for now" | Missing locale coverage warns at startup; runtime may fall back to another language.
|
|
407
|
+
| "English-only labels for now" | Missing locale coverage warns at startup; runtime may fall back to another language. Run `wildo generate translate` and preview each enabled locale, including regional base-language fallback, rather than treating fallback as coverage. |
|
|
408
|
+
| "I'll fix the French wording directly in `labels.fr.ts`" | That file is generated: the next `wildo generate translate` overwrites it (the lock sees the edit as drift). Fix the primary file's wording or its context (the template `description`, the system email specification) and re-run `wildo generate translate`. |
|
|
378
409
|
| "Hard-code the brand color, the company won't change it" | The same template renders across white-label tenants and themed environments. Brand context flows through props — read it, don't hard-code it. |
|
|
379
410
|
|
|
380
411
|
## Red Flags
|
|
@@ -401,11 +432,17 @@ second guarantees the registry is the integration seam.
|
|
|
401
432
|
renders correctly across environments)
|
|
402
433
|
- New label keys committed without a translation rerun (Step 6
|
|
403
434
|
silently skipped — non-primary locales fall back to source-locale)
|
|
435
|
+
- A non-primary `labels.<locale>.ts` without the DO-NOT-EDIT header
|
|
436
|
+
(hand-written, or hand-edited and about to be overwritten — catch
|
|
437
|
+
with the **Other-locale files are the generated ones** grep)
|
|
438
|
+
- A primary labels value that is not a string literal (a number,
|
|
439
|
+
concatenation or template literal): the translator refuses that
|
|
440
|
+
email and names it as `failed` in `wildo generate translate`
|
|
404
441
|
|
|
405
442
|
## Related Skills
|
|
406
443
|
|
|
407
444
|
- `i18n-rerun-pipeline` — translation pipeline orchestrator (Step 6 trigger after new label keys)
|
|
408
445
|
- `i18n-translation-rerun` — translate non-primary locales (the dedicated leaf)
|
|
409
|
-
- `i18n-label-generation` — app-wide UI label generation (engine-owned `customLabels` slot via `scanCustomLabelsDirectory`; email labels are
|
|
446
|
+
- `i18n-label-generation` — app-wide UI label generation (engine-owned `customLabels` slot via `scanCustomLabelsDirectory`; email labels are template-colocated, authored in the primary locale and translated by the email lane of `wildo generate translate`, and are not swept by that scanner)
|
|
410
447
|
- `backend-addon-wiring` — module-level `emailTemplateDefinitions` slot (the registry feeds into this)
|
|
411
448
|
- `notifications_in_app` — in-app notifications (separate dispatch surface)
|
|
@@ -56,10 +56,13 @@ so run them from the SaaS application root with its companion reachable. Runtime
|
|
|
56
56
|
| `wildo generate email preview --template <ref> --locale <locale>` | renders one |
|
|
57
57
|
| `wildo generate email test-send --template <ref> --locale <locale> --to <recipient>` | runs the configured sending path for one recipient |
|
|
58
58
|
| `wildo generate email status` | lists which template artifacts exist on disk |
|
|
59
|
-
| `wildo generate email translate --templates <ref> --locales <locale>` | translates selected templates into selected locales |
|
|
59
|
+
| `wildo generate email translate --templates <ref> --locales <locale>` | translates selected templates into selected locales (the same lane `wildo generate translate` runs for every template) |
|
|
60
60
|
|
|
61
61
|
`translate` is what makes a second language cheap: the authored specification beside each system
|
|
62
|
-
email
|
|
62
|
+
email, and every template's own `description`, give the translator the purpose and tone of the
|
|
63
|
+
message rather than a bare string to guess at. `wildo generate translate` runs it for every template
|
|
64
|
+
whose primary words changed or whose generated file drifted; the generated `labels.<locale>.ts` files
|
|
65
|
+
carry a DO-NOT-EDIT header, and a hand edit to one is overwritten by the next run.
|
|
63
66
|
|
|
64
67
|
Startup checks primary-locale system-template coverage and secondary enabled-locale coverage across every registered ref. Missing coverage produces warnings, not a send-time hard refusal. Exact locale and base-language labels count as coverage: `fr` covers `fr-CA`. Falling back to the configured fallback or primary language does not satisfy secondary-locale coverage.
|
|
65
68
|
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: email-definition-wiring
|
|
3
3
|
description: Redirect stub → `email-add-template` owns email registry/definition wiring end to end. Use when the user says "register an email template", "email definition wiring", "module-email-template-definitions", "EmailTemplateType", or "move a template between modules" — this stub only routes to the orchestrator (its Step 4 carries the workflow).
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Email Definition Wiring → see `email-add-template`
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: email-labels-authoring
|
|
3
3
|
description: Redirect stub → `email-add-template` owns email per-locale label authoring. Use when the user says "email labels", "labels.<locale>.ts", "TLabels interface", "per-locale email keys", or "subject as label" — this stub only routes to the orchestrator (its Step 3 carries the workflow).
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Email Labels Authoring → see `email-add-template`
|
|
@@ -43,7 +44,7 @@ is the high-signal drift check.
|
|
|
43
44
|
2. You did NOT copy the workflow into this stub or re-author it
|
|
44
45
|
elsewhere — the canonical orchestrator stays the single source of
|
|
45
46
|
truth.
|
|
46
|
-
3. A `labels.<locale>.ts` file exists for every supported locale — `ls backend-api/src/engine/email/<template>/labels.*.ts` lists one entry per locale.
|
|
47
|
+
3. A `labels.<locale>.ts` file exists for every supported locale — `ls backend-api/src/engine/email/<template>/labels.*.ts` lists one entry per locale. Only the primary-locale file is authored; `wildo generate translate` writes the others.
|
|
47
48
|
4. Every locale shares the same key set — `comm -23 <(rg -o '\w+:' backend-api/src/engine/email/<template>/labels.<primary>.ts | sort -u) <(rg -o '\w+:' backend-api/src/engine/email/<template>/labels.<other>.ts | sort -u)` returns empty.
|
|
48
49
|
|
|
49
50
|
## Red Flags
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: email-template-authoring
|
|
3
3
|
description: Redirect stub → `email-add-template` owns email template JSX authoring. Use when the user says "email template JSX", "React Email template", "EmailTemplateDefinition", "template.tsx", or "subject vs body purity" — this stub only routes to the orchestrator (its Step 2 carries the workflow).
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Email Template Authoring → see `email-add-template`
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: engine-component-registration
|
|
3
3
|
description: Register frontend components in the framework `FrontendComponentRegistration[]` array so resource UI behavior, view configurations, and component specs resolve custom components by stable `componentRef`. Use when the user says "register a custom component", "wire a custom dashboard component", "the component is not found at runtime", "swap the default preset for our app component", "register a lazy-loaded view component", or any change that introduces a new app-owned component reference consumed via string `componentRef`.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Engine Component Registration
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: engine-product-definitions
|
|
3
3
|
description: Author and maintain engine-level product definition registries — feature identifiers (`ApplicationFeature` enum), feature definitions (`CUSTOM_FEATURE_DEFINITIONS`), feature profiles (`FEATURE_PROFILES`), unavailability policy (`CUSTOM_UNAVAILABILITY_POLICY`), and the parallel role / milestone definition collections. Use when the user says "add a new feature flag", "define a tier profile", "wire an addon-prompt feature", "the feature shows but isn't gated", "add a milestone definition", "register a new role definition", or any change to the runtime product / feature / role / milestone taxonomy that complements the spec layer.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Engine Product Definitions
|
|
@@ -156,6 +157,11 @@ surfaces don't see the new identifier. Use `spec-feature-update`
|
|
|
156
157
|
- The selected profile or product grants the feature
|
|
157
158
|
- Protected backend operation variants declare `requiredFeatures`
|
|
158
159
|
- Frontend presentation uses the same identifier under the normal provider tree
|
|
160
|
+
- The feature's WORDS are generated: every declared definition is worded by the labelling pipeline
|
|
161
|
+
(`wildo generate labels`, then `wildo generate translate`), an on/off feature under
|
|
162
|
+
`billing_features.<id>` and a limit under `billing_limits.<id>`, whether or not a product grants it.
|
|
163
|
+
Until then the Entitlements screen and a product's grants show the identifier, and a limit of `-1`
|
|
164
|
+
shows as unlimited. Generate the words; never rename the identifier to read better.
|
|
159
165
|
|
|
160
166
|
## Three separate decisions
|
|
161
167
|
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: flows-actors-a2a-exposure
|
|
3
3
|
description: Expose your app's actor systems to EXTERNAL AI agents over the Agent2Agent (A2A) protocol, so other agents can discover and converse with them. Use when the user says "expose my actor as an A2A agent", "let other AI agents call my assistant", "agent2agent", "A2A endpoint", "expose an agent to external agents", "machine / client-credentials access to my chat agent", "how do external agents authenticate to my actor system", or "agent card" — i.e. the intent is EXTERNAL agent-to-agent access, NOT the in-app chat view and NOT exposing resource CRUD as tools (that is MCP).
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Expose an Actor System over Agent2Agent (A2A) — Workflow
|
|
@@ -198,7 +199,6 @@ const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
|
198
199
|
// live 2026-07-16) — model defaults rule.
|
|
199
200
|
accessControl: [{
|
|
200
201
|
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
201
|
-
requiresApproval: false,
|
|
202
202
|
}],
|
|
203
203
|
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
204
204
|
},
|
|
@@ -228,6 +228,8 @@ const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
|
228
228
|
'Use resource.todos.read to look up the user\'s todos (pass a searchQuery when a topic is named); use resource.todoLists.read for lists/grouping. Reference concrete item titles.',
|
|
229
229
|
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first — pass `id` when the user already gave one, or a searchQuery naming its title — then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
230
230
|
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted. Read its outcome and health notes before answering: only a healthy nothing-matched result permits saying the search found no matching passages. Report unavailable or incomplete retrieval honestly; never turn missing sources into a claim that information does not exist.',
|
|
231
|
+
'To COPY an existing todo into a list (when the user asks to copy a task or do it again), resolve the todo id with resource.todos.read and the list id with resource.todoLists.read, then call resource.todos.duplicate; confirm the new todo\'s title and list.',
|
|
232
|
+
'To DELETE a todo (only when explicitly asked), resolve its id with resource.todos.read, then call resource.todos.delete with that id. An organization administrator must approve the deletion and the user cannot approve it themselves: call the tool, then tell the user it is waiting for an administrator. Do not ask for confirmation in prose first.',
|
|
231
233
|
'To CREATE a todo (only when explicitly asked), you MUST supply a todoListId: if the user names a list, resolve its id with resource.todoLists.read first; if they name none and have exactly one list, use it; if they have several and none is specified, ask which one. Then call resource.todos.create with the title (plus any description/priority/status/dueDate the user gave) and confirm the created title.',
|
|
232
234
|
],
|
|
233
235
|
},
|
|
@@ -243,6 +245,12 @@ const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
|
243
245
|
// provider, by meaning) out of the organization's reference documents, including the text of
|
|
244
246
|
// uploaded files that no row query can reach.
|
|
245
247
|
KNOWLEDGE_BASE_ASK_TOOL_REF,
|
|
248
|
+
// Hand-written, ADDITIVE write: copies a todo into a list. Not approval-gated for the same
|
|
249
|
+
// reason `resource.todos.create` is not — the result is a new row the user can simply delete.
|
|
250
|
+
DUPLICATE_TODO_TOOL_REF,
|
|
251
|
+
// Hand-written and REVIEWER-routed (#1594): an organization administrator other than the person
|
|
252
|
+
// asking approves it. See `./delete-todo-tool.ts`.
|
|
253
|
+
DELETE_TODO_TOOL_REF,
|
|
246
254
|
],
|
|
247
255
|
mcpRefs: [],
|
|
248
256
|
},
|
|
@@ -263,7 +271,6 @@ const todoAssistantActorSystem: ActorSystem = {
|
|
|
263
271
|
timeout: 60000,
|
|
264
272
|
accessControl: [{
|
|
265
273
|
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
266
|
-
requiresApproval: false,
|
|
267
274
|
}],
|
|
268
275
|
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
269
276
|
},
|
|
@@ -277,16 +284,22 @@ const todoAssistantActorSystem: ActorSystem = {
|
|
|
277
284
|
createdAt: '2026-07-12T00:00:00.000Z',
|
|
278
285
|
};
|
|
279
286
|
|
|
287
|
+
|
|
280
288
|
// Export with consistent naming convention matching resources registry pattern
|
|
281
289
|
export const moduleBackend_FlowsActorsRegistry: {
|
|
282
290
|
flowActorSystemsFactoryMap: FlowActorSystem_InitializationFactoryMap;
|
|
283
291
|
agents: FlowsActors_Agent[];
|
|
284
292
|
functionTools?: FunctionTool[];
|
|
293
|
+
autonomousAgents?: FlowsActors_AutonomousAgentDeclaration[];
|
|
285
294
|
} = {
|
|
286
295
|
flowActorSystemsFactoryMap: {
|
|
287
296
|
[TODO_ASSISTANT_SYSTEM_REF]: () => todoAssistantActorSystem,
|
|
297
|
+
[TODO_TRIAGE_SYSTEM_REF]: () => todoTriageActorSystem,
|
|
298
|
+
// The decision-deadline drill (#1866): BACKEND_ONLY, inert unless an organization binds a client to it.
|
|
299
|
+
[TODO_DEADLINE_DRILL_SYSTEM_REF]: () => todoDeadlineDrillActorSystem,
|
|
288
300
|
},
|
|
289
|
-
agents: [todoAssistantChatAgent],
|
|
301
|
+
agents: [todoAssistantChatAgent, todoTriageAgent, todoDeadlineDrillAgent],
|
|
302
|
+
autonomousAgents: [todosOverdueTriage, todosDeadlineDrill],
|
|
290
303
|
// Generic engine factories instantiated per resource — every tool runs AS THE
|
|
291
304
|
// CALLER (the engine rebuilds a scoped ExecutionContext from the caller's verified
|
|
292
305
|
// auth; identity is never LLM-supplied) and each op's own ACL is enforced by the
|
|
@@ -353,6 +366,17 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
353
366
|
// from the caller's verified socket auth, so the agent reaches the corpus through exactly the
|
|
354
367
|
// feature an HTTP client reaches, with exactly the same roles. See `./knowledge-base-tool.ts`.
|
|
355
368
|
knowledgeBaseAskTool,
|
|
369
|
+
// A hand-written WRITE: reads the source todo and creates the copy, both through
|
|
370
|
+
// `dispatchResourceOperationAsTool` as the caller. See `./duplicate-todo-tool.ts`.
|
|
371
|
+
duplicateTodoTool,
|
|
372
|
+
// A hand-written DESTRUCTIVE write routed to a REVIEWER rather than the person asking: it pauses the
|
|
373
|
+
// turn, the decision goes to the organization's administrators, and the delete then runs as the
|
|
374
|
+
// member who asked. See `./delete-todo-tool.ts`.
|
|
375
|
+
deleteTodoTool,
|
|
376
|
+
// The overdue-triage agent's one write, ROLE-gated to administrators (#1611). See `./reschedule-todo-tool.ts`.
|
|
377
|
+
rescheduleTodoTool,
|
|
378
|
+
// The deadline drill's four-minute reviewer-routed delete (#1866). See `./deadline-drill-agent.ts`.
|
|
379
|
+
drillDeleteTodoTool,
|
|
356
380
|
],
|
|
357
381
|
};
|
|
358
382
|
```
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: flows-actors-autonomous-agents
|
|
3
|
+
description: Run an agent in the background with nobody signed in — on a schedule, or when an inbound handler hands it a message — under a machine credential each organization grants it, with its writes reviewed by a person. Use when the user says "run this agent every morning", "schedule an agent", "an agent that works in the background", "triage X automatically and let an admin approve", "start an agent from a webhook / inbound email", "autonomous agent", "unattended agent", or "bind an agent to an OAuth client" — NOT an in-app chat (flows-actors-chat-assistant), NOT an external agent calling in (flows-actors-a2a-exposure), and NOT a one-shot call from your own code (flows-actors-llm-agent-invocation).
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Autonomous agents — Workflow
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
An autonomous agent is an actor system you already know how to build (a CHAT agent, its tools, an
|
|
24
|
+
ActorSystem) that runs with **nobody on a socket**: on a cron, or when an inbound handler hands it a
|
|
25
|
+
delivery. You add one declaration — `flowsActors.autonomousAgents` — and the engine does the rest:
|
|
26
|
+
it resolves the machine principal, keeps each occurrence to one turn, enforces concurrency and the token
|
|
27
|
+
budget, pauses reviewer-gated writes for a person, and re-checks the principal before a paused write runs.
|
|
28
|
+
|
|
29
|
+
Declaring an agent grants **nothing**. It runs in an organization only while an administrator of that
|
|
30
|
+
organization has **bound** one of its OAuth clients to the agent (or admits, on a service-provider
|
|
31
|
+
relationship, a firm's client bound to it). The turn's tools then act with that client's **current**
|
|
32
|
+
roles — never the application's own system authority, and there is no application-wide autonomous agent.
|
|
33
|
+
|
|
34
|
+
## App Paths
|
|
35
|
+
|
|
36
|
+
| Surface | Glob (relative to app root) |
|
|
37
|
+
|---|---|
|
|
38
|
+
| Agent, actor system, tools, declaration | `backend-api/src/modules/<module>/addons/flows-actors/*.ts` |
|
|
39
|
+
| Module assembly (`flowsActors.autonomousAgents`) | `backend-api/src/modules/<module>/index.ts` |
|
|
40
|
+
| Inbound handler that hands a message to the agent | `backend-api/src/modules/<module>/inbound/*.inbound-handler.ts` |
|
|
41
|
+
| Resource the agent reads and writes | `shared-lib/src/modules/<module>/resources/**/*.resources-config.ts` |
|
|
42
|
+
|
|
43
|
+
## When to Use
|
|
44
|
+
|
|
45
|
+
- Recurring work on each tenant's data that a person should approve rather than perform — triage,
|
|
46
|
+
follow-ups, reminders, reconciliations.
|
|
47
|
+
- An inbound message (email, webhook) that an agent should read and act on, with a reviewer before any
|
|
48
|
+
change.
|
|
49
|
+
|
|
50
|
+
## When NOT to Use
|
|
51
|
+
|
|
52
|
+
- A person chats with it → `flows-actors-chat-assistant`.
|
|
53
|
+
- Another system's agent calls yours → `flows-actors-a2a-exposure`.
|
|
54
|
+
- Your code needs one model answer inline → `flows-actors-llm-agent-invocation`.
|
|
55
|
+
- Deterministic work with no judgement → a `CRON_JOB` operation or a custom batch, not an agent.
|
|
56
|
+
|
|
57
|
+
## Workflow
|
|
58
|
+
|
|
59
|
+
1. **Build the actor system** as for a chat assistant (`flows-actors-chat-assistant`), but with
|
|
60
|
+
`visibility: BACKEND_ONLY` — nobody chats with it.
|
|
61
|
+
2. **Classify every tool the agent may call** (see `references/tool-posture.md`): reads declare
|
|
62
|
+
`effect: FunctionToolEffect.READ`; every write the agent may PROPOSE is gated on a REVIEWER —
|
|
63
|
+
`humanApproval: { route: ROLE | ASSIGNEE, eligibleRole }`. An OWNER-gated tool is denied on a machine
|
|
64
|
+
turn (there is no owner to ask), and an undeclared effect counts as a write.
|
|
65
|
+
3. **Declare the agent** on the module: `ref`, `systemRef`, the `instruction` (the application's words,
|
|
66
|
+
never the trigger's), `concurrency`, and a `schedule` if it runs on a cron. Read
|
|
67
|
+
`references/framework-autonomous-agent-api.md` for the contract.
|
|
68
|
+
4. **Or start it from an inbound handler** with `ctx.agents.startAutonomousTurn({ autonomousAgentRef,
|
|
69
|
+
input })` — the delivery id is the occurrence. See `references/framework-inbound-agents-api.md`.
|
|
70
|
+
5. **Tell administrators how to grant it**: under Settings → Organization → OAuth clients, create a client
|
|
71
|
+
with only the roles the agent needs, then run "set autonomous agents" on it (`setAutonomousAgents`). Keep
|
|
72
|
+
the `organization-oauth-clients` placement in `settings-hub.config.ts`, or that screen does not exist. Until
|
|
73
|
+
then every run in that organization is refused and recorded (`references/binding-and-review.md`).
|
|
74
|
+
6. Stop here; hand off to `inbound-channels` if the trigger is a message that is not wired yet.
|
|
75
|
+
|
|
76
|
+
## Worked Example
|
|
77
|
+
|
|
78
|
+
A todo application's overdue-triage agent: once a day, in each organization that bound a client to it, it
|
|
79
|
+
proposes a new due date for the most overdue todo. The declaration — note the instruction is declared,
|
|
80
|
+
the concurrency is `SKIP_IF_ACTIVE` so a proposal still waiting blocks the next run, and the schedule
|
|
81
|
+
lives on the declaration so the engine registers the batch itself:
|
|
82
|
+
|
|
83
|
+
|
|
84
|
+
## Usage Example
|
|
85
|
+
|
|
86
|
+
```typescript
|
|
87
|
+
/** The ref an administrator binds one of the organization's OAuth clients to. */
|
|
88
|
+
export const TODOS_OVERDUE_TRIAGE_AGENT_REF = 'todos.overdue-triage';
|
|
89
|
+
|
|
90
|
+
/** Registered on the tasks-manager module's `flowsActors.autonomousAgents`. */
|
|
91
|
+
export const todosOverdueTriage: FlowsActors_AutonomousAgentDeclaration = {
|
|
92
|
+
ref: TODOS_OVERDUE_TRIAGE_AGENT_REF,
|
|
93
|
+
// The actor system whose chat actor's agent runs — here `todo-triage`, with read tools and the
|
|
94
|
+
// reviewer-gated `resource.todos.reschedule`.
|
|
95
|
+
systemRef: TODO_TRIAGE_SYSTEM_REF,
|
|
96
|
+
// Declared here, never taken from the trigger.
|
|
97
|
+
instruction: 'Review this organization\'s overdue todos and propose a new due date for the most overdue one.',
|
|
98
|
+
// A proposal still waiting for an administrator blocks the next morning's run: one open question at a time.
|
|
99
|
+
concurrency: AutonomousAgentConcurrency.SKIP_IF_ACTIVE,
|
|
100
|
+
// The engine registers the batch `autonomous-agent.todos.overdue-triage` from this.
|
|
101
|
+
schedule: { cronJobExpression: '0 7 * * *' },
|
|
102
|
+
};
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
The one write it proposes is ROLE-gated to administrators and declares its effect, so it is offered to
|
|
106
|
+
the agent and paused for a reviewer:
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
## Usage Example
|
|
110
|
+
|
|
111
|
+
```typescript
|
|
112
|
+
export const rescheduleTodoTool: FunctionTool = {
|
|
113
|
+
functionRef: RESCHEDULE_TODO_TOOL_REF,
|
|
114
|
+
// A WRITE gated on a REVIEWER: offered to an autonomous turn, and paused there for an administrator.
|
|
115
|
+
effect: FunctionToolEffect.WRITE,
|
|
116
|
+
description:
|
|
117
|
+
'Propose a new due date for one overdue todo. An organization administrator must approve the change before '
|
|
118
|
+
+ 'it is applied. Resolve the todo id with resource.todos.read first.',
|
|
119
|
+
inputSchema: z.object({
|
|
120
|
+
todoId: z.string().min(1).describe('Id of the todo to reschedule. Resolve it with resource.todos.read.'),
|
|
121
|
+
dueDate: z.string().min(1).describe('The proposed due date, as an ISO 8601 date, e.g. "2026-10-04".'),
|
|
122
|
+
}),
|
|
123
|
+
humanApproval: {
|
|
124
|
+
route: HumanDecision_RouteKind.ROLE,
|
|
125
|
+
eligibleRole: CORE_ORG_ROLES.ORG_ADMIN,
|
|
126
|
+
},
|
|
127
|
+
execute: async (args: { todoId: string; dueDate: string }, ctx: FunctionToolExecutionContext): Promise<RescheduleTodoToolResult> => {
|
|
128
|
+
const dueDate = new Date(args.dueDate);
|
|
129
|
+
if (Number.isNaN(dueDate.getTime())) throw new Error(`"${args.dueDate}" is not a date.`);
|
|
130
|
+
await dispatchResourceOperationAsTool({
|
|
131
|
+
ctx,
|
|
132
|
+
resourceType: TasksManager_ResourceType.TODOS,
|
|
133
|
+
operationIdentifier: CoreResourceOperation.UPDATE,
|
|
134
|
+
recordId: args.todoId,
|
|
135
|
+
data: { dueDate },
|
|
136
|
+
contextIds: ctx.organizationId ? { organizationId: ctx.organizationId } : {},
|
|
137
|
+
});
|
|
138
|
+
return { todoId: args.todoId, dueDate: dueDate.toISOString() };
|
|
139
|
+
},
|
|
140
|
+
};
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
## References
|
|
144
|
+
|
|
145
|
+
- `references/framework-autonomous-agent-api.md` — source-backed: the declaration, the schedule helper and the vocabulary (principal sources, triggers, concurrency, refusal reasons).
|
|
146
|
+
- `references/framework-inbound-agents-api.md` — source-backed: `ctx.agents` on an inbound handler.
|
|
147
|
+
- `references/tool-posture.md` — decision table: which tools a turn is offered, and why.
|
|
148
|
+
- `references/binding-and-review.md` — how an organization grants an agent, what a reviewer sees, and every refusal.
|
|
149
|
+
|
|
150
|
+
## Verification
|
|
151
|
+
|
|
152
|
+
- [ ] Every declared `systemRef` names a registered ACTOR system — startup refuses otherwise.
|
|
153
|
+
- [ ] Every write tool in the agent's `functionRefs` has a ROLE or ASSIGNEE `humanApproval` (`rg -n "humanApproval" backend-api/src/modules/<module>/addons/flows-actors`).
|
|
154
|
+
- [ ] Every read tool declares `effect: FunctionToolEffect.READ` or comes from `resourceReadTool` (`rg -n "effect:" backend-api/src/modules/<module>/addons/flows-actors`).
|
|
155
|
+
- [ ] The declaration is registered on a module's `flowsActors.autonomousAgents` (`rg -n "autonomousAgents" backend-api/src/modules`).
|
|
156
|
+
- [ ] No `instruction` interpolates trigger content — data goes in `input` (`rg -n "instruction:" backend-api/src/modules`).
|
|
157
|
+
|
|
158
|
+
## Common Rationalizations
|
|
159
|
+
|
|
160
|
+
| Rationalization | Reality |
|
|
161
|
+
|---|---|
|
|
162
|
+
| "I'll run it under the system context, it's our own code." | System authority reaches every tenant. The agent acts only as a client its organization bound, with that client's roles. |
|
|
163
|
+
| "I'll give the bound client an admin role so it never gets refused." | The roles are the agent's whole authority. A reviewer approves one proposal; the roles decide everything else the turn can do. |
|
|
164
|
+
| "An OWNER gate is enough, someone will approve." | A machine turn has no owner. The call is denied. Route it to a reviewer (ROLE or ASSIGNEE). |
|
|
165
|
+
| "I'll put the message text into the instruction." | Inbound content is data. Put it in `input`; the instruction is yours, fixed at declaration. |
|
|
166
|
+
| "I'll dedupe runs myself." | The execution id is derived from agent, organization and occurrence: the same occurrence twice is one turn already. |
|
|
167
|
+
| "ALLOW_CONCURRENT is simpler." | Two runs racing on the same tenant raise overlapping proposals for the same reviewer. Use it only when turns are independent. |
|
|
168
|
+
|
|
169
|
+
## Red Flags
|
|
170
|
+
|
|
171
|
+
- A write tool with no `humanApproval` in an autonomous agent's `functionRefs` — catch with the `humanApproval` grep above.
|
|
172
|
+
- A hand-written read tool without `effect` — it is withheld from inbound-triggered turns; catch with the `effect:` grep above.
|
|
173
|
+
- An `instruction` built from payload fields — catch with the `instruction:` grep above.
|
|
174
|
+
- A declaration that is written but not on any module — catch with the `autonomousAgents` grep above.
|
|
175
|
+
|
|
176
|
+
## Related Skills
|
|
177
|
+
|
|
178
|
+
- `flows-actors-chat-assistant` — the agent, system and tools this builds on (orchestrator for flows-actors).
|
|
179
|
+
- `inbound-channels` — the handler that hands a delivery to the agent.
|
|
180
|
+
- `flows-actors-a2a-exposure` — the other machine door, where an external caller starts the turn.
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# Granting an autonomous agent, reviewing it, and why a run was refused
|
|
2
|
+
|
|
3
|
+
## How an organization grants an agent
|
|
4
|
+
|
|
5
|
+
1. An administrator creates an OAuth client in their organization with ONLY the roles the agent needs
|
|
6
|
+
(the roles are the agent's whole authority there). No redirect URIs, no grants are required.
|
|
7
|
+
2. They run `setAutonomousAgents` on that client with the agent refs it should run.
|
|
8
|
+
|
|
9
|
+
Both steps have a screen: Settings → Organization → OAuth clients, the `organization-oauth-clients` settings
|
|
10
|
+
destination, which a new application's `settings-hub.config.ts` already places beside API keys. The binding
|
|
11
|
+
action offers exactly the agents the application declares (read from `/flows-actors/frontend-info`), so an
|
|
12
|
+
administrator picks rather than types a ref. If your application removed that placement, put it back, or
|
|
13
|
+
administrators can only bind over the REST operation.
|
|
14
|
+
3. At most one client of the organization may run a given agent. Remove it from one client before
|
|
15
|
+
giving it to another. Removing always works, whatever state the client is in.
|
|
16
|
+
4. Deactivating, expiring or deleting the client stops the agent, including proposals still waiting.
|
|
17
|
+
|
|
18
|
+
A service firm's client can also run an agent in a CLIENT organization. It takes both sides:
|
|
19
|
+
|
|
20
|
+
- the firm binds the agent to its own client (`setAutonomousAgents`);
|
|
21
|
+
- the client organization admits that client on its service-provider relationship AND chooses which of the
|
|
22
|
+
firm's agents may run there: `admitMachineClient` with `autonomousAgentRefs`. Omitted means none, and
|
|
23
|
+
re-admitting with a new list replaces the choice.
|
|
24
|
+
|
|
25
|
+
So a firm adding an agent to its client never starts it in a client organization that did not choose it.
|
|
26
|
+
The agent acts there with the relationship's role, never with the client's roles in the firm, and on the
|
|
27
|
+
client organization's token budget. The client ends it by removing the agent from its choice or removing
|
|
28
|
+
the admission.
|
|
29
|
+
|
|
30
|
+
Both directions are recorded: `AUTONOMOUS_AGENT_BOUND` / `AUTONOMOUS_AGENT_UNBOUND`, in every organization
|
|
31
|
+
where the agent starts or stops being able to act — a change on one side that the other side has not
|
|
32
|
+
matched records nothing, because nothing changed.
|
|
33
|
+
|
|
34
|
+
## What a reviewer sees
|
|
35
|
+
|
|
36
|
+
The proposal is an ordinary routed decision in their inbox: the tool, its arguments, and the organization.
|
|
37
|
+
The requester is the machine credential, so no person can be "the requester" who is excluded — every holder
|
|
38
|
+
of the route's role may answer. The approved write's audit row names the machine (`actorKind` MACHINE,
|
|
39
|
+
`principalCredentialId`), the agent (`agentActor`, with the decision) and the reviewer who decided.
|
|
40
|
+
|
|
41
|
+
## Why a run was refused
|
|
42
|
+
|
|
43
|
+
Every refusal records `AUTONOMOUS_AGENT_TURN_REFUSED` and opens nothing. A repeated occurrence is not a
|
|
44
|
+
refusal; it is answered as already started.
|
|
45
|
+
|
|
46
|
+
| Reason | Meaning | What to do |
|
|
47
|
+
|---|---|---|
|
|
48
|
+
| `agent_not_declared` | No declaration with this ref | Fix the ref or declare the agent |
|
|
49
|
+
| `no_principal` | No active, unexpired, operator-created client is bound here, or admitted here for this agent | Bind one, reactivate it, or choose the agent on the firm client's admission |
|
|
50
|
+
| `ambiguous_principal` | Two clients resolve — e.g. an own client and an admitted firm client both run it | Unbind one; the engine never chooses |
|
|
51
|
+
| `organization_inactive` | The organization is suspended or being deleted | Nothing: an inactive tenant runs no agents |
|
|
52
|
+
| `principal_unverifiable` | The bindings could not be read | Transient; the next occurrence retries |
|
|
53
|
+
| `over_budget` | The organization's agent token budget is spent or unverifiable | Raise the allowance or wait for the next period |
|
|
54
|
+
| `already_active` | `SKIP_IF_ACTIVE`, and a turn is still running or waiting for a reviewer | Answer the waiting decision |
|
|
55
|
+
| `case_not_readable` | The case named for the turn cannot be read by the agent's principal | Give the client the role, or name another case |
|
|
56
|
+
| `runtime_refused` | The actor system could not open a turn (no chat actor, missing input) | A configuration defect; read `runtimeErrorCode` |
|