@wildo-ai/framework-knowledge 1.1.9 → 1.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
- 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 +543 -80
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
- 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 +138 -21
- 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.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/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.js +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +17 -9
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -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 +89 -9
- 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 +6 -5
- 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 +6 -4
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -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 +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- 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 +8 -4
- 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 +28 -6
- 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 +23 -5
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +14 -6
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +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-conception/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
- 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 +34 -7
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -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 +14 -6
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
- 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 +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- 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 +15 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- 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/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +497 -32
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-maturity.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-choice.config.md +20 -3
- package/dist/knowledge/references/brand.name-screening.config.md +58 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
- package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +76 -7
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/integration-plan.config.md +21 -1
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +107 -2
- package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
- package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
- package/dist/knowledge/references/platform.config.saas.md +106 -14
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +84 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
- package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
- package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
- package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
- package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
- package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +270 -0
- package/dist/knowledge/references/website-plan.config.md +561 -23
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
- package/dist/knowledge/references/zod.factories.code.md +18 -8
- package/dist/knowledge/references/zod.factories.duration.md +23 -13
- package/dist/knowledge/references/zod.factories.money.md +24 -14
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +2854 -246
- package/dist/knowledge/registries/playbooks.json +57 -36
- package/dist/knowledge/registries/source-tags.json +8863 -4569
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +63 -34
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
- package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
- package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
- package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17305 -8263
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
|
@@ -0,0 +1,340 @@
|
|
|
1
|
+
# Decision-notice handler API
|
|
2
|
+
|
|
3
|
+
The contract an application declares to post a pending decision's cards where people work, and to take them back.
|
|
4
|
+
|
|
5
|
+
Read this when:
|
|
6
|
+
- declaring `humanDecisionNoticeHandler` on a backend module;
|
|
7
|
+
- writing the handler's POST and WITHDRAW branches by hand (a vendor without a ready-made helper);
|
|
8
|
+
- checking what a recipient, a chat account, a personal conversation or a recorded card carries;
|
|
9
|
+
- deciding whether to post to a recipient (`humanDecisionNoticeRecipientHandled`), so a retry and several vendors'
|
|
10
|
+
helpers in one handler each give a person one card.
|
|
11
|
+
|
|
12
|
+
## Import Origins
|
|
13
|
+
|
|
14
|
+
- `@wildo-ai/saas-backend-lib`
|
|
15
|
+
|
|
16
|
+
## Source Excerpts
|
|
17
|
+
|
|
18
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
19
|
+
|
|
20
|
+
```typescript
|
|
21
|
+
/**
|
|
22
|
+
* The decision-notice handler (#2664 S5b): how an application tells the people who may answer a pending human decision
|
|
23
|
+
* about it where they already work — a Slack message with buttons, a Teams card — and takes the message back once the
|
|
24
|
+
* decision is settled or moves to someone else.
|
|
25
|
+
*
|
|
26
|
+
* ## Who decides what
|
|
27
|
+
*
|
|
28
|
+
* The ENGINE decides when a notice is owed and when it is owed back, from the decisions themselves (a reconcile over
|
|
29
|
+
* every decision plane, so a crash loses nothing), and who it is for: the people who may ANSWER the decision now, by the
|
|
30
|
+
* decision's own predicate, each with the chat accounts they linked in the decision's organization. The APPLICATION
|
|
31
|
+
* decides how a card looks and where it goes, through its provider operations (`ctx.providers`), and reports each card
|
|
32
|
+
* it posts (`ctx.posted.record`) so the engine can hand it back for the withdraw.
|
|
33
|
+
*
|
|
34
|
+
* ## One handler, two kinds
|
|
35
|
+
*
|
|
36
|
+
* An application declares at most one handler (`BackendDomainModule.humanDecisionNoticeHandler`; startup refuses two).
|
|
37
|
+
* It is called with a POST notice when a decision's cards are owed and with a WITHDRAW notice when they are owed back.
|
|
38
|
+
* The withdraw is the same stay's next step, so it never runs before the post it withdraws, and it carries every card
|
|
39
|
+
* the post recorded that still stands. A WITHDRAW may also carry only SOME cards, with `decisionEnded: false`, while the
|
|
40
|
+
* decision still waits: those of readers who may no longer answer it (#2756: the record unshared from their
|
|
41
|
+
* relationship, the relationship suspended or re-scoped, the eligible role lost).
|
|
42
|
+
*
|
|
43
|
+
* ## At least once
|
|
44
|
+
*
|
|
45
|
+
* A notice is delivered at least once per step. A handler that throws is retried with backoff, and gives up after its
|
|
46
|
+
* attempts (the notice goes DEAD and an operator can replay it); the decision itself is never affected. A retry receives
|
|
47
|
+
* the cards already recorded (`ctx.posted.already`), so it posts only to the recipients still owed one. Record each card
|
|
48
|
+
* as soon as it is posted, not at the end.
|
|
49
|
+
*
|
|
50
|
+
* ## Words
|
|
51
|
+
*
|
|
52
|
+
* A notice carries references, never words: `notice.wording` (a POST: the card's title, description and buttons) and
|
|
53
|
+
* `notice.settled` (a WITHDRAW: what a taken-back card says). `ctx.words(phrase, language)` words them in a recipient's
|
|
54
|
+
* language from the application's own label tree, so a chat card says what the inbox says. The same call words any key
|
|
55
|
+
* of the application's tree (`ctx.words('components.MY_COMPONENT.openInApp', language)`), for what the handler adds.
|
|
56
|
+
*
|
|
57
|
+
* ## What the handler can reach
|
|
58
|
+
*
|
|
59
|
+
* Only `ctx.providers`, as its own principal: the decision's organization, organization-wide, with no roles. It may
|
|
60
|
+
* spend the application's provider connection and that organization's, never a person's. It gets no `resources` (a
|
|
61
|
+
* notice writes nothing of the application's) and no `chat` (a notice has no chat sender). Least privilege: nothing a
|
|
62
|
+
* notice needs is beyond that.
|
|
63
|
+
*/
|
|
64
|
+
import type { ExternalProvider_ConnectionTarget, ProviderOperationExecute } from '@wildo-ai/external-connectors-models';
|
|
65
|
+
import type { AvailableLanguage } from '@wildo-ai/presets-components-models';
|
|
66
|
+
import type { HumanDecision_Outcome, HumanDecision_Plane, HumanDecisionCardWording, HumanDecisionNoticePostedEntry, HumanDecisionPhrase } from '@wildo-ai/saas-models';
|
|
67
|
+
import { HumanDecision_SentCardContent } from '@wildo-ai/saas-models';
|
|
68
|
+
import type { HumanDecisionNoticeCard } from './human-decision-notice-source.backend.port';
|
|
69
|
+
|
|
70
|
+
/** Which step of a stay's notice a call is. */
|
|
71
|
+
export enum HumanDecisionNoticeKind {
|
|
72
|
+
/** The decision's cards are owed: post one to each recipient. */
|
|
73
|
+
POST = 'post',
|
|
74
|
+
/**
|
|
75
|
+
* Replace or delete the cards `notice.posted` carries: every card that still stands when the decision was settled or
|
|
76
|
+
* moved to other people, or only the cards of readers who may no longer answer it while it still waits (#2756).
|
|
77
|
+
*/
|
|
78
|
+
WITHDRAW = 'withdraw',
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* A personal conversation a bot can post to the recipient in, without their writing first (#2664 S5b; Microsoft Teams),
|
|
83
|
+
* recorded by the engine from an activity they sent that bot. A recipient has none until such an activity arrives after
|
|
84
|
+
* they linked; a handler then starts the personal chat itself (Teams: `create_conversation` with the person's Entra
|
|
85
|
+
* object id and the global service URL).
|
|
86
|
+
*/
|
|
87
|
+
export interface HumanDecisionNoticePersonalConversation {
|
|
88
|
+
/** The connection of the bot this conversation is with: pass it as the provider call's connection. */
|
|
89
|
+
readonly connection: ExternalProvider_ConnectionTarget;
|
|
90
|
+
readonly conversationId: string;
|
|
91
|
+
/** Where the vendor takes messages for this conversation (the Bot Connector's `serviceUrl`). */
|
|
92
|
+
readonly serviceUrl: string;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** One chat account a recipient linked in the decision's organization (`chatIdentityLinks`). */
|
|
96
|
+
export interface HumanDecisionNoticeChatAccount {
|
|
97
|
+
/** The provider connection the bot runs on: which vendor this account is at. */
|
|
98
|
+
readonly connectionRef: string;
|
|
99
|
+
/** The vendor's workspace or tenant (a Slack `team_id`, a Microsoft tenant id). */
|
|
100
|
+
readonly workspaceRef: string;
|
|
101
|
+
/** The vendor's own id for the person (a Slack user id, a Microsoft Entra object id). */
|
|
102
|
+
readonly chatUserId: string;
|
|
103
|
+
/** Their personal conversations with this vendor's bots, one per bot (the application's, the organization's). */
|
|
104
|
+
readonly personalConversations: readonly HumanDecisionNoticePersonalConversation[];
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/** A person who may answer the decision now, and where they can be reached. */
|
|
108
|
+
export interface HumanDecisionNoticeRecipient {
|
|
109
|
+
readonly userId: string;
|
|
110
|
+
/** The language they read: their preferences, filtered by what the application offers (as their emails are written). */
|
|
111
|
+
readonly language: AvailableLanguage;
|
|
112
|
+
/** Their chat accounts in the decision's organization. A recipient with none is listed, and cannot be reached by chat. */
|
|
113
|
+
readonly chatAccounts: readonly HumanDecisionNoticeChatAccount[];
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** What every notice names: the stay it is about. */
|
|
117
|
+
interface HumanDecisionNoticeBase {
|
|
118
|
+
/** The notice's id: the same on every retry of the same step, so a handler may key its own idempotency on it. */
|
|
119
|
+
readonly id: string;
|
|
120
|
+
readonly plane: HumanDecision_Plane;
|
|
121
|
+
readonly decisionRef: string;
|
|
122
|
+
readonly routeVersion: number;
|
|
123
|
+
/** The organization the decision is confined to; every recipient's chat accounts are linked in it. */
|
|
124
|
+
readonly organizationId: string;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/** The decision's cards are owed. */
|
|
128
|
+
export interface HumanDecisionNoticePost extends HumanDecisionNoticeBase {
|
|
129
|
+
readonly kind: HumanDecisionNoticeKind.POST;
|
|
130
|
+
/**
|
|
131
|
+
* The decision as everyone who may answer it would see it in the inbox. A tool approval's proposed arguments, and the
|
|
132
|
+
* values a held operation was asked with, are here only when the handler declares `includeToolArguments`.
|
|
133
|
+
*/
|
|
134
|
+
readonly card: HumanDecisionNoticeCard;
|
|
135
|
+
/** How the card reads, as the inbox words it (`describeHumanDecisionCard`): word each phrase with `ctx.words`. */
|
|
136
|
+
readonly wording: HumanDecisionCardWording;
|
|
137
|
+
readonly recipients: readonly HumanDecisionNoticeRecipient[];
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/** The decision's cards are owed back. */
|
|
141
|
+
export interface HumanDecisionNoticeWithdraw extends HumanDecisionNoticeBase {
|
|
142
|
+
readonly kind: HumanDecisionNoticeKind.WITHDRAW;
|
|
143
|
+
/**
|
|
144
|
+
* The cards to take back, each a POSTED entry, and (on a withdraw of the whole notice) every recipient it could not
|
|
145
|
+
* reach. A whole-notice withdraw carries every card that still stands; one taken back earlier from a reader who lost
|
|
146
|
+
* access is not carried again (#2756).
|
|
147
|
+
*/
|
|
148
|
+
readonly posted: readonly HumanDecisionNoticePostedEntry[];
|
|
149
|
+
/**
|
|
150
|
+
* True when the decision ended; false when it only moved to other people (claimed, reassigned, escalated), or, on a
|
|
151
|
+
* withdraw of some cards only, when it moved away from THESE readers, who may no longer answer it (#2756).
|
|
152
|
+
*/
|
|
153
|
+
readonly decisionEnded: boolean;
|
|
154
|
+
/** How it ended, when it ended and the engine can tell. */
|
|
155
|
+
readonly decisionOutcome?: HumanDecision_Outcome;
|
|
156
|
+
/** What a taken-back card says in place of its buttons (`describeHumanDecisionSettlement`): word it with `ctx.words`. */
|
|
157
|
+
readonly settled: HumanDecisionPhrase;
|
|
158
|
+
/** The language each recipient of a posted card reads, by user id. */
|
|
159
|
+
readonly recipientLanguages: Readonly<Record<string, AvailableLanguage>>;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
export type HumanDecisionNotice = HumanDecisionNoticePost | HumanDecisionNoticeWithdraw;
|
|
163
|
+
|
|
164
|
+
/** Values for a label's `{param}` placeholders. */
|
|
165
|
+
export type HumanDecisionNoticeWordParams = Readonly<Record<string, string | number>>;
|
|
166
|
+
|
|
167
|
+
/**
|
|
168
|
+
* `ctx.words`: a phrase of the notice, or any key of the application's label tree with its parameters, worded in
|
|
169
|
+
* `language`.
|
|
170
|
+
*/
|
|
171
|
+
export type HumanDecisionNoticeWords = (phrase: HumanDecisionPhrase | string, language: AvailableLanguage, params?: HumanDecisionNoticeWordParams) => string;
|
|
172
|
+
|
|
173
|
+
/** What a handler reports about one recipient's card. */
|
|
174
|
+
export interface HumanDecisionNoticePostedCard {
|
|
175
|
+
readonly recipientUserId: string;
|
|
176
|
+
/** The provider connection the card went through. */
|
|
177
|
+
readonly connectionRef?: string;
|
|
178
|
+
/** Where the card is, in the provider's own terms, so the withdraw can replace or delete it. */
|
|
179
|
+
readonly ref: Readonly<Record<string, string>>;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/** The cards of this notice, as far as they have been recorded. */
|
|
183
|
+
export interface HumanDecisionNoticePosted {
|
|
184
|
+
/**
|
|
185
|
+
* Every card and unreachable recipient recorded so far, by this attempt or an earlier one, through any connection.
|
|
186
|
+
* Ask `humanDecisionNoticeRecipientHandled(already, userId, connectionRef)` (from `@wildo-ai/saas-models`) before
|
|
187
|
+
* posting to someone: it passes over a person who already holds a card, and one this connection already tried.
|
|
188
|
+
*/
|
|
189
|
+
readonly already: readonly HumanDecisionNoticePostedEntry[];
|
|
190
|
+
/** Record one posted card. Persisted at once, so a retry after a failure later in the same call skips this recipient. */
|
|
191
|
+
record(card: HumanDecisionNoticePostedCard): Promise<void>;
|
|
192
|
+
/** Record that a recipient could not be reached (no personal chat can be opened with them, or they left the workspace). */
|
|
193
|
+
unreachable(recipientUserId: string, reason: string, connectionRef?: string): Promise<void>;
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
export interface HumanDecisionNoticeContext {
|
|
197
|
+
/** This call's attempt within the current step, from 1. */
|
|
198
|
+
readonly attempt: number;
|
|
199
|
+
/**
|
|
200
|
+
* How the handler calls a provider operation: what a generated typed client takes (`createSlackClient(ctx.providers)`).
|
|
201
|
+
* Each call names the connection it spends and is authorized as the notice: the application's connection, or the
|
|
202
|
+
* decision's organization's, never a person's.
|
|
203
|
+
*/
|
|
204
|
+
readonly providers: ProviderOperationExecute;
|
|
205
|
+
/** The cards recorded so far, and how to record more. Only meaningful on a POST; a WITHDRAW reads `notice.posted`. */
|
|
206
|
+
readonly posted: HumanDecisionNoticePosted;
|
|
207
|
+
/**
|
|
208
|
+
* A phrase of the notice (`notice.wording`, `notice.settled`), or any key of the application's label tree, worded in
|
|
209
|
+
* `language` from the application's labels. A missing label shows its key.
|
|
210
|
+
*/
|
|
211
|
+
readonly words: HumanDecisionNoticeWords;
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/** The retry an application may tune. */
|
|
215
|
+
export interface HumanDecisionNoticeRetry {
|
|
216
|
+
/** Attempts per step before the notice goes DEAD. Default 8. */
|
|
217
|
+
readonly maxAttempts?: number;
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
export interface HumanDecisionNoticeHandlerDefinition {
|
|
221
|
+
/** The handler's name, recorded on every provider call it makes. */
|
|
222
|
+
readonly ref: string;
|
|
223
|
+
/**
|
|
224
|
+
* Whether a card carries what its decision proposes: a tool approval's arguments, and the values a held operation
|
|
225
|
+
* was asked with (#2814). Off by default: they may hold what the person who raised the decision would not post into a
|
|
226
|
+
* chat, and a card that names the tool or the operation is enough to decide whether to open it.
|
|
227
|
+
*/
|
|
228
|
+
readonly includeToolArguments?: boolean;
|
|
229
|
+
readonly retry?: HumanDecisionNoticeRetry;
|
|
230
|
+
/** Post, or withdraw, one stay's cards. Throwing schedules a retry; the decision is never affected. */
|
|
231
|
+
handle(context: HumanDecisionNoticeContext, notice: HumanDecisionNotice): Promise<void>;
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* What this application's chat cards carry (#2814): without what the decision proposes (a tool approval's arguments, the
|
|
236
|
+
* values a held operation was asked with) unless the handler asks for them. Both are what someone wrote for one
|
|
237
|
+
* application, and neither is needed to decide whether to open the decision. Read by the dispatcher that posts
|
|
238
|
+
* the card and by the chat door, whose answers are sealed over exactly this (#2903 review F2).
|
|
239
|
+
*/
|
|
240
|
+
export function humanDecisionSentCardContentOf(handler: Pick<HumanDecisionNoticeHandlerDefinition, 'includeToolArguments'> | undefined): HumanDecision_SentCardContent {
|
|
241
|
+
return handler?.includeToolArguments ? HumanDecision_SentCardContent.COMPLETE : HumanDecision_SentCardContent.WITHOUT_PROPOSED_VALUES;
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/** Declare an application's decision-notice handler (`BackendDomainModule.humanDecisionNoticeHandler`). */
|
|
245
|
+
export function defineHumanDecisionNoticeHandler(definition: HumanDecisionNoticeHandlerDefinition): HumanDecisionNoticeHandlerDefinition {
|
|
246
|
+
return definition;
|
|
247
|
+
}
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
## Import Origins
|
|
251
|
+
|
|
252
|
+
- `@wildo-ai/saas-models`
|
|
253
|
+
|
|
254
|
+
## Source Excerpts
|
|
255
|
+
|
|
256
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
257
|
+
|
|
258
|
+
```typescript
|
|
259
|
+
/** What became of one recipient's card. */
|
|
260
|
+
export enum HumanDecisionNoticeDelivery {
|
|
261
|
+
/** The card was posted; `ref` is where, so it can be replaced or deleted. */
|
|
262
|
+
POSTED = 'posted',
|
|
263
|
+
/**
|
|
264
|
+
* The recipient could not be reached through this connection (Teams: the bot cannot open a personal chat with them;
|
|
265
|
+
* Slack: they are not in the workspace). Recorded so a retry does not try them again, and so nothing is withdrawn.
|
|
266
|
+
*/
|
|
267
|
+
UNREACHABLE = 'unreachable',
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
/**
|
|
271
|
+
* A posted card taken back from ONE reader while the decision still waits (#2756), because that reader may no longer
|
|
272
|
+
* answer it: the granting organization unshared the decision's record from their relationship, the relationship was
|
|
273
|
+
* suspended or re-scoped, or they lost the eligible role. The card carries the decision's content (a tool approval's
|
|
274
|
+
* proposed arguments are the record's), so it is owed back like a card of a decision that left. The other readers'
|
|
275
|
+
* cards stand. Set by the engine on a POSTED entry only; a handler never writes it.
|
|
276
|
+
*/
|
|
277
|
+
export enum HumanDecisionNoticeCardWithdrawal {
|
|
278
|
+
/** The reader may no longer answer: the engine owes this card back, and will take it back on its own. */
|
|
279
|
+
OWED = 'owed',
|
|
280
|
+
/** The card was taken back. A later withdraw of the whole notice passes over it. */
|
|
281
|
+
DONE = 'done',
|
|
282
|
+
}
|
|
283
|
+
|
|
284
|
+
/**
|
|
285
|
+
* What an ERASED reader's id becomes on a card that still stands in a chat (#2866): the card keeps where it is, so the
|
|
286
|
+
* engine can still take it back, and no longer says whose chat it is in. A card that stands nowhere (unreachable, or
|
|
287
|
+
* already taken back) is removed instead. Its own NAMED constant, though it has the same value as the other erasure
|
|
288
|
+
* marks: it is compared, as an id, with the recipients a handler is given, so the reason it must never equal one lives
|
|
289
|
+
* here, and the other marks may change their words without changing it.
|
|
290
|
+
*/
|
|
291
|
+
export const ERASED_DECISION_NOTICE_RECIPIENT = '[erased]';
|
|
292
|
+
|
|
293
|
+
/**
|
|
294
|
+
* One recipient's card, as a notice handler reported it (`ctx.posted.record` or `ctx.posted.unreachable`): what
|
|
295
|
+
* `ctx.posted.already` lists on a POST, and what a WITHDRAW notice's `posted` carries. Import from `@wildo-ai/saas-models`.
|
|
296
|
+
*/
|
|
297
|
+
export const HumanDecisionNoticePostedEntrySchema = z.strictObject({
|
|
298
|
+
recipientUserId: z.string().min(1),
|
|
299
|
+
/** The provider connection the card was posted through (its owner scope and ref), when one was used. */
|
|
300
|
+
connectionRef: z.string().min(1).optional(),
|
|
301
|
+
delivery: z.enum(HumanDecisionNoticeDelivery),
|
|
302
|
+
/** Where the card is, in the provider's own terms (a Slack channel and timestamp, a Teams conversation and activity id). */
|
|
303
|
+
ref: z.record(z.string(), z.string()).optional(),
|
|
304
|
+
/** Why the recipient could not be reached, in the handler's words; for an UNREACHABLE entry only. */
|
|
305
|
+
unreachableReason: z.string().min(1).optional(),
|
|
306
|
+
/**
|
|
307
|
+
* Set when the card's reader may no longer answer the decision while it still waits (#2756). Absent on every card a
|
|
308
|
+
* WITHDRAW notice carries: the engine hands a handler only the cards it is to take back, each as a plain POSTED card.
|
|
309
|
+
* A POST's `ctx.posted.already` may show an OWED card (it still stands, so its reader is handled), never a DONE one: a
|
|
310
|
+
* reader whose card was taken back holds none, and is posted to again if they may answer.
|
|
311
|
+
*/
|
|
312
|
+
withdrawal: z.enum(HumanDecisionNoticeCardWithdrawal).optional(),
|
|
313
|
+
});
|
|
314
|
+
export type HumanDecisionNoticePostedEntry = z.infer<typeof HumanDecisionNoticePostedEntrySchema>;
|
|
315
|
+
export const HumanDecisionNoticePostedSchema = z.array(HumanDecisionNoticePostedEntrySchema);
|
|
316
|
+
|
|
317
|
+
/**
|
|
318
|
+
* Whether a notice handler's helper posting through `connectionRef` passes over a recipient: someone already holds a card
|
|
319
|
+
* for them (POSTED, through any connection), or this connection already tried them (posted, or recorded unreachable).
|
|
320
|
+
*
|
|
321
|
+
* The one rule every vendor helper uses, so helpers compose: a handler that calls the Slack helper and then the Teams
|
|
322
|
+
* helper gives each person ONE card, in the first chat that reaches them. A person Slack recorded unreachable is still
|
|
323
|
+
* owed a Teams card, and a retry passes over everyone already handled. Skipping everyone `ctx.posted.already` names,
|
|
324
|
+
* whatever the connection, gives a person only another vendor could reach no card at all.
|
|
325
|
+
*
|
|
326
|
+
* @example
|
|
327
|
+
* for (const recipient of notice.recipients) {
|
|
328
|
+
* if (humanDecisionNoticeRecipientHandled(ctx.posted.already, recipient.userId, 'my-chat-provider')) continue;
|
|
329
|
+
* // post the card, then ctx.posted.record({ recipientUserId: recipient.userId, connectionRef: 'my-chat-provider', ref })
|
|
330
|
+
* }
|
|
331
|
+
*/
|
|
332
|
+
export function humanDecisionNoticeRecipientHandled(
|
|
333
|
+
already: readonly Pick<HumanDecisionNoticePostedEntry, 'recipientUserId' | 'connectionRef' | 'delivery'>[],
|
|
334
|
+
recipientUserId: string,
|
|
335
|
+
connectionRef: string,
|
|
336
|
+
): boolean {
|
|
337
|
+
return already.some((entry) => entry.recipientUserId === recipientUserId
|
|
338
|
+
&& (entry.delivery === HumanDecisionNoticeDelivery.POSTED || entry.connectionRef === connectionRef));
|
|
339
|
+
}
|
|
340
|
+
```
|
|
@@ -93,6 +93,15 @@ pipeline scans those to produce per-unit files.
|
|
|
93
93
|
the composite/full-custom view spec.
|
|
94
94
|
- New component label: declared via `registerComponentLabels(...)`
|
|
95
95
|
alongside the component or its preset.
|
|
96
|
+
- A label that takes a COUNT ("3 rows", "1 day ago"): declare the
|
|
97
|
+
param with `isCount: true` (`params: [{ key: 'count', meaning: '…',
|
|
98
|
+
isCount: true }]`). The pipeline then writes every plural form the
|
|
99
|
+
language needs as an ICU plural argument —
|
|
100
|
+
`{count, plural, one {# row} other {# rows}}` — the translation
|
|
101
|
+
rewrites them per language, and `tComponent(…, { count })` picks the
|
|
102
|
+
form with the reader's language. Without it a count of one reads
|
|
103
|
+
"1 rows". Never branch on `count === 1` in code: French treats 0 as
|
|
104
|
+
singular and other languages have more than two forms.
|
|
96
105
|
|
|
97
106
|
Read `references/label-placement.md` for placement conventions
|
|
98
107
|
and `references/framework-labelling-sections-api.md` for the
|
|
@@ -121,6 +130,9 @@ wildo generate labels --units "resource:todos resource:tasks"
|
|
|
121
130
|
|
|
122
131
|
# Re-generate every unit, ignoring the lock file — after a prompt or spec change:
|
|
123
132
|
wildo generate labels --force
|
|
133
|
+
|
|
134
|
+
# Re-word ONE answered key (its purpose changed) and leave every other word as it is:
|
|
135
|
+
wildo generate labels --units=theme:errors_messages --keys errors_messages.default.msg
|
|
124
136
|
```
|
|
125
137
|
|
|
126
138
|
The companion writes to
|
|
@@ -130,7 +142,11 @@ unit's `inputSha` / `primarySha` in `wildo-saas.lock.json` for incremental
|
|
|
130
142
|
skips. Generation is incremental inside a unit too: when a unit gains a key,
|
|
131
143
|
only the new key is generated and every existing word is kept, so adding a
|
|
132
144
|
label never re-words the ones already accepted. `--force` is the way to
|
|
133
|
-
re-word a whole unit, after a change of voice
|
|
145
|
+
re-word a whole unit, after a change of voice. When only some keys' purposes
|
|
146
|
+
changed, name them with `--keys` (full dotted paths inside the unit, together
|
|
147
|
+
with `--units`): exactly those are regenerated, every other line of the file
|
|
148
|
+
stays byte-identical, and each translation then owes exactly those keys, so
|
|
149
|
+
the next `wildo generate translate --units=<unit>` re-translates only them. The engine barrel picks them up automatically
|
|
134
150
|
on the next backend (re)start — top-level `await
|
|
135
151
|
scanCustomLabelsDirectory(...)` runs once at module load.
|
|
136
152
|
|
|
@@ -176,7 +176,7 @@ like:
|
|
|
176
176
|
per-value `meaning` (covered by `spec-resource-update`,
|
|
177
177
|
`example.spec.resource.semantic-field`).
|
|
178
178
|
3. **UI behavior edit** — `priority` `enumUI` block added with
|
|
179
|
-
per-value
|
|
179
|
+
per-value colour mapping (covered by `resource-ui-behavior`,
|
|
180
180
|
`example.resource.ui-behavior.enum-badge`).
|
|
181
181
|
4. **`i18n-label-generation`** — `wildo generate labels` writes /
|
|
182
182
|
updates `resources/todos.<primary-locale>.ts` (and any sibling theme
|
|
@@ -217,13 +217,27 @@ Run from the app root, substituting `<source>` and `<target>`:
|
|
|
217
217
|
| Invariant | Command |
|
|
218
218
|
|--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
219
219
|
| Engine barrel uses the scanner (single owner) | `rg -n 'scanCustomLabelsDirectory' backend-api/src/engine/i18n/index.ts` |
|
|
220
|
-
| At least one per-unit source-locale file exists |
|
|
221
|
-
| Per-unit count matches between source and target |
|
|
222
|
-
| Lock file is up-to-date with both locales |
|
|
220
|
+
| At least one per-unit source-locale file exists | see the commands below the table |
|
|
221
|
+
| Per-unit count matches between source and target | see the commands below the table |
|
|
222
|
+
| Lock file is up-to-date with both locales | see the commands below the table |
|
|
223
223
|
| **No empty values** in any per-unit file (must be empty) | `rg -n '":\s*""' backend-api/src/engine/i18n -g '*.ts'` |
|
|
224
224
|
| **No hard-coded product strings** in JSX touched in this change | `rg -n ">[A-Z][a-z]+ [A-Z][a-z]" frontend/src/modules/<slug>/` |
|
|
225
225
|
| Every per-unit file preserves the auto-generated header | `rg --files-without-match "DO NOT EDIT THIS FILE MANUALLY" backend-api/src/engine/i18n -g '*.ts'` (output should be empty) |
|
|
226
|
-
| **No** monolithic `labels.<locale>.ts` (must be empty) |
|
|
226
|
+
| **No** monolithic `labels.<locale>.ts` (must be empty) | see the commands below the table |
|
|
227
|
+
|
|
228
|
+
```bash
|
|
229
|
+
# At least one per-unit source-locale file exists
|
|
230
|
+
rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | head
|
|
231
|
+
|
|
232
|
+
# Per-unit count matches between source and target
|
|
233
|
+
diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | sed 's/<source>/X/' | sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | sed 's/<target>/X/' | sort)
|
|
234
|
+
|
|
235
|
+
# Lock file is up-to-date with both locales
|
|
236
|
+
rg -n '"localeCode":\s*"(<source>|<target>)"' wildo-saas.lock.json
|
|
237
|
+
|
|
238
|
+
# No monolithic `labels.<locale>.ts` (must be empty)
|
|
239
|
+
rg --files backend-api/src/engine/i18n -g 'labels.*.ts' | rg -v '/'
|
|
240
|
+
```
|
|
227
241
|
|
|
228
242
|
The high-signal invariant is **"per-unit count matches between
|
|
229
243
|
source and target"** combined with **"no empty values"** — drift
|
|
@@ -144,7 +144,10 @@ the steady state, omit it so the lock skips already-translated
|
|
|
144
144
|
units that haven't drifted (the lock compares each unit's
|
|
145
145
|
`primarySha` between runs). When the source gained keys, only those keys are
|
|
146
146
|
re-translated and every existing translation is kept; `--force` re-translates
|
|
147
|
-
the whole unit.
|
|
147
|
+
the whole unit. To redo one translation whose source did not change, name it:
|
|
148
|
+
`wildo generate translate --units=<unit> --keys <key…>` re-translates exactly
|
|
149
|
+
those keys, even where the lock calls the locale fresh, and leaves every other
|
|
150
|
+
translated word byte-identical (an email template is always translated whole).
|
|
148
151
|
|
|
149
152
|
## Worked Example
|
|
150
153
|
|
|
@@ -210,11 +213,19 @@ Run from the app root, substituting `<source>` and `<target>`:
|
|
|
210
213
|
|
|
211
214
|
| Invariant | Command |
|
|
212
215
|
|------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
213
|
-
| At least one target-locale per-unit file exists |
|
|
214
|
-
| Source-locale per-unit count matches target-locale count |
|
|
216
|
+
| At least one target-locale per-unit file exists | see the commands below the table |
|
|
217
|
+
| Source-locale per-unit count matches target-locale count | see the commands below the table |
|
|
215
218
|
| Lock file tracks the target locale | `rg -n '"localeCode":\s*"<target>"' wildo-saas.lock.json` |
|
|
216
219
|
| **No empty translated values** in target files (must be empty) | `rg -n '":\s*""' backend-api/src/engine/i18n -g '*.<target>.ts'` |
|
|
217
220
|
|
|
221
|
+
```bash
|
|
222
|
+
# At least one target-locale per-unit file exists
|
|
223
|
+
rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | head
|
|
224
|
+
|
|
225
|
+
# Source-locale per-unit count matches target-locale count
|
|
226
|
+
diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | sed 's/<source>/X/' | sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | sed 's/<target>/X/' | sort)
|
|
227
|
+
```
|
|
228
|
+
|
|
218
229
|
The high-signal invariants are **"source per-unit count matches
|
|
219
230
|
target per-unit count"** combined with **"no empty translated
|
|
220
231
|
values"** — drift in either direction means the translation rerun
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: inbound-channels
|
|
3
|
-
description: Declare code that runs when a message ARRIVES — a signed webhook from another system, or an email from a person — on `BackendDomainModule.inboundHandlers`, stored once, retried and replayable, with the sender's assurance deciding whether the handler runs and never what it may do. Use when the user says "receive a webhook from X", "add an inbound webhook endpoint", "handle Svix / Resend webhooks", "a client's system should create records in our app", "verify an HMAC-signed callback", "replay a failed webhook", "why does /webhooks/app/<key> answer 404", "clients should email documents to a case", "turn incoming email into tickets", "reply to the sender automatically", "only accept mail from known contacts", "let each organization receive mail at its own domain", or "give each client a mailbox on our domain".
|
|
3
|
+
description: Declare code that runs when a message ARRIVES — a signed webhook from another system, or an email from a person — on `BackendDomainModule.inboundHandlers`, stored once, retried and replayable, with the sender's assurance deciding whether the handler runs and never what it may do. Use when the user says "receive a webhook from X", "add an inbound webhook endpoint", "handle Svix / Resend webhooks", "a client's system should create records in our app", "verify an HMAC-signed callback", "replay a failed webhook", "why does /webhooks/app/<key> answer 404", "clients should email documents to a case", "turn incoming email into tickets", "reply to the sender automatically", "only accept mail from known contacts", "let each organization receive mail at its own domain", or "give each client a mailbox on our domain". Also when a system of record notifies that records changed ("Odoo posts a webhook when a partner changes", "refresh the synced customers when the ERP says so").
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -38,8 +38,8 @@ the one organization (or the application) the message resolved to, never in more
|
|
|
38
38
|
| Operator surface | Settings → Inbound deliveries (organization) / Administration → Inbound deliveries |
|
|
39
39
|
| Email channel handler | `backend-api/src/modules/<slug>/inbound/<handlerRef>.inbound-channel-handler.ts` — the file is NAMED after the handler's `ref` (`matters.mail-intake` → `matters.mail-intake.inbound-channel-handler.ts`), imported by the module's `index.ts` from `./inbound/<handlerRef>.inbound-channel-handler` and listed in its `inboundHandlers`. A build task producing the handler lands when that index imports that path |
|
|
40
40
|
| Receiving email | `wildo.saas.config.ts` → `engineCapabilities` enables `EMAIL_INBOUND`, with a receiving provider selected (`config-saas`) and declared on the backend scope with `EMAIL_INBOUND_PROVIDER` + `WEBHOOK_ORIGINATOR` |
|
|
41
|
-
| Shared receiving domain | `backend-api/src/saas-config.backend.ts` → `email.inbound.sharedDomain` |
|
|
42
|
-
| Organization domains,
|
|
41
|
+
| Shared receiving domain | `backend-api/src/saas-config.backend.ts` → `email.inbound.sharedDomain`, the default; an environment lays its own over it in `wildo.infra.<env>.config.ts` → `email.inbound.sharedDomain` (`infra-environment-config`) |
|
|
42
|
+
| Organization domains, relationship mailboxes | engine resources `organizationEmailDomains` / `relationshipMailboxes` — organization settings, no code |
|
|
43
43
|
| Reply templates | the module's email templates (`email-add-template`) |
|
|
44
44
|
|
|
45
45
|
## When to Use
|
|
@@ -48,6 +48,35 @@ the one organization (or the application) the message resolved to, never in more
|
|
|
48
48
|
- You need each event stored once, retried until it succeeds or is dead, and a way to replay what failed.
|
|
49
49
|
- People email your application — documents to a case, requests to a support address — and the message
|
|
50
50
|
should file, create or answer something.
|
|
51
|
+
- A system of record notifies that records changed and the application keeps a synced copy of them: the
|
|
52
|
+
handler asks the pipeline to re-read exactly those records (`ctx.pipelines.requestPipelineKeys`,
|
|
53
|
+
`references/framework-inbound-pipelines-api.md`).
|
|
54
|
+
- A chat bot's delivery (a Slack button, a Teams card) must act AS THE PERSON who sent it, for instance to
|
|
55
|
+
answer a pending decision: `ctx.chat` (`references/framework-inbound-handler-api.md`). It acts as the member
|
|
56
|
+
that chat account is linked to, with their own live authority, never with the handler's roles. Only a handler of
|
|
57
|
+
an endpoint its provider declares `namesChatMember` gets it; an email channel handler does not, because a From
|
|
58
|
+
address is verified by nothing. The installed chat provider's skill (`provider-slack`,
|
|
59
|
+
`provider-microsoft-teams-bot`) shows the flow end to end.
|
|
60
|
+
- A person writes to the bot (a mention, a direct message) and an agent should answer: `ctx.chat.converse()`. It
|
|
61
|
+
takes nothing: the engine reads the message, the sender and the conversation from the verified request (the
|
|
62
|
+
endpoint's `chatMessageOf`), resolves the member and the agent their organization chose, and starts the turn as
|
|
63
|
+
that member. It returns once the turn has started; the answer is posted later by the connection's chat reply
|
|
64
|
+
handler. Handle its outcome: `STARTED`, `ALREADY_RECEIVED` and `NO_MESSAGE` need nothing; return
|
|
65
|
+
`InboundHandlerOutcome.NOT_YET` for `NOT_YET` (the delivery runs again without spending a retry; the engine waits on
|
|
66
|
+
the door's answer even if the handler forgets, and a `NOT_YET` no `converse()` gave fails the delivery); for `REFUSED`,
|
|
67
|
+
post `sentence.text` where the person wrote, privately when `conversation.audience` is not `DIRECT` (a link page
|
|
68
|
+
for an unlinked account is in it). The stored delivery's copy of the message is emptied once its conversation
|
|
69
|
+
holds it.
|
|
70
|
+
- A person runs a chat command (a Slack slash command, a Teams message-extension form) that should run one of the
|
|
71
|
+
application's operations: `ctx.chat.runCommand()`. It takes nothing: the engine reads the verb, the text or the
|
|
72
|
+
form's values and the sender from the verified request (the endpoint's `chatCommandOf`), and runs the operation the
|
|
73
|
+
application declared for that verb (`chatCommand` on the operation) as the linked member, at most once for a write.
|
|
74
|
+
Post the outcome to the person alone with the provider's poster (`postSlackChatCommandOutcome`,
|
|
75
|
+
`postTeamsChatCommandOutcome`). A Teams message-extension SEARCH never reaches `handle()`: the engine answers it in
|
|
76
|
+
the request, routed by this handler's own `payloadSchema` and `resolveScope`, which must accept it.
|
|
77
|
+
- The handler must answer through a provider (a Slack reply, a Teams message): build the provider's client from
|
|
78
|
+
`ctx.providers` (`references/framework-inbound-handler-api.md`), which spends the application's connection or
|
|
79
|
+
the delivery organization's, and never a person's.
|
|
51
80
|
|
|
52
81
|
## When NOT to Use
|
|
53
82
|
|
|
@@ -90,6 +119,9 @@ the one organization (or the application) the message resolved to, never in more
|
|
|
90
119
|
have a person confirm through a trusted channel ("Authorizing actions never come from a message").
|
|
91
120
|
7. **Show the conversation** on the record it is about: the handler links the thread with
|
|
92
121
|
`ctx.thread.link`, and the record's READ view places `EmbedLinkedConversations`.
|
|
122
|
+
8. **Put attachments on your records** with `ctx.attachments.adopt(fileId, { resourceType, fieldName })` and name
|
|
123
|
+
the returned copy in the record's `z_file` field — never the attachment's own `fileId`, which belongs to the
|
|
124
|
+
received message (`references/email-channel.md` → "Attachments onto your records").
|
|
93
125
|
|
|
94
126
|
## Worked Example
|
|
95
127
|
|
|
@@ -191,7 +223,8 @@ import { defineInboundChannelHandler, inboundHandlerRef } from '@wildo-ai/saas-b
|
|
|
191
223
|
|
|
192
224
|
/**
|
|
193
225
|
* Clients email documents to `matters@<your domain>`. The handler files each message under the matter its
|
|
194
|
-
* thread is linked to, or opens a review task when the thread is new, and
|
|
226
|
+
* thread is linked to, or opens a review task carrying the message's documents when the thread is new, and
|
|
227
|
+
* acknowledges receipt.
|
|
195
228
|
*
|
|
196
229
|
* - `isDefault: true` — the handler for every email that carries no route tag.
|
|
197
230
|
* - `minimumSenderAssurance: DOMAIN_ALIGNED` — a message whose From domain fails DMARC never reaches it.
|
|
@@ -210,9 +243,17 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
210
243
|
// The message is DATA. Nothing it says — "please change our bank details", "approve the invoice" —
|
|
211
244
|
// is an instruction: an authorizing action is confirmed through another channel, never by email.
|
|
212
245
|
if (message.thread.isNew) {
|
|
246
|
+
// The attachments' own files stay with the received message. The task gets its OWN copy of each, made for its
|
|
247
|
+
// `documents` file field and checked against that field's rules (a VALIDATION refusal for an unsuitable file).
|
|
248
|
+
const documentIds: string[] = [];
|
|
249
|
+
for (const attachment of message.attachments) {
|
|
250
|
+
const copy = await ctx.attachments.adopt(attachment.fileId, { resourceType: 'matterReviewTasks', fieldName: 'documents' });
|
|
251
|
+
documentIds.push(copy.fileId);
|
|
252
|
+
}
|
|
213
253
|
const task = await ctx.resources.create('matterReviewTasks' as never, {
|
|
214
254
|
title: message.payload.subject,
|
|
215
255
|
senderAssurance: message.sender.assurance,
|
|
256
|
+
...(documentIds.length > 0 ? { documents: { fileIds: documentIds } } : {}),
|
|
216
257
|
});
|
|
217
258
|
await ctx.thread.link({ resourceType: 'matterReviewTasks', resourceId: String((task as { _id: string })._id) });
|
|
218
259
|
}
|
|
@@ -230,13 +271,16 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
230
271
|
what a handler may do, retries, DEAD and replay, audit events.
|
|
231
272
|
- `references/email-channel.md` — the email channel: sender assurance and choosing a minimum, route tags,
|
|
232
273
|
replying, threads and the linked record, why a message never authorizes a payment or an approval.
|
|
233
|
-
- `references/framework-inbound-channel-api.md` — the channel handler and conversation contracts
|
|
234
|
-
(source-backed).
|
|
274
|
+
- `references/framework-inbound-channel-api.md` — the channel handler and conversation contracts, and
|
|
275
|
+
`ctx.attachments.adopt` (source-backed).
|
|
235
276
|
- `references/receiving-email.md` — receiving: the four route kinds and which address reaches which
|
|
236
277
|
organization, configuring the provider and the shared domain, an organization's own domain (claim → TXT →
|
|
237
|
-
verify),
|
|
278
|
+
verify), relationship mailboxes on a representing organization's domain, the answer's From, what a stored message
|
|
279
|
+
carries.
|
|
238
280
|
- `references/framework-inbound-email-api.md` — the receiving-email vocabularies, the domain verbs and the
|
|
239
281
|
`email.inbound` configuration (source-backed).
|
|
282
|
+
- `references/framework-inbound-pipelines-api.md` — `ctx.pipelines` and `pipelineKeyRequests`: asking a data
|
|
283
|
+
pipeline to re-read the records a change notification names (source-backed).
|
|
240
284
|
|
|
241
285
|
## Verification
|
|
242
286
|
|
|
@@ -249,8 +293,10 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
249
293
|
- [ ] Each email channel has exactly one `isDefault: true` handler, and every handler declares `replyMode`
|
|
250
294
|
and a `minimumSenderAssurance` from the email ladder.
|
|
251
295
|
- [ ] No channel handler writes payment details, approvals or recipients from a message's content.
|
|
296
|
+
- [ ] A channel handler names an attachment on a record only through `ctx.attachments.adopt`'s returned copy.
|
|
252
297
|
- [ ] With `EMAIL_INBOUND` enabled, `POST /api/v1/webhooks/<provider>/<endpoint>` answers `401` to an unsigned
|
|
253
|
-
body, and
|
|
298
|
+
body, and a shared receiving domain is set wherever organizations should receive mail with no setup —
|
|
299
|
+
in `saas-config.backend.ts`, or per environment in `wildo.infra.<env>.config.ts > email.inbound.sharedDomain`.
|
|
254
300
|
|
|
255
301
|
### Grep invariants
|
|
256
302
|
|
|
@@ -258,9 +304,13 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
258
304
|
- `rg "APP_ADMIN_SUPER_ADMIN" backend-api/src/modules/*/inbound` — must return nothing.
|
|
259
305
|
- `rg "HMAC_SHA256_HEADER" -l backend-api/src/modules/*/inbound | xargs rg --files-without-match "dedupKey"` — must return nothing.
|
|
260
306
|
- `rg -c "isDefault: true" backend-api/src/modules/*/inbound` — sums to one per channel.
|
|
307
|
+
- `rg -l "requestPipelineKeys" backend-api/src/modules | xargs rg --files-without-match "pipelineKeyRequests"` — must return nothing.
|
|
308
|
+
- `rg -n "ctx\.resources\.(create|update)" backend-api/src/modules/*/inbound` — none may target a resource that declares an `externalDataPipeline`.
|
|
261
309
|
- `rg -l "defineInboundChannelHandler" backend-api/src/modules | xargs rg --files-without-match "minimumSenderAssurance"` — must return nothing.
|
|
262
310
|
- `rg -n "message\.(text|strippedReply)" backend-api/src/modules/*/inbound` — every read of the body; none may
|
|
263
311
|
choose an organization, a record to write into, or a recipient.
|
|
312
|
+
- `rg -n "fileId: attachment\.fileId|attachment\.fileId \}" backend-api/src/modules/*/inbound` — must return nothing: an
|
|
313
|
+
attachment's own id written into a record is refused (`FILE_ALREADY_LINKED`); write the adopted copy's id.
|
|
264
314
|
|
|
265
315
|
## Common Rationalizations
|
|
266
316
|
|
|
@@ -274,6 +324,10 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
274
324
|
| "If the organization isn't found I'll put it in the application scope." | There is no fallback on purpose: the handler was written for a tenant. The delivery is `UNROUTABLE`, audited, and visible to the operator. |
|
|
275
325
|
| "The email came from the client's address, so it is the client." | The From line is typed by the sender. `DOMAIN_ALIGNED` proves the domain, not the person; even `THREAD_TOKEN_BOUND` proves only that someone holds the reply address. Set the minimum for what the handler does, and never let a message authorize a payment or an approval. |
|
|
276
326
|
| "A known contact can be trusted with more, so I'll widen the roles for them." | Assurance decides whether the handler runs, never what it may do: its roles are the same for every sender. A handler that needs more for some senders is two handlers with two minimums. |
|
|
327
|
+
| "The ERP's webhook carries the new values, so I'll write them into the synced resource." | A synced resource's fields belong to its pipeline, and a notification can be stale, partial or replayed. Call `ctx.pipelines.requestPipelineKeys` with the record keys; the pipeline re-reads them from the source. |
|
|
328
|
+
| "The attachment already has a `fileId`, I'll put it in my record's file field." | That file is the received message's, kept and erased with it; the write is refused. `ctx.attachments.adopt` makes your record its own copy, checked against your field's rules. |
|
|
329
|
+
| "The handler knows the thread, so it should tell the agent which conversation to continue." | `ctx.chat.converse()` takes nothing. The engine reads the conversation, the sender and the message from the verified request, so a handler cannot point a member's turn at another conversation or put words in their mouth. |
|
|
330
|
+
| "The chat click says who clicked, so the handler can approve for them with its own roles." | The handler's roles are the scope's, not the person's. `ctx.chat.answerDecision` answers as the member the chat account is linked to, under the decision's own rules, and the decision's audit row names the delivery it came through. |
|
|
277
331
|
| "I'll call the agent directly from the handler." | `ctx` has no actor call. Hand the delivery to a declared autonomous agent with `ctx.agents.startAutonomousTurn` — it runs under the principal the organization bound to that agent, is idempotent per delivery, and is offered only read or reviewer-gated tools (`flows-actors-autonomous-agents`). |
|
|
278
332
|
|
|
279
333
|
## Red Flags
|
|
@@ -287,6 +341,8 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
287
341
|
- A channel handler at `UNVERIFIED` that writes records a client relies on — catch with the second
|
|
288
342
|
Verification item; raise the minimum or route the message to a review handler.
|
|
289
343
|
- Two `isDefault: true` handlers on one channel — catch with the fourth grep (startup refuses it too).
|
|
344
|
+
- A record created from an email with no file, or a delivery ending DEAD on `FILE_ALREADY_LINKED` — the handler wrote
|
|
345
|
+
the attachment's own id; catch with the attachment-id grep above and adopt instead.
|
|
290
346
|
- A handler that reads the organization or the list from the message BODY — routing already chose the
|
|
291
347
|
organization from the envelope; read the route tag (`message.payload.routeTag`) and your own data. Catch
|
|
292
348
|
with the body-reads grep above.
|
|
@@ -299,3 +355,5 @@ export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
|
299
355
|
- `flows-actors-a2a-exposure` — external AI agents, not webhooks.
|
|
300
356
|
- `email-add-template` — the templates a channel handler answers with.
|
|
301
357
|
- `flows-actors-autonomous-agents` — handing a message to an agent whose tool calls a person reviews.
|
|
358
|
+
- `resource-external-data` — the synced copy a change notification refreshes, and what a keyed re-read does
|
|
359
|
+
(`references/requested-keys.md`).
|