@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,1182 @@
|
|
|
1
|
+
# `keyManagement` — which provider and key serve each key purpose
|
|
2
|
+
|
|
3
|
+
Key management is an engine capability that is **always enabled**: there is nothing to turn on, and
|
|
4
|
+
`engineCapabilities.KEY_MANAGEMENT` cannot be set to `enabled: false`. Every key the platform uses is
|
|
5
|
+
named by a **purpose**, and each purpose has exactly one descriptor that decides what its keys are:
|
|
6
|
+
what they sign, who may hold them, who may ask for a signature, how often they rotate, and the floor
|
|
7
|
+
of protection they must meet.
|
|
8
|
+
|
|
9
|
+
Read this when:
|
|
10
|
+
|
|
11
|
+
- you are asked where your application's approval seals are signed, or with what key;
|
|
12
|
+
- a security review asks for a hardware-protected or provider-generated key;
|
|
13
|
+
- you want each organization to have its own seal key rather than one for the whole application;
|
|
14
|
+
- you want to pin your keys, or to keep the platform's signing log yourself, so that the host cannot introduce or
|
|
15
|
+
backdate a seal without you seeing it;
|
|
16
|
+
- a boot or `defineSaasConfig` refusal names `keyManagement`, a purpose, a floor or a scope.
|
|
17
|
+
|
|
18
|
+
## You usually declare nothing
|
|
19
|
+
|
|
20
|
+
With no `keyManagement` section, every key the platform keyring holds is made by the engine's own
|
|
21
|
+
**LOCAL** provider (`wildo-local`), application-scoped. LOCAL makes software keys and keeps their
|
|
22
|
+
private halves sealed under the platform's key-encryption root, held by the platform's apps-manager
|
|
23
|
+
alone. (The platform's own runtime-response key is not in the keyring: it lives in apps-manager's
|
|
24
|
+
environment, and the platform operator rotates it.) Your
|
|
25
|
+
application's backend never holds a seal key: it asks the platform to sign, and the platform sets
|
|
26
|
+
the issuer, the key id and the signing time itself.
|
|
27
|
+
|
|
28
|
+
Declare a binding only to change one of three things:
|
|
29
|
+
|
|
30
|
+
| you want | declare |
|
|
31
|
+
|---|---|
|
|
32
|
+
| a dedicated key per organization | `scope: 'organization'` on the purpose's binding |
|
|
33
|
+
| a stronger key than the engine's floor | `floor: { ... }` raised on one or more axes, with a `provider` that offers it |
|
|
34
|
+
| a key held by another provider (a KMS, a Vault, an HSM) | `provider: '<provider ref>'` and that provider's `keyRef`. The platform serves it once its operator declares that provider in the environment's `platformKeyManagement`; until then the binding validates and every signature is refused `provider_unavailable` |
|
|
35
|
+
|
|
36
|
+
A floor can be raised, never lowered: `defineSaasConfig` refuses a binding whose floor is weaker
|
|
37
|
+
than the engine's on any axis, a scope the purpose does not offer, and a provider your application
|
|
38
|
+
does not declare with `KEY_MANAGEMENT`.
|
|
39
|
+
|
|
40
|
+
## What the application keeps
|
|
41
|
+
|
|
42
|
+
Your backend stores the public half of every key version the platform signs with for it
|
|
43
|
+
(`publishedVerificationKeys`), learned from the platform's signed keyring status. A seal therefore
|
|
44
|
+
verifies from your application alone, after a rotation and after the platform's keyring is rebuilt.
|
|
45
|
+
Two public routes serve them:
|
|
46
|
+
|
|
47
|
+
- `GET /approval-seals/jwks`: every key that still verifies, retired ones included;
|
|
48
|
+
- `GET /approval-seals/compromised-keys`: keys an operator declared compromised, each with the
|
|
49
|
+
earliest instant it may have been exposed. A seal under such a key made after that instant cannot
|
|
50
|
+
be corroborated, and a verifier should say so rather than call it valid.
|
|
51
|
+
|
|
52
|
+
Never point a verifier at `/oauth/jwks` for a seal: that set holds your application's token key and
|
|
53
|
+
webhook key, other purposes.
|
|
54
|
+
|
|
55
|
+
## Signing and verifying from your backend
|
|
56
|
+
|
|
57
|
+
Your backend code reaches keys through one service, by purpose. For a key the platform holds (the seal
|
|
58
|
+
key) it never holds the private half:
|
|
59
|
+
|
|
60
|
+
## Import Origins
|
|
61
|
+
|
|
62
|
+
- `@wildo-ai/saas-backend-lib`
|
|
63
|
+
|
|
64
|
+
## Source Excerpts
|
|
65
|
+
|
|
66
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
67
|
+
|
|
68
|
+
```typescript
|
|
69
|
+
/**
|
|
70
|
+
* # Keys, by purpose, from the application backend (#2891)
|
|
71
|
+
*
|
|
72
|
+
* The application's one door onto platform-custody keys. It never holds a private key: `sign` asks the platform's
|
|
73
|
+
* custodian, which sets the issuer, key id and signing time itself, and `verify` reads only the public halves the
|
|
74
|
+
* application keeps (`publishedVerificationKeys`), so a signature verifies with the platform unreachable.
|
|
75
|
+
*
|
|
76
|
+
* Import `ApplicationKeys` and `SAAS_SERVICE_TYPES` from `@wildo-ai/saas-backend-lib`, and inject it as
|
|
77
|
+
* `SAAS_SERVICE_TYPES.ApplicationKeysService`. Only a purpose whose descriptor admits the application backend can be
|
|
78
|
+
* signed (`APPROVAL_SEAL` today). `mac` and `derive` compute in process with a symmetric key the platform delivered to
|
|
79
|
+
* this runtime (#2893); sealing and opening data arrive with the data-encryption purposes (#2894).
|
|
80
|
+
*/
|
|
81
|
+
export interface ApplicationKeys {
|
|
82
|
+
/**
|
|
83
|
+
* Sign `claims` with the purpose's ACTIVE key. `claims` are what the application decided, exactly as it recorded
|
|
84
|
+
* them; a claim the custodian sets (`iss`, `iat`, `kid`, `typ`, `lateSeal`) is refused. Asking again with the same
|
|
85
|
+
* claims returns the same signature (`replayed: true`) for seven days. Throws {@link ApplicationSignatureRefusedError}.
|
|
86
|
+
*
|
|
87
|
+
* `committedDecisionPayloadDigest` is the digest the decision recorded when it committed (#2903 review M4): sent as
|
|
88
|
+
* given, so the custodian, which recomputes it from `claims`, refuses claims that changed since the commit
|
|
89
|
+
* (`DECISION_DIGEST_MISMATCH`) before it signs or logs them. Without it the digest is computed from `claims` here,
|
|
90
|
+
* which proves only that the request is internally consistent.
|
|
91
|
+
*/
|
|
92
|
+
sign(purpose: CryptoKey_Purpose, claims: Readonly<Record<string, unknown>>, committedDecisionPayloadDigest?: string): Promise<SignatureResponse>;
|
|
93
|
+
/** Check a compact JWS of the purpose against the keys the application keeps. Never calls the platform to verify. */
|
|
94
|
+
verify(purpose: CryptoKey_Purpose, jws: string): Promise<ApplicationSignatureVerification>;
|
|
95
|
+
/** Every key of the purpose that still verifies, compromised ones excepted: what `/approval-seals/jwks` serves. */
|
|
96
|
+
publicJwks(purpose: CryptoKey_Purpose): Promise<{ keys: PublishedVerificationJwk[] }>;
|
|
97
|
+
/**
|
|
98
|
+
* HMAC-SHA-256 of `data` under the purpose's key (#2893). Throws a CONFIGURATION error when this runtime holds no key
|
|
99
|
+
* of the purpose: it was not delivered here (the purpose's `heldBy` does not name this runtime) or apps-manager has not
|
|
100
|
+
* minted it yet.
|
|
101
|
+
*/
|
|
102
|
+
mac(purpose: ApplicationSymmetricKeyPurpose, data: string | Buffer): Buffer;
|
|
103
|
+
/**
|
|
104
|
+
* A key derived from the purpose's key for one `context` (an organization id, a versioned label): HMAC-SHA-256 of the
|
|
105
|
+
* context under the purpose's key, so two contexts never share a key and nobody without the purpose's key can compute
|
|
106
|
+
* one. Throws a CONFIGURATION error as `mac` does.
|
|
107
|
+
*/
|
|
108
|
+
derive(purpose: ApplicationSymmetricKeyPurpose, context: string): Buffer;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** This runtime holds no key of the purpose: not delivered here, or not minted yet. */
|
|
112
|
+
export class ApplicationKeyUnavailableError extends Error {
|
|
113
|
+
constructor(readonly purpose: ApplicationSymmetricKeyPurpose) {
|
|
114
|
+
super(`This runtime holds no ${purpose} key: the platform has not delivered one to it.`);
|
|
115
|
+
this.name = 'ApplicationKeyUnavailableError';
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/** Why a signature did not verify. */
|
|
120
|
+
export enum ApplicationSignatureVerificationFailure {
|
|
121
|
+
/** Not a compact JWS, or its header is not ES256 with a `kid` and this purpose's `typ`. */
|
|
122
|
+
MALFORMED = 'malformed',
|
|
123
|
+
/** The application keeps no key with that `kid` for this purpose. */
|
|
124
|
+
UNKNOWN_KEY = 'unknown_key',
|
|
125
|
+
/** The signature does not verify under the key it names. */
|
|
126
|
+
SIGNATURE_INVALID = 'signature_invalid',
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* A verification's answer. A valid signature under a key since marked COMPROMISED is still reported valid, with the
|
|
131
|
+
* key's state and `compromiseInstant`: whether a seal made before that instant can be corroborated is the caller's
|
|
132
|
+
* question, answered from evidence outside the signature (an exported audit event, an immutable sink).
|
|
133
|
+
*/
|
|
134
|
+
export type ApplicationSignatureVerification =
|
|
135
|
+
| {
|
|
136
|
+
readonly valid: true;
|
|
137
|
+
readonly kid: string;
|
|
138
|
+
readonly claims: Readonly<Record<string, unknown>>;
|
|
139
|
+
readonly keyState: CryptoKey_VersionState;
|
|
140
|
+
/** ISO 8601, for a compromised key: the earliest instant its private half may have been exposed. */
|
|
141
|
+
readonly compromiseInstant?: string;
|
|
142
|
+
}
|
|
143
|
+
| { readonly valid: false; readonly failure: ApplicationSignatureVerificationFailure; readonly kid?: string };
|
|
144
|
+
|
|
145
|
+
/** A signature the custodian (or the way to it) did not give. `retryable` says whether asking again can succeed. */
|
|
146
|
+
export class ApplicationSignatureRefusedError extends Error {
|
|
147
|
+
constructor(
|
|
148
|
+
/** The custodian's refusal, when it named one the client may read; null for a refusal it does not disclose. */
|
|
149
|
+
readonly refusal: CryptoKey_SignatureRefusal | null,
|
|
150
|
+
readonly retryable: boolean,
|
|
151
|
+
message: string,
|
|
152
|
+
) {
|
|
153
|
+
super(message);
|
|
154
|
+
this.name = 'ApplicationSignatureRefusedError';
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
Four keys are your application's own, one per signing use, and the engine signs with them itself: the
|
|
160
|
+
auth-token key (your users' access, refresh and ID tokens), the webhook key, and the keys for requests to
|
|
161
|
+
the platform and to your workers. The platform generates them and delivers each private half to your
|
|
162
|
+
backend only; your minions and workers never receive one. Each signs a token of its own `typ`, so a
|
|
163
|
+
token made for one use is refused as another. Your code never handles these keys.
|
|
164
|
+
|
|
165
|
+
Your application also holds one **symmetric key per keyed digest the engine computes**: the
|
|
166
|
+
tool-approval key (what stops a client forging a person's approval of an agent's tool call), the
|
|
167
|
+
proof-of-work challenge key, the decision-presentation key, the correction-digest and
|
|
168
|
+
evaluation-pseudonym keys (each derived per organization), the two SIEM delivery keys, and the
|
|
169
|
+
erasure-suppression key. The platform generates them and delivers each only to the runtimes that
|
|
170
|
+
compute with it: your backend always, your minions where they run agents or emit audit events, your
|
|
171
|
+
workers never. None of them is derived from your application's primary secret, which is a credential
|
|
172
|
+
your runtimes present to the platform and nothing else. Each is random, except the erasure-suppression
|
|
173
|
+
key of an application that existed before these keys did: that one keeps the value it was derived
|
|
174
|
+
with, so the erased records it already suppresses stay suppressed. Rotating the primary secret never
|
|
175
|
+
changes any of them.
|
|
176
|
+
|
|
177
|
+
Never read `PLATFORM_APPLICATION_PRIMARY_SECRET` to key anything in your own code: a leak of the
|
|
178
|
+
credential would then expose your digest too, and a minion, which presents its own credential under
|
|
179
|
+
that name, would compute a different one. `mac` and `derive` on the service above serve the engine's
|
|
180
|
+
purposes only; each key serves one purpose, so do not reuse one of them for a digest of your own.
|
|
181
|
+
|
|
182
|
+
## Approval seals: every decision a person answered is sealed
|
|
183
|
+
|
|
184
|
+
You write nothing for this. When a person answers a decision (an operation approval, a representative
|
|
185
|
+
admission, a conversational tool approval or question, an actor-system question) and the answer is
|
|
186
|
+
theirs (accepted, accepted with modifications, rejected), the engine writes one `approvalSeals` row
|
|
187
|
+
in the same transaction as the decision. A lapse, a withdrawal and an answer whose requester lost
|
|
188
|
+
their authority are nobody's verdict, and are not sealed. An approval whose work then could not run
|
|
189
|
+
is still the person's approval, and is sealed as one.
|
|
190
|
+
|
|
191
|
+
The engine also seals the decisions people take outside those planes, each in the transaction that
|
|
192
|
+
records it:
|
|
193
|
+
|
|
194
|
+
| decision | source | meaning |
|
|
195
|
+
|---|---|---|
|
|
196
|
+
| approving or denying a platform access grant, revoking one | `platform_access_grant` | authorization (revocation: instruction) |
|
|
197
|
+
| the second administrator's signature on an application-wide grant | `application_access_grant` | authorization (revocation: instruction) |
|
|
198
|
+
| the granting organization accepting or declining a proposed relationship, or the representing organization accepting one | `organization_relationship` | authorization |
|
|
199
|
+
| placing or releasing a legal hold | `legal_hold` | instruction |
|
|
200
|
+
| a person accepting a governed document (at sign-up, federated sign-up, or later) | `governed_document_acceptance` | approval |
|
|
201
|
+
|
|
202
|
+
Each is declared on the operation variant that settles it (`approvalSeal`), or on the route for a
|
|
203
|
+
manual route, with the record fields the decision is about. Such a seal's presentation is those fields
|
|
204
|
+
as the record stood when the person decided, marked RECORDED: the engine sealed the record, it did not
|
|
205
|
+
watch a screen. Each source's own audit row (the grant's or the relationship's lifecycle row,
|
|
206
|
+
`legal_hold_placed` / `legal_hold_released`, the governed-document interaction) carries the seal's
|
|
207
|
+
`decisionPayloadDigest`. An expiry, an auto-approval, a person's consent to their own data, an OAuth
|
|
208
|
+
consent and an invitation's answer are not sealed, and each declaration says why. Suspending, resuming,
|
|
209
|
+
terminating or withdrawing from a live relationship is not sealed yet either, and says so.
|
|
210
|
+
|
|
211
|
+
A person's decision on something proposed goes through a decision plane, which seals it: a gated tool
|
|
212
|
+
call (`humanApproval`), an actor question, or an operation that `requiresApproval`. When an agent's call
|
|
213
|
+
was about a record it proposed, the gate's `onDenied` moves the record on a denial, so the sealed denial is
|
|
214
|
+
the rejection. Your application's own operations do not seal: the framework refuses `approvalSeal`
|
|
215
|
+
CAPTURED on an application resource. On an operation that records a decision taken elsewhere, or an act
|
|
216
|
+
outside any card, declare `approvalSeal: { capture: ApprovalPresentationCapture.NONE, reason }` (from
|
|
217
|
+
`@wildo-ai/saas-models`), so the reason is stated where the act is.
|
|
218
|
+
|
|
219
|
+
What a seal is, and what it never contains:
|
|
220
|
+
|
|
221
|
+
- a compact JWS signed by the platform with your application's (or the organization's) seal key,
|
|
222
|
+
over fixed, versioned claims: the source, the decision, the record decided about, the meaning and
|
|
223
|
+
outcome, when the person decided, and how they were authenticated (channel, `amr`, step-up, the
|
|
224
|
+
client that acted for them);
|
|
225
|
+
- **no person in clear**: each person (the approver, and a requester who is a person) is one salted
|
|
226
|
+
disclosure. The claims carry its digest; the row keeps the salt and the value. Erasing the
|
|
227
|
+
person removes the disclosures and keeps the seal, which then verifies with that content reported
|
|
228
|
+
as erased.
|
|
229
|
+
|
|
230
|
+
Signing never blocks the decision. The row is written PENDING and a relay signs it right after the
|
|
231
|
+
commit, then every minute (`approval-seal-relay`) for whatever is left. A refusal asking again can
|
|
232
|
+
cure (a rate limit, the platform unreachable) is retried for ever, at most an hour apart. A refusal
|
|
233
|
+
asking again cannot cure leaves the seal DEAD, recorded on the audit trail at HIGH risk (CRITICAL in its SIEM
|
|
234
|
+
export) and counted on
|
|
235
|
+
`approval_seal_settled_total{status="dead"}`; alert on it, and on
|
|
236
|
+
`approval_seal_oldest_unsealed_age_seconds` past an hour. That age is measured by each relay run, so it
|
|
237
|
+
cannot report a relay that stopped running: watch the `approval-seal-relay` batch itself for that. A seal
|
|
238
|
+
still unsigned when its approver is erased is signed all the same: the erasure removes the approver's
|
|
239
|
+
disclosure and retains the row, and the relay finishes it through the fields the seal declares as its
|
|
240
|
+
`retentionPolicy.retainedRowCompletion`. An
|
|
241
|
+
operator re-drives a DEAD seal once its
|
|
242
|
+
cause is fixed: `wildo seal dead` lists them, `wildo seal retry <sealId> --justification "…"` sends one
|
|
243
|
+
back, recorded with its justification. The door:
|
|
244
|
+
|
|
245
|
+
## Import Origins
|
|
246
|
+
|
|
247
|
+
- `@wildo-ai/saas-backend-lib`
|
|
248
|
+
|
|
249
|
+
## Source Excerpts
|
|
250
|
+
|
|
251
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
252
|
+
|
|
253
|
+
```typescript
|
|
254
|
+
/**
|
|
255
|
+
* The secret these endpoints require: the application's one admin secret, as the data-seeding and external-data
|
|
256
|
+
* operator doors use. Unset or empty, every endpoint answers 503.
|
|
257
|
+
*/
|
|
258
|
+
export const ApprovalSealsAdminEndpointEnvKey = 'APPLICATION_ADMIN_SECRET' as const;
|
|
259
|
+
|
|
260
|
+
/** Header carrying the secret. */
|
|
261
|
+
export const ApprovalSealsAdminEndpointHeaderKey = 'X-Admin-Secret' as const;
|
|
262
|
+
|
|
263
|
+
/** Root mount: an operator surface, not a consumer API. */
|
|
264
|
+
export const ApprovalSealsAdminEndpointMountBasePath = '/internal/admin/approval-seals' as const;
|
|
265
|
+
|
|
266
|
+
/** Sub-paths, relative to {@link ApprovalSealsAdminEndpointMountBasePath}. */
|
|
267
|
+
export const ApprovalSealsAdminEndpointPath = {
|
|
268
|
+
/** GET — the DEAD seals, oldest first (`?limit=50`, at most 200): each with the refusal it died on. */
|
|
269
|
+
DEAD: '/dead',
|
|
270
|
+
/**
|
|
271
|
+
* POST — re-drive ONE DEAD seal: `{ "sealId": "…", "justification": "…", "operator"?: "…" }`. The seal goes back to
|
|
272
|
+
* PENDING, due now, its claims and decision instant unchanged, so the seal the custodian then signs says when the
|
|
273
|
+
* person decided and the verifier shows it late. The justification is required and recorded
|
|
274
|
+
* (`approval_seal_retried`). 404 for an unknown seal, 409 for one that is not DEAD.
|
|
275
|
+
*/
|
|
276
|
+
RETRY: '/retry',
|
|
277
|
+
/**
|
|
278
|
+
* POST — the verification bundle of ONE SEALED seal (`{ "sealId": "…", "operator"?: "…", "justification"?: "…" }`),
|
|
279
|
+
* exactly what `wildo seal verify` reads, recorded on the trail (`approval_seal_exported`): the JWS, the
|
|
280
|
+
* stored record of its key, its issuer, and every disclosure the row still holds (the people not erased, the
|
|
281
|
+
* presentation, the statement). 404 for an unknown seal; 409 for one not SEALED, whose key record is not held, or whose
|
|
282
|
+
* frozen presentation file is not the one its row recorded. A seal retained after its approver's erasure is revealed
|
|
283
|
+
* only with `operator` and `justification`, recorded as a reveal of retained data; its bundle verifies with that
|
|
284
|
+
* person's content reported erased.
|
|
285
|
+
*/
|
|
286
|
+
BUNDLE: '/bundle',
|
|
287
|
+
/**
|
|
288
|
+
* POST — an export of the application's signing log (#2932), for the operator to keep where the host cannot rewrite
|
|
289
|
+
* it: `{ "afterSequence": 0, "limit"?: 1000 }` → the export (a JWS the custodian signed under the application's
|
|
290
|
+
* SIGNING_LOG_EXPORT key), the stored record of that key, `throughSequence` (the `afterSequence` of the next pull), and
|
|
291
|
+
* how its seal signatures reconcile with the stored seals: an UNACCOUNTED one is a signature nobody stores.
|
|
292
|
+
* The export names no person: per entry, the seal's id, its digests, its key and its instant. A custodian refusal
|
|
293
|
+
* answers 503 when asking again can succeed and 409 otherwise, with the refusal as `code`; 409 as well when the
|
|
294
|
+
* application does not hold the export key's record yet.
|
|
295
|
+
*/
|
|
296
|
+
SIGNING_LOG_EXPORT: '/signing-log/export',
|
|
297
|
+
} as const;
|
|
298
|
+
|
|
299
|
+
/**
|
|
300
|
+
* What became of one seal signature the signing log records, against the application's stored seals (#2932). A
|
|
301
|
+
* logged seal counts as accounted for only when the application stores THAT signature (STORED); the other two are
|
|
302
|
+
* reported, and fail the operator's pull.
|
|
303
|
+
*/
|
|
304
|
+
export enum SigningLogSealStanding {
|
|
305
|
+
/** The application stores this seal, signed with exactly this signature. */
|
|
306
|
+
STORED = 'stored',
|
|
307
|
+
/**
|
|
308
|
+
* The application stores the decision, under another signature of it or none yet. Not accounted for: a re-signature
|
|
309
|
+
* of a real decision is how a backdated seal would look. Benign causes exist (an answer lost on the way back, so the
|
|
310
|
+
* relay asked again; a signature the relay is still writing, which a pull of the same range later shows STORED), and
|
|
311
|
+
* the signature's instant tells them apart.
|
|
312
|
+
*/
|
|
313
|
+
RESIGNED = 'resigned',
|
|
314
|
+
/**
|
|
315
|
+
* No stored seal has this decision: a signature the custodian made that the application does not hold. Until approval
|
|
316
|
+
* evidence that is deliberately destroyed leaves a record of it (#2924), a seal purged with its record shows here too.
|
|
317
|
+
*/
|
|
318
|
+
UNACCOUNTED = 'unaccounted',
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
/** One seal signature of an export that the application does not store. Names no person. */
|
|
322
|
+
export interface SigningLogUnaccountedSeal {
|
|
323
|
+
readonly sequence: number;
|
|
324
|
+
readonly jti: string;
|
|
325
|
+
readonly kid: string;
|
|
326
|
+
/** When the custodian signed it, epoch seconds. */
|
|
327
|
+
readonly iat: number;
|
|
328
|
+
}
|
|
329
|
+
|
|
330
|
+
/** How an export's seal signatures reconcile with the stored seals. Only APPROVAL_SEAL entries are seals. */
|
|
331
|
+
export interface SigningLogReconciliation {
|
|
332
|
+
readonly seals: number;
|
|
333
|
+
readonly stored: number;
|
|
334
|
+
/** Signatures of a stored decision that the application does not store (RESIGNED). */
|
|
335
|
+
readonly resigned: readonly SigningLogUnaccountedSeal[];
|
|
336
|
+
/** Signatures of a decision no stored seal has (UNACCOUNTED). */
|
|
337
|
+
readonly unaccounted: readonly SigningLogUnaccountedSeal[];
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/** `POST /signing-log/export`'s answer: what the operator keeps (`jws`, `key`), where its next pull starts, and the reconciliation. */
|
|
341
|
+
export interface ApprovalSealSigningLogExportAnswer extends SigningLogExportFile {
|
|
342
|
+
/** The chain's head when the export was made. */
|
|
343
|
+
readonly headSequence: number;
|
|
344
|
+
/** The last sequence the export carries: the next pull's `afterSequence`. */
|
|
345
|
+
readonly throughSequence: number;
|
|
346
|
+
readonly reconciliation: SigningLogReconciliation;
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/** One DEAD seal, as `GET /dead` lists it. Names no person: the approver is in the seal's disclosure only. */
|
|
350
|
+
export interface ApprovalSealDeadListingEntry {
|
|
351
|
+
readonly sealId: string;
|
|
352
|
+
readonly status: ApprovalSealStatus;
|
|
353
|
+
readonly source: ApprovalSource;
|
|
354
|
+
readonly decisionRef: string;
|
|
355
|
+
readonly step: number;
|
|
356
|
+
readonly sequence: number;
|
|
357
|
+
readonly organizationId: string | null;
|
|
358
|
+
readonly linkedResourceType: string;
|
|
359
|
+
readonly linkedResourceId: string;
|
|
360
|
+
readonly decidedAt: string;
|
|
361
|
+
readonly deadAt: string | null;
|
|
362
|
+
readonly attemptCount: number;
|
|
363
|
+
readonly lastRefusal: CryptoKey_SignatureRefusal | null;
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
/** `POST /retry`'s answer. */
|
|
367
|
+
export interface ApprovalSealRetryResult {
|
|
368
|
+
readonly sealId: string;
|
|
369
|
+
readonly status: ApprovalSealStatus;
|
|
370
|
+
/** True when the relay's immediate attempt signed it; false when the batch will. */
|
|
371
|
+
readonly sealed: boolean;
|
|
372
|
+
}
|
|
373
|
+
```
|
|
374
|
+
|
|
375
|
+
### What the person was shown is part of the seal
|
|
376
|
+
|
|
377
|
+
A seal binds the answer to what the person read. The server builds one presentation per decision: its
|
|
378
|
+
wording (title, description, options, as label references each reader words in their own language) and
|
|
379
|
+
the values decided on (a tool call's arguments, a held operation's values), already turned into the
|
|
380
|
+
strings the card shows. Lifecycle facts (who holds it, deadlines, clocks) are not in it, so moving a
|
|
381
|
+
decision does not change it. Every decision card (`GET /flows-actors/decisions`) and every conversation
|
|
382
|
+
announcement carries it as `presentation`, with an id, `presentationId`.
|
|
383
|
+
|
|
384
|
+
- **Render it as given.** A surface you build shows `presentation.fields[].value` verbatim and formats
|
|
385
|
+
no value itself; that is what makes the sealed text the text the person read.
|
|
386
|
+
- **Echo the id on every answer.** `POST /flows-actors/decisions/:decisionRef/answer` refuses an answer
|
|
387
|
+
without `presentationId` (400, reason `presentation_not_echoed`), and refuses one whose presentation is
|
|
388
|
+
no longer the decision's (409, reason `presentation_stale`): read the decision again and answer what it
|
|
389
|
+
shows now. An API client, an MCP or A2A integration owes the same echo; a seal on such an answer reads
|
|
390
|
+
PRESENTED. An answer clicked on a chat card carries no id and is sealed SENT: what the engine sent,
|
|
391
|
+
not something it watched render. That is what the card carried: without a tool approval's arguments
|
|
392
|
+
or a held operation's values, unless your notice handler sets `includeToolArguments`.
|
|
393
|
+
- The seal commits to the presentation and to the person's statement (the option, the values, any
|
|
394
|
+
arguments they edited, the reason code; never their free-text note) by salted digests, like a person.
|
|
395
|
+
The row keeps both. A presentation over 256 KiB of canonical JSON moves to a file before the seal is
|
|
396
|
+
signed; the row names it with its SHA-256 and attests it (`presentationFileId`), so the file is frozen
|
|
397
|
+
for as long as the seal exists, an erased approver's seal included. An export whose file cannot be
|
|
398
|
+
read is refused (409), never handed out without the presentation.
|
|
399
|
+
|
|
400
|
+
Every decision's `human_decision_resolved` row carries the seal's `decisionPayloadDigest`. Where your
|
|
401
|
+
organizations export their audit trail (a SIEM, an immutable sink), that row is evidence the seal's
|
|
402
|
+
payload existed when the decision was taken, independently of your database.
|
|
403
|
+
|
|
404
|
+
`wildo seal export <sealId> --out bundle.json` writes the bundle a verifier needs: the JWS, the stored
|
|
405
|
+
record of its key, the issuer, and the disclosures the row still holds (the people, the presentation, the
|
|
406
|
+
statement). Each export is recorded (`approval_seal_exported`); a seal kept after its approver's erasure
|
|
407
|
+
needs `--operator` and `--justification`. A person's own data export also carries their seals' key
|
|
408
|
+
records (`verificationKeys`), and leaves out the requester and what was presented, which are other
|
|
409
|
+
people's data. Seals are not part of a portability export: the operator made them. To verify a seal, `wildo seal verify <bundle.json>` reads `{ jws, keys, expectedIssuer?, disclosures? }`, where each key is its stored record (`publishedVerificationKeys`: kid, public JWK,
|
|
410
|
+
scope, scope id, issuer, state) and calls nothing. It pins ES256 from the key record, ignores any key
|
|
411
|
+
the token names, refuses an organization key used for another tenant, checks each disclosure against
|
|
412
|
+
its commitment, and reports a seal under a compromised key as not provable unless the decision's
|
|
413
|
+
digest was recorded elsewhere before the compromise (`--corroboration <file>`, a
|
|
414
|
+
`{ decisionPayloadDigest, recordedAt }` you hold), or a signing-log export you kept from before it lists
|
|
415
|
+
the seal. The bundle is the platform's file, so none of that evidence is read from it: give your own,
|
|
416
|
+
`wildo seal verify <bundle.json> --pins <pins.json> --signing-log-exports <files…>`; it then trusts the seal key only if you pinned it, takes
|
|
417
|
+
the key's state from your pin, and says which evidence corroborated a compromised key's seal.
|
|
418
|
+
|
|
419
|
+
## Pinning your keys
|
|
420
|
+
|
|
421
|
+
The host holds the keys and publishes their public halves, so on its own your application can only
|
|
422
|
+
believe the keys the host serves. A **pin set** is your statement of which keys are yours:
|
|
423
|
+
`keyManagement.pins[<purpose>]`, one entry per key, never pruned (a retired key keeps verifying what it
|
|
424
|
+
signed):
|
|
425
|
+
|
|
426
|
+
- `kid`: the key's RFC 7638 thumbprint, the `kid` the platform names it by;
|
|
427
|
+
- `state`: ACTIVE, NEXT, RETIRED or COMPROMISED, and for a COMPROMISED key its `compromiseInstant`;
|
|
428
|
+
- `scope` and `scopeId`: the application (or the organization, for an organization key).
|
|
429
|
+
|
|
430
|
+
Only a signing purpose the platform keyring holds can be pinned: `approval_seal` and
|
|
431
|
+
`signing_log_export`. Where a purpose has a pin set, a key signs or is promoted only when its pin says
|
|
432
|
+
ACTIVE or NEXT: a key the set does not list, or lists RETIRED or COMPROMISED, is refused
|
|
433
|
+
`key_not_pinned` (retried by the relay, which keeps the seal PENDING until you pin). Pinning a key
|
|
434
|
+
COMPROMISED therefore stops it signing even before the platform's operator rotates it. A keyring's first
|
|
435
|
+
version under a pin set is made NEXT, never ACTIVE, and signs once you pin it. An emergency rotation
|
|
436
|
+
still stops the leaked key at once; the keyring then signs nothing until you pin its NEXT key. Every
|
|
437
|
+
change to your pin set the platform takes up is recorded on its audit trail at HIGH risk, naming the
|
|
438
|
+
keys added, removed or restated: a change you did not commit shows there.
|
|
439
|
+
|
|
440
|
+
Change the pin set only by a person's commit to your repository, and take each key from a channel the
|
|
441
|
+
host does not control: your own KMS account's public-key export, for a key a provider you hold the
|
|
442
|
+
account of keeps. With the engine's default LOCAL provider there is no such channel: the host makes and
|
|
443
|
+
holds the key, and the only place its public half exists is what the host publishes. Your pin then
|
|
444
|
+
records the key the host showed you when you pinned it (trust on first use, at every rotation). It still
|
|
445
|
+
catches a key changed after you pinned, but not a host that was already dishonest when you looked. For
|
|
446
|
+
keys you can check independently, bind the purpose to a KMS, Vault or HSM account you hold. `wildo keys thumbprint <public key file>` prints the `kid` of a PEM or JWK public key
|
|
447
|
+
and a pin entry to complete. Publish the same JSON (`{ "approval_seal": { "keys": [...] }, … }`) from
|
|
448
|
+
your own domain for your verifiers; never point them at your application's JWKS for it.
|
|
449
|
+
|
|
450
|
+
## Holding the signing log yourself
|
|
451
|
+
|
|
452
|
+
The platform records every signature it makes for your application in a hash-chained **signing log**:
|
|
453
|
+
each entry carries the previous one's hash, so an entry inserted, edited or removed breaks every hash
|
|
454
|
+
after it. The log lives on the host. You hold it independently by pulling **exports**, signed under the
|
|
455
|
+
`signing_log_export` purpose (its own key, `typ: signing-log+jws`, never the seal key):
|
|
456
|
+
|
|
457
|
+
| you want | command |
|
|
458
|
+
|---|---|
|
|
459
|
+
| pull the entries since your last pull | `wildo seal log-export --after <last throughSequence> --out <file>` |
|
|
460
|
+
| check your exports against each other | `wildo seal log-verify --exports <files…> --pins <pins.json>` |
|
|
461
|
+
|
|
462
|
+
Keep every export where the host cannot rewrite it. Each one carries the chain's head when it was made,
|
|
463
|
+
so a later export that disagrees with a kept one at any sequence shows that the log's past was
|
|
464
|
+
rewritten, and a later head behind an earlier one shows that the log was cut short. An export also
|
|
465
|
+
bounds backdating after a compromise: a seal an earlier export lists was made before that export was
|
|
466
|
+
signed, so it is corroborated even if its key leaked later. Backdating is therefore possible only within
|
|
467
|
+
the time since your last pull.
|
|
468
|
+
|
|
469
|
+
Each pull also **reconciles** the export's seal signatures with the seals your application stores. Only
|
|
470
|
+
a signature your application stores counts as accounted for. The others are printed, and
|
|
471
|
+
`wildo seal log-export` exits non-zero:
|
|
472
|
+
|
|
473
|
+
- **unaccounted**: no stored seal has the decision; the platform made a signature your application
|
|
474
|
+
does not hold;
|
|
475
|
+
- **re-signed**: the decision is stored under another signature of it. A backdated re-signature of a real
|
|
476
|
+
decision looks like this; so does a signature your backend is still writing, which pulling the same
|
|
477
|
+
range again shows as stored.
|
|
478
|
+
|
|
479
|
+
A seal whose evidence was deliberately destroyed with its record also shows as unaccounted for now.
|
|
480
|
+
An export is dated by the instant it states for itself, so `wildo seal verify` corroborates from your
|
|
481
|
+
exports only when they agree with each other; give it every export you kept.
|
|
482
|
+
|
|
483
|
+
If you host your own platform, you are your own host: your pin set and your exports then add nothing
|
|
484
|
+
against yourself, and their value is to the people you show them to.
|
|
485
|
+
|
|
486
|
+
## Rotation
|
|
487
|
+
|
|
488
|
+
The keyring keeps an ACTIVE version that signs and a NEXT version every verifier already holds. A
|
|
489
|
+
due rotation is reported on the audit trail and counted on `key_management_rotation_due_total`,
|
|
490
|
+
never performed silently. The platform checks every keyring hourly whether or not anything signs with
|
|
491
|
+
it: a due rotation is reported, and a retired version's private half is destroyed once no request can
|
|
492
|
+
still be the same request (seven days). A retired signing key is also disabled at its provider when it
|
|
493
|
+
retires. The platform operator rotates, in one of three ways:
|
|
494
|
+
|
|
495
|
+
| what happened | command |
|
|
496
|
+
|---|---|
|
|
497
|
+
| the key is due | `wildo keys rotate` (refused while NEXT was published less than 15 minutes ago) |
|
|
498
|
+
| the key may have leaked | `wildo keys rotate --emergency --since <ISO instant> --reason "<why>"` |
|
|
499
|
+
| the platform's key-encryption root is lost (not leaked) | `wildo keys rotate --root-lost --reason "<why>"`, after restoring from backup has failed |
|
|
500
|
+
|
|
501
|
+
Every seal already made keeps verifying after each of them: a rotated, destroyed or compromised
|
|
502
|
+
key's public half stays in your application.
|
|
503
|
+
|
|
504
|
+
Your stored secrets (SSO client secrets, TOTP seeds, provider credentials, SIEM export credentials)
|
|
505
|
+
are sealed under data keys that the `sealed_secrets` key wraps. After any rotation of that key, your
|
|
506
|
+
backend re-wraps its data keys within five minutes. After an emergency rotation it also marks every
|
|
507
|
+
data key the leaked version wrapped as exposed (`applicationDataKeys.exposedAt`), stops sealing with
|
|
508
|
+
them, and seals every stored secret under them again under a fresh data key. Your code does nothing for
|
|
509
|
+
this. A secret queued for delivery keeps its old seal until it is sent. The re-seal protects only
|
|
510
|
+
against copies of your tables taken after it, so if the leak may have reached your data, also rotate
|
|
511
|
+
those credentials with their vendors.
|
|
512
|
+
|
|
513
|
+
## The configuration section
|
|
514
|
+
|
|
515
|
+
## Import Origins
|
|
516
|
+
|
|
517
|
+
- `@wildo-ai/saas-models`
|
|
518
|
+
|
|
519
|
+
## Source Excerpts
|
|
520
|
+
|
|
521
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
522
|
+
|
|
523
|
+
```typescript
|
|
524
|
+
/**
|
|
525
|
+
* Which provider and which key serve one purpose, in an application's `keyManagement.bindings`. Every field is optional
|
|
526
|
+
* except the provider: an absent scope is the purpose's default scope, an absent custody is the purpose's first, and an
|
|
527
|
+
* absent floor is the engine's.
|
|
528
|
+
*/
|
|
529
|
+
export const KeyManagementBindingSchema = z.strictObject({
|
|
530
|
+
/** `wildo-local` (the engine's own provider), or a provider the application declares with `KEY_MANAGEMENT`. */
|
|
531
|
+
provider: z.string().min(1),
|
|
532
|
+
/**
|
|
533
|
+
* The logical name the provider files the key's versions under; absent, the keyring names it. Never a vendor key id:
|
|
534
|
+
* every rotation makes a new vendor key or version under this name (a Vault key, a Google Cloud KMS CryptoKey, the
|
|
535
|
+
* `wildo:key-ref` tag on AWS KMS keys, the label of PKCS#11 objects, a hash in Azure key names).
|
|
536
|
+
*/
|
|
537
|
+
keyRef: z.string().min(1).optional(),
|
|
538
|
+
/** One of the purpose's declared scopes; `organization` gives every organization a dedicated key. */
|
|
539
|
+
scope: z.enum(CryptoKey_Scope).optional(),
|
|
540
|
+
custody: z.enum(CryptoKey_Custody).optional(),
|
|
541
|
+
/** A raised floor. May raise the engine's floor on any axis, never lower it. */
|
|
542
|
+
floor: CryptoKeyFloorSchema.optional(),
|
|
543
|
+
});
|
|
544
|
+
export type KeyManagementBinding = z.infer<typeof KeyManagementBindingSchema>;
|
|
545
|
+
|
|
546
|
+
/**
|
|
547
|
+
* One key the application's OPERATOR has pinned (#2932): its `kid`, which for a signing key is the RFC 7638 thumbprint of
|
|
548
|
+
* its public half, so a verifier that computes the thumbprint of a key it was handed (from a bundle, from the host's
|
|
549
|
+
* JWKS) knows whether the operator vouched for it. The pin's state and compromise instant are the operator's statement
|
|
550
|
+
* and override any the host reports.
|
|
551
|
+
*/
|
|
552
|
+
export const CryptoKeyPinSchema = z.strictObject({
|
|
553
|
+
/** The key's RFC 7638 thumbprint (base64url SHA-256, 43 characters). */
|
|
554
|
+
kid: z.string().regex(/^[A-Za-z0-9_-]{43}$/),
|
|
555
|
+
state: z.enum(CryptoKey_VersionState),
|
|
556
|
+
scope: z.enum(CryptoKey_Scope),
|
|
557
|
+
/** The application's id for an application-scoped key, the organization's for an organization-scoped one. */
|
|
558
|
+
scopeId: z.string().min(1),
|
|
559
|
+
/** ISO 8601, required for a COMPROMISED key: the earliest instant its private half may have been exposed. */
|
|
560
|
+
compromiseInstant: z.iso.datetime({ offset: true }).optional(),
|
|
561
|
+
});
|
|
562
|
+
export type CryptoKeyPin = z.infer<typeof CryptoKeyPinSchema>;
|
|
563
|
+
|
|
564
|
+
/**
|
|
565
|
+
* The keys an operator has pinned for one purpose (#2932), as the application's `keyManagement.pins[purpose]` declares
|
|
566
|
+
* them and as the operator publishes them to third parties (from its own domain, never the host's JWKS).
|
|
567
|
+
*
|
|
568
|
+
* Changed only by a person's commit to the application's repository: it is the operator's statement about which keys
|
|
569
|
+
* are theirs, so it is never derived from the endpoint it checks, and it is never pruned (a retired key keeps verifying
|
|
570
|
+
* the seals it made). Where it is declared, the platform promotes no NEXT key it does not list, and signs with no key
|
|
571
|
+
* it does not list as ACTIVE or NEXT.
|
|
572
|
+
*
|
|
573
|
+
* **A critical gate point** (`one-source-of-truth.md` D5), MARKED here: under the YOLO posture the companion may commit a
|
|
574
|
+
* coding run's edit of this section, under its own author identity, and nothing refuses it. What notifies is where the
|
|
575
|
+
* platform takes the change up: every stored change is a HIGH `platform_configuration_publication` row naming the kids
|
|
576
|
+
* (`diffCryptoKeyPinSets`). Arming the gate (refusing a pin change no person committed) is part of Gate 3.
|
|
577
|
+
*/
|
|
578
|
+
export const CryptoKeyPinSetSchema = z
|
|
579
|
+
.strictObject({
|
|
580
|
+
keys: z.array(CryptoKeyPinSchema).min(1),
|
|
581
|
+
})
|
|
582
|
+
.refine((pinSet) => new Set(pinSet.keys.map((pin) => pin.kid)).size === pinSet.keys.length, { message: 'A key is pinned once.' })
|
|
583
|
+
.refine((pinSet) => pinSet.keys.every((pin) => (pin.state === CryptoKey_VersionState.COMPROMISED) === (pin.compromiseInstant !== undefined)), {
|
|
584
|
+
message: 'A COMPROMISED pin carries its compromise instant, and only a COMPROMISED pin does.',
|
|
585
|
+
});
|
|
586
|
+
export type CryptoKeyPinSet = z.infer<typeof CryptoKeyPinSetSchema>;
|
|
587
|
+
|
|
588
|
+
/**
|
|
589
|
+
* The operator's pin sets, per purpose (#2932): the shape of `keyManagement.pins`, and of the file the operator keeps and
|
|
590
|
+
* publishes (its own `.well-known`, a verification bundle) for verifiers to read. One shape, so the file is the config's.
|
|
591
|
+
*/
|
|
592
|
+
export const CryptoKeyPinSetsSchema = z.partialRecord(z.enum(CryptoKey_Purpose), CryptoKeyPinSetSchema);
|
|
593
|
+
export type CryptoKeyPinSets = z.infer<typeof CryptoKeyPinSetsSchema>;
|
|
594
|
+
|
|
595
|
+
/** What changed in one purpose's pin set between two configurations (#2932): kids named only, never a key. */
|
|
596
|
+
export interface CryptoKeyPinChange {
|
|
597
|
+
readonly purpose: CryptoKey_Purpose;
|
|
598
|
+
readonly added: readonly string[];
|
|
599
|
+
/** A pin removed. The pin set is never pruned, so a removal is itself worth a look. */
|
|
600
|
+
readonly removed: readonly string[];
|
|
601
|
+
readonly restated: ReadonlyArray<{ readonly kid: string; readonly from: CryptoKey_VersionState; readonly to: CryptoKey_VersionState }>;
|
|
602
|
+
}
|
|
603
|
+
|
|
604
|
+
/**
|
|
605
|
+
* The pin changes between two `keyManagement.pins`, one per purpose that changed (#2932). A pin change is a critical gate
|
|
606
|
+
* point (`one-source-of-truth.md` D5): the platform records every one it stores, at HIGH risk, naming the kids, so a
|
|
607
|
+
* change that did not come from the operator's own commit is visible where the platform takes it up.
|
|
608
|
+
*/
|
|
609
|
+
export function diffCryptoKeyPinSets(before: CryptoKeyPinSets | undefined, after: CryptoKeyPinSets | undefined): CryptoKeyPinChange[] {
|
|
610
|
+
const changes: CryptoKeyPinChange[] = [];
|
|
611
|
+
for (const purpose of Object.values(CryptoKey_Purpose)) {
|
|
612
|
+
const previous = new Map((before?.[purpose]?.keys ?? []).map((pin) => [pin.kid, pin.state]));
|
|
613
|
+
const next = new Map((after?.[purpose]?.keys ?? []).map((pin) => [pin.kid, pin.state]));
|
|
614
|
+
const added = [...next.keys()].filter((kid) => !previous.has(kid));
|
|
615
|
+
const removed = [...previous.keys()].filter((kid) => !next.has(kid));
|
|
616
|
+
const restated = [...next.entries()].flatMap(([kid, to]) => {
|
|
617
|
+
const from = previous.get(kid);
|
|
618
|
+
return from !== undefined && from !== to ? [{ kid, from, to }] : [];
|
|
619
|
+
});
|
|
620
|
+
if (added.length + removed.length + restated.length > 0) changes.push({ purpose, added, removed, restated });
|
|
621
|
+
}
|
|
622
|
+
return changes;
|
|
623
|
+
}
|
|
624
|
+
|
|
625
|
+
/** Whether a purpose's keys can be pinned: a signing purpose held in the platform keyring, whose public half is published. */
|
|
626
|
+
export function cryptoKeyPurposeIsPinnable(purpose: CryptoKey_Purpose): boolean {
|
|
627
|
+
const descriptor = CRYPTO_KEY_PURPOSE_DESCRIPTORS[purpose];
|
|
628
|
+
return descriptor.holding === CryptoKey_Holding.PLATFORM_KEYRING && descriptor.jwsTypes.length > 0;
|
|
629
|
+
}
|
|
630
|
+
|
|
631
|
+
/** The application's `keyManagement` section: one binding per purpose it wants served other than by default. */
|
|
632
|
+
export const KeyManagementConfigurationSchema = z
|
|
633
|
+
.strictObject({
|
|
634
|
+
bindings: z.partialRecord(z.enum(CryptoKey_Purpose), KeyManagementBindingSchema).default({}),
|
|
635
|
+
/** The keys the operator has pinned, per purpose (#2932). Absent: no pin policy, and the platform promotes as it rotates. */
|
|
636
|
+
pins: CryptoKeyPinSetsSchema.optional(),
|
|
637
|
+
})
|
|
638
|
+
.refine((configuration) => Object.keys(configuration.pins ?? {}).every((purpose) => cryptoKeyPurposeIsPinnable(purpose as CryptoKey_Purpose)), {
|
|
639
|
+
message: 'Only a signing purpose held in the platform keyring can be pinned.',
|
|
640
|
+
});
|
|
641
|
+
export type KeyManagementConfiguration = z.infer<typeof KeyManagementConfigurationSchema>;
|
|
642
|
+
```
|
|
643
|
+
|
|
644
|
+
## The purposes
|
|
645
|
+
|
|
646
|
+
## Import Origins
|
|
647
|
+
|
|
648
|
+
- `@wildo-ai/saas-models`
|
|
649
|
+
|
|
650
|
+
## Source Excerpts
|
|
651
|
+
|
|
652
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
653
|
+
|
|
654
|
+
```typescript
|
|
655
|
+
/**
|
|
656
|
+
* What a key is FOR. A closed vocabulary: each member has exactly one descriptor in `CRYPTO_KEY_PURPOSE_DESCRIPTORS`, and
|
|
657
|
+
* a key serves exactly one purpose (a key reused across purposes lets a signature made for one be replayed as the other).
|
|
658
|
+
*/
|
|
659
|
+
export enum CryptoKey_Purpose {
|
|
660
|
+
/**
|
|
661
|
+
* Signs an approval seal (#2903): a compact JWS binding a decision (who decided what, on which bytes, when) so a third
|
|
662
|
+
* party can verify it offline, years later, without asking the platform. Held by apps-manager; the application asks for
|
|
663
|
+
* a signature and never holds the key.
|
|
664
|
+
*/
|
|
665
|
+
APPROVAL_SEAL = 'approval_seal',
|
|
666
|
+
/**
|
|
667
|
+
* Signs apps-manager's answers to the runtimes it configures (#2921): configuration, secrets, bootstrap material and
|
|
668
|
+
* keyring status, each bound to the request that asked. One key for the whole hosting platform.
|
|
669
|
+
*/
|
|
670
|
+
PLATFORM_RESPONSE_INTEGRITY = 'platform_response_integrity',
|
|
671
|
+
/**
|
|
672
|
+
* Signs the tokens an application issues to its users and clients (#2892): session, delegated and machine access
|
|
673
|
+
* tokens, refresh tokens and OpenID Connect ID tokens, each kind under its own `typ`
|
|
674
|
+
* ({@link ApplicationAuthTokenJwsType}). Its public half is the application's `/oauth/jwks`.
|
|
675
|
+
*/
|
|
676
|
+
APPLICATION_AUTH_TOKEN = 'application_auth_token',
|
|
677
|
+
/** Signs the application's outbound webhook deliveries (#2892); receivers verify with its public half. */
|
|
678
|
+
APPLICATION_WEBHOOK = 'application_webhook',
|
|
679
|
+
/** Signs the application's requests to platform services (the scheduler); never published (#2892). */
|
|
680
|
+
APPLICATION_PLATFORM_REQUEST = 'application_platform_request',
|
|
681
|
+
/** Signs the application backend's requests to its own worker runtimes; never published. */
|
|
682
|
+
APPLICATION_WORKER_REQUEST = 'application_worker_request',
|
|
683
|
+
/**
|
|
684
|
+
* MACs an agent's request for a person's approval of a tool call, so a client cannot forge the approval of a call
|
|
685
|
+
* nobody proposed (#2893). Held by the backend and the minions, which both run agents.
|
|
686
|
+
*/
|
|
687
|
+
TOOL_APPROVAL_SIGNING = 'tool_approval_signing',
|
|
688
|
+
/** MACs a proof-of-work challenge the application issues to a public form, so it cannot be minted by the client (#2893). */
|
|
689
|
+
SUBMISSION_CHALLENGE = 'submission_challenge',
|
|
690
|
+
/**
|
|
691
|
+
* Keys the id of what a person was shown before deciding (#2893), so an answer names the exact presentation it was given
|
|
692
|
+
* and a stale card is refused. Held by the backend and the minions, which both present decisions.
|
|
693
|
+
*/
|
|
694
|
+
DECISION_PRESENTATION_ID = 'decision_presentation_id',
|
|
695
|
+
/**
|
|
696
|
+
* Derives, per organization, the key of the digests a decision record keeps of an agent's proposal and of the version a
|
|
697
|
+
* person kept (#2893): nobody without the key can test a guess, and two tenants' digests never join.
|
|
698
|
+
*/
|
|
699
|
+
AGENT_WORK_CORRECTION_DIGEST = 'agent_work_correction_digest',
|
|
700
|
+
/** Derives, per organization, the key of the pseudonyms an evaluation export writes in place of identifiers (#2893). */
|
|
701
|
+
EVALUATION_PSEUDONYM = 'evaluation_pseudonym',
|
|
702
|
+
/** MACs a queued SIEM delivery job over its envelope and its destination, so a rewritten job is dead-lettered (#2893). */
|
|
703
|
+
SIEM_DELIVERY_INTEGRITY = 'siem_delivery_integrity',
|
|
704
|
+
/** Keys the fingerprint that tells which SIEM jobs share a destination, without revealing the destination (#2893). */
|
|
705
|
+
SIEM_DESTINATION_FINGERPRINT = 'siem_destination_fingerprint',
|
|
706
|
+
/**
|
|
707
|
+
* Keys the digest of a remote record whose local copy was erased, so the next pipeline run does not import it again
|
|
708
|
+
* (#2893). Never rotates: a suppression stored under one key cannot be matched under another, and the engine refuses
|
|
709
|
+
* to run a pipeline over suppressions it can no longer match.
|
|
710
|
+
*/
|
|
711
|
+
EXTERNAL_DATA_ERASURE_SUPPRESSION = 'external_data_erasure_suppression',
|
|
712
|
+
/**
|
|
713
|
+
* Wraps the data keys that seal the application's stored secrets (#2894): provider credentials, SSO client secrets,
|
|
714
|
+
* SIEM credentials, TOTP seeds and the provider access-token cache. The wrapping key never leaves its custodian; a
|
|
715
|
+
* data key is unwrapped for the runtimes allowed to ask and held in their memory. Rotating this purpose re-wraps the
|
|
716
|
+
* data keys, never the values they seal.
|
|
717
|
+
*/
|
|
718
|
+
SEALED_SECRETS = 'sealed_secrets',
|
|
719
|
+
/**
|
|
720
|
+
* Signs an export of the application's signing log (#2932): a range of its hash-chained entries and the chain's head,
|
|
721
|
+
* which the operator pulls into storage the host does not control. A kept export detects any entry later inserted into
|
|
722
|
+
* the log's past, and corroborates a seal it lists against a compromise after it. Its own key, never the seal key, and
|
|
723
|
+
* only the custodian signs with it: no runtime may ask it to sign claims of its own.
|
|
724
|
+
*/
|
|
725
|
+
SIGNING_LOG_EXPORT = 'signing_log_export',
|
|
726
|
+
}
|
|
727
|
+
```
|
|
728
|
+
|
|
729
|
+
## What a purpose's descriptor decides
|
|
730
|
+
|
|
731
|
+
## Import Origins
|
|
732
|
+
|
|
733
|
+
- `@wildo-ai/saas-models`
|
|
734
|
+
|
|
735
|
+
## Source Excerpts
|
|
736
|
+
|
|
737
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
738
|
+
|
|
739
|
+
```typescript
|
|
740
|
+
/** Everything the engine knows about a purpose. One per `CryptoKey_Purpose` member; nothing else decides these. */
|
|
741
|
+
export interface CryptoKeyPurposeDescriptor {
|
|
742
|
+
readonly primitive: CryptoKey_Primitive;
|
|
743
|
+
/**
|
|
744
|
+
* The JWS `typ` values signatures of this purpose carry (RFC 8725 §3.11, explicit typing), so a signature made for one
|
|
745
|
+
* purpose can never be accepted as another's: each verifier checks the one it expects. One for most purposes; the
|
|
746
|
+
* auth-token key signs three kinds of token ({@link ApplicationAuthTokenJwsType}). Disjoint across purposes. Empty
|
|
747
|
+
* exactly when the primitive signs nothing (a MAC key, #2893).
|
|
748
|
+
*/
|
|
749
|
+
readonly jwsTypes: readonly string[];
|
|
750
|
+
/** Where the private key is held: the platform keyring, the custodian's environment, or the application's secrets. */
|
|
751
|
+
readonly holding: CryptoKey_Holding;
|
|
752
|
+
/** The scopes a key of this purpose may have; the first is the default, provisioned with no configuration. */
|
|
753
|
+
readonly scopes: readonly [CryptoKey_Scope, ...CryptoKey_Scope[]];
|
|
754
|
+
readonly publication: CryptoKey_Publication;
|
|
755
|
+
readonly rotationClass: CryptoKey_RotationClass;
|
|
756
|
+
/**
|
|
757
|
+
* How long one version may be used to sign or seal, in days (NIST SP 800-57 Part 1 Rev 5 §5.3.6, Table 1). Reaching it
|
|
758
|
+
* raises a rotation-due audit event (WARNING, once per version) and counts it on `key_management_rotation_due_total`;
|
|
759
|
+
* it never stops the key working. Not a readiness signal: readiness says whether a process can serve, and a key past
|
|
760
|
+
* its cryptoperiod still signs. `null` exactly for a {@link CryptoKey_RotationClass.NON_ROTATING} purpose: a key that
|
|
761
|
+
* must never change has no period after which it is due to.
|
|
762
|
+
*/
|
|
763
|
+
readonly cryptoperiodDays: number | null;
|
|
764
|
+
/** The custodies a binding of this purpose may name. */
|
|
765
|
+
readonly custodies: readonly [CryptoKey_Custody, ...CryptoKey_Custody[]];
|
|
766
|
+
/**
|
|
767
|
+
* The runtimes that may retrieve the key's plaintext and use it themselves. Empty for a key only its custodian or
|
|
768
|
+
* provider ever uses; non-empty only when the engine floor allows retrieval.
|
|
769
|
+
*/
|
|
770
|
+
readonly heldBy: readonly CryptoKey_Runtime[];
|
|
771
|
+
/** The runtime principals that may ASK for a signature (through the custodian's signing proxy). */
|
|
772
|
+
readonly mayRequestSignature: readonly CryptoKey_Runtime[];
|
|
773
|
+
/**
|
|
774
|
+
* The runtime principals that may ask the custodian for a data key wrapped under this purpose, or to unwrap one (#2894).
|
|
775
|
+
* Non-empty only for a wrapping primitive; empty everywhere else.
|
|
776
|
+
*/
|
|
777
|
+
readonly mayRequestDataKeys: readonly CryptoKey_Runtime[];
|
|
778
|
+
/** The engine's floor; an application may raise it, never lower it. */
|
|
779
|
+
readonly engineFloor: CryptoKeyFloor;
|
|
780
|
+
}
|
|
781
|
+
|
|
782
|
+
/**
|
|
783
|
+
* The descriptor of every purpose. Total by construction: a new `CryptoKey_Purpose` member without a descriptor is a
|
|
784
|
+
* compile error here.
|
|
785
|
+
*/
|
|
786
|
+
export const CRYPTO_KEY_PURPOSE_DESCRIPTORS: Readonly<Record<CryptoKey_Purpose, CryptoKeyPurposeDescriptor>> = {
|
|
787
|
+
[CryptoKey_Purpose.APPROVAL_SEAL]: {
|
|
788
|
+
primitive: CryptoKey_Primitive.ES256_SIGNATURE,
|
|
789
|
+
jwsTypes: ['approval-seal+jws'],
|
|
790
|
+
holding: CryptoKey_Holding.PLATFORM_KEYRING,
|
|
791
|
+
// An application-scoped key is the default (provisioned with no configuration); a dedicated per-organization key is
|
|
792
|
+
// the override (Paul, 2026-10-19).
|
|
793
|
+
scopes: [CryptoKey_Scope.APPLICATION, CryptoKey_Scope.ORGANIZATION],
|
|
794
|
+
publication: CryptoKey_Publication.PUBLISHED_VERIFICATION,
|
|
795
|
+
rotationClass: CryptoKey_RotationClass.SIGN_VERIFY,
|
|
796
|
+
// A private signature key: 1 to 3 years (Table 1, row 1); the lower bound.
|
|
797
|
+
cryptoperiodDays: 365,
|
|
798
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
799
|
+
// apps-manager signs; the key never reaches a runtime.
|
|
800
|
+
heldBy: [],
|
|
801
|
+
mayRequestSignature: [CryptoKey_Runtime.APPLICATION_BACKEND],
|
|
802
|
+
mayRequestDataKeys: [],
|
|
803
|
+
// The engine's LOCAL provider is software, so the engine floor does not require a non-extractable key; an
|
|
804
|
+
// application that needs one raises the floor and binds a provider that offers it.
|
|
805
|
+
engineFloor: {
|
|
806
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
807
|
+
materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
|
|
808
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
809
|
+
},
|
|
810
|
+
},
|
|
811
|
+
[CryptoKey_Purpose.PLATFORM_RESPONSE_INTEGRITY]: {
|
|
812
|
+
primitive: CryptoKey_Primitive.ES256_SIGNATURE,
|
|
813
|
+
jwsTypes: ['wildo-runtime-response+jws'],
|
|
814
|
+
holding: CryptoKey_Holding.CUSTODIAN_ENVIRONMENT,
|
|
815
|
+
scopes: [CryptoKey_Scope.PLATFORM],
|
|
816
|
+
publication: CryptoKey_Publication.PUBLISHED_VERIFICATION,
|
|
817
|
+
rotationClass: CryptoKey_RotationClass.SIGN_VERIFY,
|
|
818
|
+
// A private signature key: 1 to 3 years (Table 1, row 1); the lower bound.
|
|
819
|
+
cryptoperiodDays: 365,
|
|
820
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
821
|
+
// apps-manager, its custodian, signs its own answers with it; no runtime holds it, and none may ask for a signature.
|
|
822
|
+
heldBy: [],
|
|
823
|
+
mayRequestSignature: [],
|
|
824
|
+
mayRequestDataKeys: [],
|
|
825
|
+
engineFloor: {
|
|
826
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
827
|
+
materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
|
|
828
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
829
|
+
},
|
|
830
|
+
},
|
|
831
|
+
[CryptoKey_Purpose.APPLICATION_AUTH_TOKEN]: {
|
|
832
|
+
primitive: CryptoKey_Primitive.ES256_SIGNATURE,
|
|
833
|
+
jwsTypes: [ApplicationAuthTokenJwsType.ACCESS, ApplicationAuthTokenJwsType.REFRESH, ApplicationAuthTokenJwsType.ID_TOKEN],
|
|
834
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
835
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
836
|
+
publication: CryptoKey_Publication.PUBLISHED_VERIFICATION,
|
|
837
|
+
rotationClass: CryptoKey_RotationClass.SIGN_VERIFY,
|
|
838
|
+
// A private signature key: 1 to 3 years (Table 1, row 1); the lower bound.
|
|
839
|
+
cryptoperiodDays: 365,
|
|
840
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
841
|
+
// Only the backend issues tokens; minions and workers never receive the key.
|
|
842
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
|
|
843
|
+
mayRequestSignature: [],
|
|
844
|
+
mayRequestDataKeys: [],
|
|
845
|
+
// The runtimes that hold it sign with the retrieved key, so the floor allows retrieval.
|
|
846
|
+
engineFloor: {
|
|
847
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
848
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
849
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
850
|
+
},
|
|
851
|
+
},
|
|
852
|
+
[CryptoKey_Purpose.APPLICATION_WEBHOOK]: {
|
|
853
|
+
primitive: CryptoKey_Primitive.ES256_SIGNATURE,
|
|
854
|
+
jwsTypes: ['wildo-webhook+jwt'],
|
|
855
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
856
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
857
|
+
publication: CryptoKey_Publication.PUBLISHED_VERIFICATION,
|
|
858
|
+
rotationClass: CryptoKey_RotationClass.SIGN_VERIFY,
|
|
859
|
+
// A private signature key: 1 to 3 years (Table 1, row 1); the lower bound.
|
|
860
|
+
cryptoperiodDays: 365,
|
|
861
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
862
|
+
// The backend's delivery batch signs every webhook.
|
|
863
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
|
|
864
|
+
mayRequestSignature: [],
|
|
865
|
+
mayRequestDataKeys: [],
|
|
866
|
+
// The runtimes that hold it sign with the retrieved key, so the floor allows retrieval.
|
|
867
|
+
engineFloor: {
|
|
868
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
869
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
870
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
871
|
+
},
|
|
872
|
+
},
|
|
873
|
+
[CryptoKey_Purpose.APPLICATION_PLATFORM_REQUEST]: {
|
|
874
|
+
primitive: CryptoKey_Primitive.ES256_SIGNATURE,
|
|
875
|
+
jwsTypes: ['wildo-platform-request+jwt'],
|
|
876
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
877
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
878
|
+
publication: CryptoKey_Publication.DISTRIBUTED_TO_VERIFIERS,
|
|
879
|
+
rotationClass: CryptoKey_RotationClass.SIGN_VERIFY,
|
|
880
|
+
// A private signature key: 1 to 3 years (Table 1, row 1); the lower bound.
|
|
881
|
+
cryptoperiodDays: 365,
|
|
882
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
883
|
+
// The backend signs its requests to the scheduler; the platform verifies with the public half apps-manager serves it.
|
|
884
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
|
|
885
|
+
mayRequestSignature: [],
|
|
886
|
+
mayRequestDataKeys: [],
|
|
887
|
+
// The runtimes that hold it sign with the retrieved key, so the floor allows retrieval.
|
|
888
|
+
engineFloor: {
|
|
889
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
890
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
891
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
892
|
+
},
|
|
893
|
+
},
|
|
894
|
+
[CryptoKey_Purpose.APPLICATION_WORKER_REQUEST]: {
|
|
895
|
+
primitive: CryptoKey_Primitive.ES256_SIGNATURE,
|
|
896
|
+
jwsTypes: ['wildo-worker-request+jwt'],
|
|
897
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
898
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
899
|
+
publication: CryptoKey_Publication.DISTRIBUTED_TO_VERIFIERS,
|
|
900
|
+
rotationClass: CryptoKey_RotationClass.SIGN_VERIFY,
|
|
901
|
+
// A private signature key: 1 to 3 years (Table 1, row 1); the lower bound.
|
|
902
|
+
cryptoperiodDays: 365,
|
|
903
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
904
|
+
// The backend signs; each worker holds only the public half, from its bootstrap.
|
|
905
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
|
|
906
|
+
mayRequestSignature: [],
|
|
907
|
+
mayRequestDataKeys: [],
|
|
908
|
+
// The runtimes that hold it sign with the retrieved key, so the floor allows retrieval.
|
|
909
|
+
engineFloor: {
|
|
910
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
911
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
912
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
913
|
+
},
|
|
914
|
+
},
|
|
915
|
+
[CryptoKey_Purpose.TOOL_APPROVAL_SIGNING]: {
|
|
916
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
917
|
+
jwsTypes: [],
|
|
918
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
919
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
920
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
921
|
+
rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
|
|
922
|
+
// A symmetric authentication key: under 2 years (Table 1, row 3); the lower bound of the signing keys'.
|
|
923
|
+
cryptoperiodDays: 365,
|
|
924
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
925
|
+
// Agents run in the backend and in the minions; a resume must verify what a suspension signed.
|
|
926
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND, CryptoKey_Runtime.MINION],
|
|
927
|
+
mayRequestSignature: [],
|
|
928
|
+
mayRequestDataKeys: [],
|
|
929
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
930
|
+
engineFloor: {
|
|
931
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
932
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
933
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
934
|
+
},
|
|
935
|
+
},
|
|
936
|
+
[CryptoKey_Purpose.SUBMISSION_CHALLENGE]: {
|
|
937
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
938
|
+
jwsTypes: [],
|
|
939
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
940
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
941
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
942
|
+
rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
|
|
943
|
+
// A symmetric authentication key: under 2 years (Table 1, row 3); the lower bound of the signing keys'.
|
|
944
|
+
cryptoperiodDays: 365,
|
|
945
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
946
|
+
// Only the backend serves the public forms that issue and check a challenge.
|
|
947
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
|
|
948
|
+
mayRequestSignature: [],
|
|
949
|
+
mayRequestDataKeys: [],
|
|
950
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
951
|
+
engineFloor: {
|
|
952
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
953
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
954
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
955
|
+
},
|
|
956
|
+
},
|
|
957
|
+
[CryptoKey_Purpose.DECISION_PRESENTATION_ID]: {
|
|
958
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
959
|
+
jwsTypes: [],
|
|
960
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
961
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
962
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
963
|
+
rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
|
|
964
|
+
// A symmetric authentication key: under 2 years (Table 1, row 3); the lower bound of the signing keys'.
|
|
965
|
+
cryptoperiodDays: 365,
|
|
966
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
967
|
+
// Decisions are presented by the backend and by the minions' agents, and answered at the backend.
|
|
968
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND, CryptoKey_Runtime.MINION],
|
|
969
|
+
mayRequestSignature: [],
|
|
970
|
+
mayRequestDataKeys: [],
|
|
971
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
972
|
+
engineFloor: {
|
|
973
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
974
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
975
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
976
|
+
},
|
|
977
|
+
},
|
|
978
|
+
[CryptoKey_Purpose.AGENT_WORK_CORRECTION_DIGEST]: {
|
|
979
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
980
|
+
jwsTypes: [],
|
|
981
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
982
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
983
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
984
|
+
rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
|
|
985
|
+
// A key-derivation key: about 1 year (Table 1, row 9).
|
|
986
|
+
cryptoperiodDays: 365,
|
|
987
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
988
|
+
// Decision records are written wherever an agent's work is decided: the backend and the minions.
|
|
989
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND, CryptoKey_Runtime.MINION],
|
|
990
|
+
mayRequestSignature: [],
|
|
991
|
+
mayRequestDataKeys: [],
|
|
992
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
993
|
+
engineFloor: {
|
|
994
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
995
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
996
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
997
|
+
},
|
|
998
|
+
},
|
|
999
|
+
[CryptoKey_Purpose.EVALUATION_PSEUDONYM]: {
|
|
1000
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
1001
|
+
jwsTypes: [],
|
|
1002
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
1003
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
1004
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
1005
|
+
rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
|
|
1006
|
+
// A key-derivation key: about 1 year (Table 1, row 9).
|
|
1007
|
+
cryptoperiodDays: 365,
|
|
1008
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
1009
|
+
// Only the backend serves the evaluation export.
|
|
1010
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND],
|
|
1011
|
+
mayRequestSignature: [],
|
|
1012
|
+
mayRequestDataKeys: [],
|
|
1013
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
1014
|
+
engineFloor: {
|
|
1015
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
1016
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
1017
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
1018
|
+
},
|
|
1019
|
+
},
|
|
1020
|
+
[CryptoKey_Purpose.SIEM_DELIVERY_INTEGRITY]: {
|
|
1021
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
1022
|
+
jwsTypes: [],
|
|
1023
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
1024
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
1025
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
1026
|
+
rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
|
|
1027
|
+
// A symmetric authentication key: under 2 years (Table 1, row 3); the lower bound of the signing keys'.
|
|
1028
|
+
cryptoperiodDays: 365,
|
|
1029
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
1030
|
+
// Every runtime that emits an audit event enqueues SIEM jobs; the delivery worker verifies them.
|
|
1031
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND, CryptoKey_Runtime.MINION],
|
|
1032
|
+
mayRequestSignature: [],
|
|
1033
|
+
mayRequestDataKeys: [],
|
|
1034
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
1035
|
+
engineFloor: {
|
|
1036
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
1037
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
1038
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
1039
|
+
},
|
|
1040
|
+
},
|
|
1041
|
+
[CryptoKey_Purpose.SIEM_DESTINATION_FINGERPRINT]: {
|
|
1042
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
1043
|
+
jwsTypes: [],
|
|
1044
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
1045
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
1046
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
1047
|
+
rotationClass: CryptoKey_RotationClass.MATCH_ALL_RETAINED,
|
|
1048
|
+
// A symmetric authentication key: under 2 years (Table 1, row 3); the lower bound of the signing keys'.
|
|
1049
|
+
cryptoperiodDays: 365,
|
|
1050
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
1051
|
+
// Computed by the delivery worker, which runs wherever the audit dispatcher does.
|
|
1052
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND, CryptoKey_Runtime.MINION],
|
|
1053
|
+
mayRequestSignature: [],
|
|
1054
|
+
mayRequestDataKeys: [],
|
|
1055
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
1056
|
+
engineFloor: {
|
|
1057
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
1058
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
1059
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
1060
|
+
},
|
|
1061
|
+
},
|
|
1062
|
+
[CryptoKey_Purpose.EXTERNAL_DATA_ERASURE_SUPPRESSION]: {
|
|
1063
|
+
primitive: CryptoKey_Primitive.HMAC_SHA256,
|
|
1064
|
+
jwsTypes: [],
|
|
1065
|
+
holding: CryptoKey_Holding.APPLICATION_SECRETS,
|
|
1066
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
1067
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
1068
|
+
rotationClass: CryptoKey_RotationClass.NON_ROTATING,
|
|
1069
|
+
// Never rotates, so no cryptoperiod applies.
|
|
1070
|
+
cryptoperiodDays: null,
|
|
1071
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
1072
|
+
// Pipeline runs and the resources registry match suppressions in the backend and in the minions.
|
|
1073
|
+
heldBy: [CryptoKey_Runtime.APPLICATION_BACKEND, CryptoKey_Runtime.MINION],
|
|
1074
|
+
mayRequestSignature: [],
|
|
1075
|
+
mayRequestDataKeys: [],
|
|
1076
|
+
// The runtimes that hold it compute with the retrieved key, so the floor allows retrieval.
|
|
1077
|
+
engineFloor: {
|
|
1078
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
1079
|
+
materialAccess: CryptoKey_MaterialAccess.RETRIEVAL_ALLOWED,
|
|
1080
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
1081
|
+
},
|
|
1082
|
+
},
|
|
1083
|
+
[CryptoKey_Purpose.SEALED_SECRETS]: {
|
|
1084
|
+
primitive: CryptoKey_Primitive.AES_256_GCM_DATA_KEY,
|
|
1085
|
+
jwsTypes: [],
|
|
1086
|
+
holding: CryptoKey_Holding.PLATFORM_KEYRING,
|
|
1087
|
+
// Application scope only: some sealed values name no organization (an application's own SSO configuration, a user's
|
|
1088
|
+
// credentials), so an organization-bound sealing key needs a per-value scope rule first (#2894 follow-up, with #2919).
|
|
1089
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
1090
|
+
publication: CryptoKey_Publication.PRIVATE,
|
|
1091
|
+
// A data key wrapped under a retired version is re-wrapped under the new one; the old version is destroyed once none
|
|
1092
|
+
// is left (and the queue, dead-letter and backup retention has passed).
|
|
1093
|
+
rotationClass: CryptoKey_RotationClass.RESEAL,
|
|
1094
|
+
// A symmetric key-wrapping key: under 2 years (Table 1, row 7); the lower bound of the other keys'.
|
|
1095
|
+
cryptoperiodDays: 365,
|
|
1096
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
1097
|
+
// The wrapping key itself never leaves the custodian.
|
|
1098
|
+
heldBy: [],
|
|
1099
|
+
mayRequestSignature: [],
|
|
1100
|
+
// The backend and the minions open provider credentials and the other sealed secrets; workers never do.
|
|
1101
|
+
mayRequestDataKeys: [CryptoKey_Runtime.APPLICATION_BACKEND, CryptoKey_Runtime.MINION],
|
|
1102
|
+
engineFloor: {
|
|
1103
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
1104
|
+
materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
|
|
1105
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
1106
|
+
},
|
|
1107
|
+
},
|
|
1108
|
+
[CryptoKey_Purpose.SIGNING_LOG_EXPORT]: {
|
|
1109
|
+
primitive: CryptoKey_Primitive.ES256_SIGNATURE,
|
|
1110
|
+
jwsTypes: ['signing-log+jws'],
|
|
1111
|
+
holding: CryptoKey_Holding.PLATFORM_KEYRING,
|
|
1112
|
+
// One signing log per application, so one export key per application.
|
|
1113
|
+
scopes: [CryptoKey_Scope.APPLICATION],
|
|
1114
|
+
// An export is verified offline, years later, like a seal: its public half is published to the application.
|
|
1115
|
+
publication: CryptoKey_Publication.PUBLISHED_VERIFICATION,
|
|
1116
|
+
rotationClass: CryptoKey_RotationClass.SIGN_VERIFY,
|
|
1117
|
+
// A private signature key: 1 to 3 years (Table 1, row 1); the lower bound.
|
|
1118
|
+
cryptoperiodDays: 365,
|
|
1119
|
+
custodies: [CryptoKey_Custody.PLATFORM],
|
|
1120
|
+
heldBy: [],
|
|
1121
|
+
// The custodian signs an export it builds itself from its own log; no runtime may ask it to sign claims.
|
|
1122
|
+
mayRequestSignature: [],
|
|
1123
|
+
mayRequestDataKeys: [],
|
|
1124
|
+
engineFloor: {
|
|
1125
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
1126
|
+
materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
|
|
1127
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
1128
|
+
},
|
|
1129
|
+
},
|
|
1130
|
+
};
|
|
1131
|
+
```
|
|
1132
|
+
|
|
1133
|
+
## Floors
|
|
1134
|
+
|
|
1135
|
+
## Import Origins
|
|
1136
|
+
|
|
1137
|
+
- `@wildo-ai/saas-models`
|
|
1138
|
+
|
|
1139
|
+
## Source Excerpts
|
|
1140
|
+
|
|
1141
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
1142
|
+
|
|
1143
|
+
```typescript
|
|
1144
|
+
/**
|
|
1145
|
+
* The least protection a purpose's key accepts. The engine sets one per purpose; an application may RAISE it in its
|
|
1146
|
+
* `keyManagement` configuration, never lower it. Each axis is ordered: a floor is met when every axis is at least the
|
|
1147
|
+
* floor's.
|
|
1148
|
+
*/
|
|
1149
|
+
export interface CryptoKeyFloor {
|
|
1150
|
+
readonly protectionLevel: CryptoKey_ProtectionLevel;
|
|
1151
|
+
readonly materialAccess: CryptoKey_MaterialAccess;
|
|
1152
|
+
readonly provenance: CryptoKey_MaterialProvenance;
|
|
1153
|
+
}
|
|
1154
|
+
```
|
|
1155
|
+
|
|
1156
|
+
## The engine's own provider
|
|
1157
|
+
|
|
1158
|
+
## Import Origins
|
|
1159
|
+
|
|
1160
|
+
- `@wildo-ai/saas-models`
|
|
1161
|
+
|
|
1162
|
+
## Source Excerpts
|
|
1163
|
+
|
|
1164
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
1165
|
+
|
|
1166
|
+
```typescript
|
|
1167
|
+
/**
|
|
1168
|
+
* The engine's own key provider, which serves every purpose no binding names (#2891). It needs nothing installed: it
|
|
1169
|
+
* makes software keys and keeps them sealed under the platform's encryption root, held by apps-manager.
|
|
1170
|
+
*/
|
|
1171
|
+
export const LOCAL_KEY_PROVIDER_REF = 'wildo-local';
|
|
1172
|
+
|
|
1173
|
+
/**
|
|
1174
|
+
* What the LOCAL provider offers. A purpose whose floor asks for more (a hardware key, a provider-generated
|
|
1175
|
+
* non-extractable key) cannot be bound to it; bind a provider that offers what the floor asks.
|
|
1176
|
+
*/
|
|
1177
|
+
export const LOCAL_KEY_PROVIDER_PROTECTION: CryptoKeyFloor = {
|
|
1178
|
+
protectionLevel: CryptoKey_ProtectionLevel.SOFTWARE,
|
|
1179
|
+
materialAccess: CryptoKey_MaterialAccess.REMOTE_OPERATION_ONLY,
|
|
1180
|
+
provenance: CryptoKey_MaterialProvenance.LOCAL_SOFTWARE,
|
|
1181
|
+
};
|
|
1182
|
+
```
|