@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
|
@@ -5,13 +5,20 @@ Read this when authoring Step 3 (grounding). It surfaces:
|
|
|
5
5
|
- `resourceReadTool(resourceType, options?)` — the generic READ factory. Instantiate
|
|
6
6
|
it per resource the agent may read; its `functionRef` defaults to
|
|
7
7
|
`resource.<resourceType>.read` (the exact string to put in the agent's
|
|
8
|
-
`capabilities.tools.functionRefs`).
|
|
8
|
+
`capabilities.tools.functionRefs`). Its `filters` argument is bound when the tool is
|
|
9
|
+
registered, from the `filterFields` your resource's SEARCH (else LIST) declares: an enum
|
|
10
|
+
offers its values, a `z.date()` a `{ startDate, endDate }` range. So what the assistant can
|
|
11
|
+
narrow by is exactly what you declare there — declare `status`, `priority` and a due date
|
|
12
|
+
if people will ask "what is pending / urgent / due this week".
|
|
9
13
|
- `resourceWriteTool(resourceType, op, options)` — the generic WRITE factory (the
|
|
10
14
|
mutating sibling). `op` is `CoreResourceOperation.CREATE` or `.UPDATE`; its
|
|
11
15
|
`functionRef` defaults to `resource.<resourceType>.<op>` (e.g. `resource.todos.create`).
|
|
12
16
|
You MUST supply `options.inputSchema` — the model-facing field contract — because a
|
|
13
|
-
write tool's arguments are resource-specific (unlike the read tool's
|
|
14
|
-
`{ id, searchQuery, limit }` — `id` reads ONE record through its READ operation; a
|
|
17
|
+
write tool's arguments are resource-specific (unlike the read tool's, which the
|
|
18
|
+
framework derives: `{ id, searchQuery, filters, limit }` — `id` reads ONE record through its READ operation; a
|
|
19
|
+
`searchQuery` matches record text and never an id, and is offered only when the resource's SEARCH declares
|
|
20
|
+
`isSearchable` with `searchableFields`; `filters` are the filter fields the resource's SEARCH (else LIST)
|
|
21
|
+
declares, less the scope field the conversation decides). Keep the schema to fields the model should legitimately
|
|
15
22
|
set: owner FKs and server-set fields are EC-injected, never model arguments. For
|
|
16
23
|
`UPDATE`, include the record `id` in the schema. Both factories run the operation as
|
|
17
24
|
the calling user under a rebuilt `ExecutionContext`, so the resource's own
|
|
@@ -50,7 +57,7 @@ All import from `@wildo-ai/saas-backend-lib`.
|
|
|
50
57
|
* would run with the ACL unread — which is what this factory did until 2026-09-08.) A resource
|
|
51
58
|
* that declares no URL-bearing default for the operation is REFUSED rather than served through its
|
|
52
59
|
* route-less internal variant. WHO the caller is is NEVER taken
|
|
53
|
-
* from the model — only the record `id`, `searchQuery` and `limit` args are. Its `functionRef`
|
|
60
|
+
* from the model — only the record `id`, `searchQuery`, `filters` and `limit` args are. Its `functionRef`
|
|
54
61
|
* defaults to `resource.<resourceType>.read` — reference that exact string from
|
|
55
62
|
* your agent's `capabilities.tools.functionRefs`. Import path:
|
|
56
63
|
* `@wildo-ai/saas-backend-lib`.
|
|
@@ -66,6 +73,19 @@ All import from `@wildo-ai/saas-backend-lib`.
|
|
|
66
73
|
* record". A resource that declares no URL-bearing READ is refused, as for any operation it does
|
|
67
74
|
* not expose.
|
|
68
75
|
*
|
|
76
|
+
* **Narrowing by a field's value.** The tool also offers `filters`: the filter fields the resource's
|
|
77
|
+
* default SEARCH declares (else its LIST), each as it accepts values — one of an enum's values, a
|
|
78
|
+
* string, a number, a boolean, or a `{ startDate, endDate }` / `{ min, max }` range. They are bound
|
|
79
|
+
* when the tool is registered, from the operation it dispatches, so the model is offered what that
|
|
80
|
+
* operation's repository allows — less the primary scope's field (`organizationId`), which the
|
|
81
|
+
* conversation's own context decides. A question about a status or a category is a filter, never a
|
|
82
|
+
* `searchQuery`: a search for the word "pending" matches no title. Filters work with or without a
|
|
83
|
+
* `searchQuery`, and a resource that declares none offers none. A calendar-day `endDate` includes
|
|
84
|
+
* that whole day (UTC). The result's `truncated` says more records matched than came back.
|
|
85
|
+
* `searchQuery` itself is offered only when the resource's SEARCH can take a text (`isSearchable`
|
|
86
|
+
* with `searchableFields`); when a search fails at run time, the answer is the filtered list and
|
|
87
|
+
* says `searchQueryNotApplied`, so it is never read as what the text found.
|
|
88
|
+
*
|
|
69
89
|
* @param resourceType the resource to expose (any registered `ResourceType`).
|
|
70
90
|
* @param options optional `functionRef` / `description` / `defaultLimit` / `maxLimit` overrides.
|
|
71
91
|
* @example
|
|
@@ -175,6 +195,8 @@ export function resourceWriteTool(
|
|
|
175
195
|
* the tool may use. The engine supplies this at call time; a tool never fabricates
|
|
176
196
|
* identity from the model's arguments.
|
|
177
197
|
*
|
|
198
|
+
* assurance-control: WILDO.AI.AGENT_AUTHORITY_CONFINEMENT — a tool acts on its caller's server-verified authority, which the model can never supply.
|
|
199
|
+
*
|
|
178
200
|
* Import path: `@wildo-ai/saas-backend-lib`.
|
|
179
201
|
*/
|
|
180
202
|
export interface FunctionToolExecutionContext {
|
|
@@ -214,6 +236,11 @@ export interface FunctionToolExecutionContext {
|
|
|
214
236
|
* reviewer — see {@link FunctionTool.effect}.
|
|
215
237
|
*/
|
|
216
238
|
autonomousTrigger?: AutonomousTurnTrigger;
|
|
239
|
+
/**
|
|
240
|
+
* #2292: this conversation's personal-data placeholders, when its agent declares `contentGuardrails.personalData` with
|
|
241
|
+
* `TOKENIZE`. Loaded by the engine from the conversation and stored again with the turn; a tool never needs it.
|
|
242
|
+
*/
|
|
243
|
+
personalDataPlaceholders?: PersonalDataPlaceholderTable;
|
|
217
244
|
}
|
|
218
245
|
|
|
219
246
|
/**
|
|
@@ -249,16 +276,34 @@ export enum FunctionToolEffect {
|
|
|
249
276
|
* functionRef: 'demo.echo',
|
|
250
277
|
* description: 'Echo the provided text back.',
|
|
251
278
|
* inputSchema: z.object({ text: z.string() }),
|
|
279
|
+
* effect: FunctionToolEffect.READ,
|
|
280
|
+
* // A hand-written tool says how it reaches data (#2839): this one reaches none.
|
|
281
|
+
* authority: { kind: FunctionToolAuthorityKind.NO_APPLICATION_DATA, reason: 'It returns its own argument.' },
|
|
252
282
|
* execute: async (args) => ({ echoed: args.text }),
|
|
253
283
|
* };
|
|
254
284
|
*/
|
|
255
285
|
export interface FunctionTool {
|
|
256
286
|
/** Stable id referenced from `agent.capabilities.tools.functionRefs`. */
|
|
257
287
|
functionRef: string;
|
|
258
|
-
/**
|
|
288
|
+
/**
|
|
289
|
+
* Natural-language description shown to the model (what the tool does + when).
|
|
290
|
+
*
|
|
291
|
+
* It is also the intent the labelling pipeline words the tool from for a PERSON (#2551): the title of the call's card
|
|
292
|
+
* in the conversation and its working line, `flows_actors_tools.<model tool name>.{title,working}`, generated by
|
|
293
|
+
* `wildo generate labels`. So say what the tool does for the person, not only how the model should call it.
|
|
294
|
+
*/
|
|
259
295
|
description: string;
|
|
260
296
|
/** Zod schema of the tool's arguments (surfaced to the model). */
|
|
261
297
|
inputSchema: z.ZodTypeAny;
|
|
298
|
+
/**
|
|
299
|
+
* The tool's arguments as the application's RESOURCES declare them. Called ONCE, when the tool is registered (both
|
|
300
|
+
* hosts register resources first; a host that does not keeps the authored schema, with a warning); what it answers
|
|
301
|
+
* REPLACES `inputSchema` and `description` for every reader — the
|
|
302
|
+
* model, an approval card, an approval's validation — so all of them read one schema. For a tool whose arguments ARE a
|
|
303
|
+
* resource's declaration: {@link resourceReadTool} offers the filters its resource's search declares. Answering
|
|
304
|
+
* `undefined` keeps the authored schema and description.
|
|
305
|
+
*/
|
|
306
|
+
bindToResources?: (resources: FunctionToolResourceDeclarations) => Pick<FunctionTool, 'inputSchema' | 'description'> | undefined;
|
|
262
307
|
/** Execute the tool with validated args under the caller's context. */
|
|
263
308
|
execute: (args: any, context: FunctionToolExecutionContext) => Promise<unknown>;
|
|
264
309
|
/**
|
|
@@ -312,6 +357,136 @@ export interface FunctionTool {
|
|
|
312
357
|
* tool you write by hand.
|
|
313
358
|
*/
|
|
314
359
|
effect?: FunctionToolEffect;
|
|
360
|
+
/**
|
|
361
|
+
* The resource whose fields this tool's arguments are (#1923). When a decider's decision on a call is exported as
|
|
362
|
+
* evaluation data, an argument is an identifier if the tool's `inputSchema` OR this resource's own schema declares it
|
|
363
|
+
* one (`.isForeignKey()`, `.isPrimaryKey()`, `IDENTITY` / `CONTACT_DETAILS` data), so a tool whose argument schema
|
|
364
|
+
* restates a resource field without its decorators still has the field's meaning. `rowIdArgument` names the
|
|
365
|
+
* argument that addresses the row (the row's own id). `resourceWriteTool` declares both for you.
|
|
366
|
+
*
|
|
367
|
+
* It also decides who sees a gated call's decision (#2734). The card shows the call's arguments, so a representative
|
|
368
|
+
* (someone working in the organization through an organization relationship) is shown and may answer it only when
|
|
369
|
+
* their relationship may read the row `rowIdArgument` names. Without a declared row, the decision goes to the
|
|
370
|
+
* organization's own staff and to representatives of the requester's own relationship only. An edit from someone
|
|
371
|
+
* answering only through a relationship may not point the row at a record their relationship cannot read, nor turn the
|
|
372
|
+
* row argument into something that names no record, nor change an argument that is, or contains at any depth, a field
|
|
373
|
+
* declared `.isForeignKey()` on the tool's argument schema or on any schema of this resource; and an edit the engine
|
|
374
|
+
* cannot judge (this resource can no longer be read) is refused to them too. An argument that addresses a record without that declaration is not recognized, so
|
|
375
|
+
* declare it. Declare `argumentsResource` on every write tool whose decisions representatives should answer.
|
|
376
|
+
*
|
|
377
|
+
* And it decides where a guarded agent's placeholders may go (#2292, #2848). For an agent that declares
|
|
378
|
+
* `contentGuardrails.personalData`, the arguments of every tool that can change something are checked before it runs:
|
|
379
|
+
* a `⟦withheld:…⟧` marker or a placeholder the conversation did not issue is refused whatever the tool declares, and
|
|
380
|
+
* an issued placeholder is put back only into a field this resource declares to hold data of the same kind. A write
|
|
381
|
+
* tool without `argumentsResource` (and whose result is not `RECORDS_OF_RESOURCE`) accepts no placeholder at all.
|
|
382
|
+
*/
|
|
383
|
+
argumentsResource?: FunctionTool_ArgumentsResource;
|
|
384
|
+
/**
|
|
385
|
+
* The tool IS a question to the person whose turn it is (#2720). Set by {@link askPersonTool}; do not set it on a
|
|
386
|
+
* tool you write by hand.
|
|
387
|
+
*
|
|
388
|
+
* Its approval is not an approval: the turn pauses on the call as on any gated tool, but the person is shown the
|
|
389
|
+
* call's QUESTIONS through a form and answers them, and the answer becomes the tool's result. Such a pause is settled
|
|
390
|
+
* by an answer carrying the person's values, or by declining, and never by a bare approve, which would run the tool
|
|
391
|
+
* on whatever answers the model wrote. It must be gated on the OWNER route: only the person in the conversation
|
|
392
|
+
* answers it (a question to a reviewer belongs to an actor system's run).
|
|
393
|
+
*/
|
|
394
|
+
asksThePerson?: boolean;
|
|
395
|
+
/**
|
|
396
|
+
* For a question tool (`asksThePerson`): whether the engine composes a form for its questions (#2720 D). `false` asks
|
|
397
|
+
* them through the request's default form, exactly as written: a text box, the options, a yes or no. For a host whose
|
|
398
|
+
* questions invite free answers ("none", "contact us", "not decided yet") that a typed control would refuse, such as
|
|
399
|
+
* the creation workbench's interview (#2731). Absent: composed.
|
|
400
|
+
*/
|
|
401
|
+
composesQuestionForm?: boolean;
|
|
402
|
+
/**
|
|
403
|
+
* For a question tool: what the agent is told when the person declines, in place of `ASK_PERSON_DECLINED_REASON`.
|
|
404
|
+
* A host whose own rules say what to do without an answer (propose answers for the person to review, say) names
|
|
405
|
+
* them here, so the agent is not told two different things.
|
|
406
|
+
*/
|
|
407
|
+
questionDeclinedReason?: string;
|
|
408
|
+
/**
|
|
409
|
+
* The tool SHOWS its person records: the conversation draws a successful call as the records' summary cards, read
|
|
410
|
+
* back from the call's input, rather than as a tool card. Set by {@link presentRecordsTool}; do not set it on a tool
|
|
411
|
+
* you write by hand, whose input would not read back as records.
|
|
412
|
+
*/
|
|
413
|
+
presentsRecords?: boolean;
|
|
414
|
+
/**
|
|
415
|
+
* The resources the tool SEARCHES through the retrieval index (#2300). Set by {@link retrievalTool}; startup refuses an
|
|
416
|
+
* application whose retrieval tool names a resource that declares no `.ragSource()` field, which would otherwise
|
|
417
|
+
* search nothing and answer as if nothing matched.
|
|
418
|
+
*/
|
|
419
|
+
retrievalSources?: readonly ResourceType[];
|
|
420
|
+
/**
|
|
421
|
+
* What this tool's RESULT carries, so an agent declaring `contentGuardrails.personalData` (#2292) can treat its personal
|
|
422
|
+
* fields before the model reads them. Declare it on every tool you write by hand: startup refuses a guarded agent
|
|
423
|
+
* offered a tool that does not say, because an undeclared result could carry anything. An organization's policy can put
|
|
424
|
+
* ANY language-model agent under a treatment (#2292 R8); an undeclared tool's result then reaches that agent's model
|
|
425
|
+
* withheld whole, and startup warns about every such tool.
|
|
426
|
+
*
|
|
427
|
+
* - `{ kind: RECORDS_OF_RESOURCE, resourceType }` — records of that resource: a record, or `{ data: [records] }`. Their
|
|
428
|
+
* personal fields are treated; for a tool that WRITES them, a placeholder in its arguments is put back too (only into
|
|
429
|
+
* a field of the same kind).
|
|
430
|
+
* - `{ kind: NOT_FROM_RECORDS, reason }` — nothing the engine moved from a record (an id list, a computed total, the
|
|
431
|
+
* answer a person chose to give). Say why: the reason is what a reviewer reads.
|
|
432
|
+
* - `{ kind: TREATED_BY_TOOL, treat }` — the tool knows its own shape and treats it (the engine's retrieval tool).
|
|
433
|
+
*
|
|
434
|
+
* `resourceReadTool`, `resourceWriteTool`, `presentRecordsTool`, `askPersonTool` and `retrievalTool` declare it for you.
|
|
435
|
+
* The model is sent the treated result; the person, the conversation's tool trace and the cards keep the real values.
|
|
436
|
+
*/
|
|
437
|
+
personalDataOutput?: FunctionTool_PersonalDataOutput;
|
|
438
|
+
/**
|
|
439
|
+
* How this tool reaches the application's data, and so on whose authority (#2839). The engine closes every tool over
|
|
440
|
+
* its caller's server-verified `auth`; what it does with that inside `execute` is the tool's own code, which nothing
|
|
441
|
+
* can check, so it is declared here:
|
|
442
|
+
*
|
|
443
|
+
* - `{ kind: PRINCIPAL_RESOURCE_OPERATION }` — every data access is {@link dispatchResourceOperationAsTool} (the
|
|
444
|
+
* operation's roles, the tenancy filter and its rate limit, for the caller);
|
|
445
|
+
* - `{ kind: PRINCIPAL_SCOPED_SERVICE, reason }` — a service given a context built from the caller's `auth`;
|
|
446
|
+
* - `{ kind: NO_APPLICATION_DATA, reason }` — the tool touches no application data;
|
|
447
|
+
* - `{ kind: SYSTEM_AUTHORITY, reason }` — it reaches data through a `*AsSystem` door, beyond the caller's own reach.
|
|
448
|
+
*
|
|
449
|
+
* `resourceReadTool`, `resourceWriteTool`, `presentRecordsTool`, `askPersonTool` and `retrievalTool` declare it for you.
|
|
450
|
+
* Declare it on every tool you write by hand: the evidence an application's `WILDO.AI.AGENT_AUTHORITY_CONFINEMENT`
|
|
451
|
+
* claim rests on lists every tool with its declaration, and reports one that declares nothing. It is never refused at
|
|
452
|
+
* registration.
|
|
453
|
+
*/
|
|
454
|
+
authority?: FunctionToolAuthorityDeclaration;
|
|
455
|
+
/**
|
|
456
|
+
* #2292: the result is the words of the PERSON the agent works for — the answer they gave to its question — and not
|
|
457
|
+
* content somebody else wrote. An agent's prompt-injection screening (`contentGuardrails.promptInjection`) does not
|
|
458
|
+
* screen it: the person's own words, on their own authority, are not a third party's injection. Set by
|
|
459
|
+
* {@link askPersonTool}. It opts a result out of a security control, so registration refuses it on any tool that is not
|
|
460
|
+
* a question tool (`asksThePerson`).
|
|
461
|
+
*/
|
|
462
|
+
returnsThePersonsOwnWords?: true;
|
|
463
|
+
}
|
|
464
|
+
|
|
465
|
+
/** How a tool's result relates to personal data. See {@link FunctionTool.personalDataOutput}. */
|
|
466
|
+
export enum FunctionToolPersonalDataOutputKind {
|
|
467
|
+
/** Records of one resource: a record, or `{ data: [records] }`. */
|
|
468
|
+
RECORDS_OF_RESOURCE = 'records_of_resource',
|
|
469
|
+
/** Nothing the engine moved from a record. */
|
|
470
|
+
NOT_FROM_RECORDS = 'not_from_records',
|
|
471
|
+
/** The tool treats its own result. */
|
|
472
|
+
TREATED_BY_TOOL = 'treated_by_tool',
|
|
473
|
+
}
|
|
474
|
+
|
|
475
|
+
/** See {@link FunctionTool.personalDataOutput}. */
|
|
476
|
+
export type FunctionTool_PersonalDataOutput =
|
|
477
|
+
| { readonly kind: FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE; readonly resourceType: ResourceType }
|
|
478
|
+
| { readonly kind: FunctionToolPersonalDataOutputKind.NOT_FROM_RECORDS; readonly reason: string }
|
|
479
|
+
| {
|
|
480
|
+
readonly kind: FunctionToolPersonalDataOutputKind.TREATED_BY_TOOL;
|
|
481
|
+
/** The result as the model may read it, every personal value replaced through `guard`. */
|
|
482
|
+
readonly treat: (output: unknown, guard: PersonalDataGuard) => unknown;
|
|
483
|
+
};
|
|
484
|
+
|
|
485
|
+
/** The resource a tool's arguments describe. See {@link FunctionTool.argumentsResource}. */
|
|
486
|
+
export interface FunctionTool_ArgumentsResource {
|
|
487
|
+
resourceType: ResourceType;
|
|
488
|
+
/** The argument holding the id of the row the call acts on, when there is one. */
|
|
489
|
+
rowIdArgument?: string;
|
|
315
490
|
}
|
|
316
491
|
|
|
317
492
|
/**
|
|
@@ -319,12 +494,45 @@ export interface FunctionTool {
|
|
|
319
494
|
*/
|
|
320
495
|
export interface FunctionTool_HumanApprovalGate {
|
|
321
496
|
route: HumanDecision_RouteKind;
|
|
497
|
+
/**
|
|
498
|
+
* How risky the CALL this gate holds is, in the vocabulary a resource operation declares its own risk in (#2526).
|
|
499
|
+
* Every surface that answers the decision reads it: HIGH and CRITICAL put Approve behind a confirmation, and the
|
|
500
|
+
* inbox can sort by it. Absent means no badge and no confirmation, never a default: a severity nobody declared would
|
|
501
|
+
* be a claim nobody made.
|
|
502
|
+
*
|
|
503
|
+
* Declare what the operation the tool performs declares. A tool that deletes through an operation declared HIGH
|
|
504
|
+
* declares HIGH here, so the person approving the call is warned exactly as one deleting the record by hand is.
|
|
505
|
+
*
|
|
506
|
+
* It is declared rather than derived because a hand-written tool names no operation: its `execute` may run several,
|
|
507
|
+
* or none, and `argumentsResource` names the resource its arguments describe, not the verb. A `resourceWriteTool`
|
|
508
|
+
* does know its operation, and still declares the risk here (pass `humanApproval: { route, riskLevel }`): the
|
|
509
|
+
* boolean `requiresHumanApproval` carries no risk. The actor system's own `riskLevel` says how much an assistant may
|
|
510
|
+
* be trusted overall, which is a different statement from how much this one call can do, so it is never shown in
|
|
511
|
+
* place of this.
|
|
512
|
+
*/
|
|
513
|
+
riskLevel?: ResourceOperationRiskLevel;
|
|
322
514
|
/**
|
|
323
515
|
* ROLE and ASSIGNEE: the role every answerer must hold. For ROLE it is the role the decision is
|
|
324
516
|
* routed to. It is also the floor for anyone the decision is later reassigned, escalated or claimed
|
|
325
517
|
* to: a move can never hand it to someone this gate would not have admitted.
|
|
326
518
|
*/
|
|
327
519
|
eligibleRole?: string;
|
|
520
|
+
/**
|
|
521
|
+
* ROLE and ASSIGNEE: the professional qualifications every answerer must ALSO hold (#2967), kinds the application
|
|
522
|
+
* declares in `professionalQualificationKinds`. Read when they act: a qualification verified, within its validity, and
|
|
523
|
+
* recorded by the organization they decide for here — their own organization for one of its own members, the
|
|
524
|
+
* representing organization for someone deciding through a relationship. A floor like `eligibleRole`: a reassignment,
|
|
525
|
+
* an escalation or a claim can never hand the decision to someone without them.
|
|
526
|
+
*
|
|
527
|
+
* Use it when the decision must be taken by a person who is qualified, not merely one who holds a role: a chartered
|
|
528
|
+
* accountant posting an adjustment, a licensed engineer signing off a design. Startup refuses a kind the application
|
|
529
|
+
* does not declare, and an OWNER route (its answerer is the person whose turn it is, who is not vetted).
|
|
530
|
+
*
|
|
531
|
+
* ```ts
|
|
532
|
+
* humanApproval: { route: HumanDecision_RouteKind.ROLE, eligibleRole: 'accountant', requiredQualificationKinds: ['chartered-accountant'] }
|
|
533
|
+
* ```
|
|
534
|
+
*/
|
|
535
|
+
requiredQualificationKinds?: readonly string[];
|
|
328
536
|
/**
|
|
329
537
|
* ASSIGNEE only: resolves the ONE person to route to, when the call pauses, from its arguments and
|
|
330
538
|
* context (for example, the record's account manager). Returning `undefined`, or a person without
|
|
@@ -364,6 +572,51 @@ export interface FunctionTool_HumanApprovalGate {
|
|
|
364
572
|
* target or on an OWNER gate.
|
|
365
573
|
*/
|
|
366
574
|
deadlines?: FunctionTool_HumanApprovalDeadlines;
|
|
575
|
+
/**
|
|
576
|
+
* What a person's DENIAL does to the record the call was about (#3015). A denied call does not run `execute`,
|
|
577
|
+
* so without this a denial changes nothing: an agent's proposal stays proposed, and the application needs a
|
|
578
|
+
* second, unsealed act to record the rejection. Declared here, the denial IS the rejection. It runs once the
|
|
579
|
+
* sealed REJECTED decision has committed, like `execute` once an approval has, with the same context: the
|
|
580
|
+
* requester's authority and the decision's `decisionRef`, which the effect reads back from the engine's record of
|
|
581
|
+
* the decision rather than trusting.
|
|
582
|
+
*
|
|
583
|
+
* It runs only for a person's REJECTED answer, never for a lapse, a withdrawal, or the engine's own denial of a
|
|
584
|
+
* call nobody can answer (nobody decided). It receives the arguments the model proposed (the denied call), and runs
|
|
585
|
+
* in the agent's actor frame, so the rows it writes name the agent, the tool and the decision. Its failure never
|
|
586
|
+
* undoes the decision: the denial stays sealed, the failure is logged, and the resumed turn is told that the record
|
|
587
|
+
* did not move.
|
|
588
|
+
*
|
|
589
|
+
* The usual effect is a server-owned transition (an `INTERNAL_CALL` operation) on the row the call named, given
|
|
590
|
+
* `ctx.decisionRef` and `ctx.executionId` so it can read the decision back before moving anything. The decision is
|
|
591
|
+
* on the conversation's execution row, in whichever of `userFlowActorExecutions`, `organizationFlowActorExecutions`
|
|
592
|
+
* and `applicationFlowActorExecutions` holds it: read each with `readAsSystem` on
|
|
593
|
+
* `{ executionId, lastResolvedDecisionRef: decisionRef }` (the fields are backend-only, and a NOT_FOUND means the
|
|
594
|
+
* next variant). The transition refuses unless `decisionOutcome` is `REJECTED`, `decidedByUserId` is set, and
|
|
595
|
+
* `decisionToolName` equals `modelToolNameForFunctionRef(<this tool's functionRef>)`: the name the model saw, in
|
|
596
|
+
* which a dot becomes `_`, never the dotted functionRef itself.
|
|
597
|
+
*
|
|
598
|
+
* ```ts
|
|
599
|
+
* humanApproval: {
|
|
600
|
+
* route: HumanDecision_RouteKind.ROLE,
|
|
601
|
+
* eligibleRole: 'accountant',
|
|
602
|
+
* onDenied: async (args, ctx) => {
|
|
603
|
+
* const { proposalId } = PostProposal_InputSchema.parse(args); // the arguments the model proposed
|
|
604
|
+
* const { resourcesRegistry, executionContextCreator, servicesRegistryHandler, authorizer } = ctx.services;
|
|
605
|
+
* const contextIds = ctx.organizationId ? { organizationId: ctx.organizationId } : {};
|
|
606
|
+
* const contextFor = (operation: string, path = resourcesRegistry.getServiceOperationPathDefault('proposals', operation)) =>
|
|
607
|
+
* executionContextCreator.buildContextFromSocketAuth(ctx.auth, resourcesRegistry.getOperationFromPath(path), contextIds);
|
|
608
|
+
* // An INTERNAL_CALL operation has no role gate of its own: the requester must hold the row's own UPDATE.
|
|
609
|
+
* await authorizer.authorizeInController(proposalId, await contextFor(CoreResourceOperation.UPDATE,
|
|
610
|
+
* resourcesRegistry.getOperationPathDefault('proposals', CoreResourceOperation.UPDATE)));
|
|
611
|
+
* await servicesRegistryHandler.executeCustomOperation('proposals', 'record_denial', await contextFor('record_denial'),
|
|
612
|
+
* proposalId, { decisionRef: ctx.decisionRef, executionId: ctx.executionId });
|
|
613
|
+
* },
|
|
614
|
+
* }
|
|
615
|
+
* ```
|
|
616
|
+
*
|
|
617
|
+
* assurance-control: WILDO.AI.HUMAN_OVERSIGHT — a person's refusal of an agent's proposal takes effect on the record it refused, as the outcome of the sealed decision.
|
|
618
|
+
*/
|
|
619
|
+
onDenied?: (args: unknown, context: FunctionToolExecutionContext) => Promise<void>;
|
|
367
620
|
}
|
|
368
621
|
|
|
369
622
|
/**
|
|
@@ -396,17 +649,68 @@ export interface FunctionTool_ReviewEscalationRule {
|
|
|
396
649
|
* only a tool that READS, or one gated on a REVIEWER — so a write that content from outside asks for is
|
|
397
650
|
* either impossible or seen by a person first. An OWNER-gated tool is not offered there either: a machine
|
|
398
651
|
* turn has no owner to ask, so the call could only ever be denied.
|
|
652
|
+
*
|
|
653
|
+
* A tool that SHOWS records (`presentsRecords`) is offered only to a turn a person watches in a conversation the
|
|
654
|
+
* application draws. An A2A caller receives the reply's text and no tool calls, and an autonomous turn has nobody
|
|
655
|
+
* watching: offered there, the agent would show cards nobody sees and leave them out of the text the reader does get.
|
|
399
656
|
*/
|
|
657
|
+
// assurance-control: WILDO.AI.AGENT_AUTHORITY_CONFINEMENT — a turn started by content from outside is offered no write a reviewer does not see first.
|
|
400
658
|
export function isFunctionToolOfferedToTurn(
|
|
401
|
-
tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'effect'>,
|
|
659
|
+
tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'effect' | 'presentsRecords'>,
|
|
402
660
|
autonomousTrigger: AutonomousTurnTrigger | undefined,
|
|
661
|
+
initiationKind?: FlowsActors_InitiationKind | null,
|
|
403
662
|
): boolean {
|
|
663
|
+
if (tool.presentsRecords === true && (autonomousTrigger !== undefined || !turnIsDrawnForAPerson(initiationKind))) return false;
|
|
404
664
|
if (autonomousTrigger !== AutonomousTurnTrigger.INBOUND_DELIVERY) return true;
|
|
405
665
|
if (tool.effect === FunctionToolEffect.READ) return true;
|
|
406
666
|
const route = resolveFunctionToolApprovalGate(tool)?.route;
|
|
407
667
|
return route === HumanDecision_RouteKind.ROLE || route === HumanDecision_RouteKind.ASSIGNEE;
|
|
408
668
|
}
|
|
409
669
|
|
|
670
|
+
/**
|
|
671
|
+
* The resource whose personal fields a guarded agent's placeholder may be put back into, in this tool's ARGUMENTS
|
|
672
|
+
* (#2848): the resource the arguments describe (`argumentsResource`), else the resource of the records the tool returns
|
|
673
|
+
* (`personalDataOutput: RECORDS_OF_RESOURCE`). `undefined` when the tool names neither: no argument may then carry a
|
|
674
|
+
* placeholder, because nothing says which field of which resource it would land in.
|
|
675
|
+
*
|
|
676
|
+
* Keyed on the ARGUMENTS first because the result declaration says what the model is SENT, not what the tool WRITES: a
|
|
677
|
+
* write whose result is only ids is `NOT_FROM_RECORDS`, and its arguments must still be checked.
|
|
678
|
+
*/
|
|
679
|
+
export function personalDataArgumentsResourceOf(tool: Pick<FunctionTool, 'argumentsResource' | 'personalDataOutput'>): ResourceType | undefined {
|
|
680
|
+
if (tool.argumentsResource !== undefined) return tool.argumentsResource.resourceType;
|
|
681
|
+
return tool.personalDataOutput?.kind === FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE ? tool.personalDataOutput.resourceType : undefined;
|
|
682
|
+
}
|
|
683
|
+
|
|
684
|
+
/**
|
|
685
|
+
* Whether a guarded agent's arguments to this tool are checked and re-identified before it runs (#2848): every tool that
|
|
686
|
+
* can change something (an undeclared `effect` counts as a write), and every tool that names a resource for its
|
|
687
|
+
* arguments or its records. Only a pure read naming no resource passes its arguments as the model wrote them, since
|
|
688
|
+
* nothing it does stores them.
|
|
689
|
+
*
|
|
690
|
+
* Until #2848 the check was keyed on the RESULT declaration alone, so a write tool declaring `NOT_FROM_RECORDS` stored a
|
|
691
|
+
* `⟦withheld:…⟧` marker or a placeholder exactly as the model wrote it.
|
|
692
|
+
*/
|
|
693
|
+
// assurance-control: WILDO.PRIVACY.DATA_MINIMIZATION — a guarded agent's write never stores a placeholder or a withheld marker, whatever its tool declares about its result.
|
|
694
|
+
export function functionToolArgumentsAreGuarded(tool: Pick<FunctionTool, 'effect' | 'argumentsResource' | 'personalDataOutput'>): boolean {
|
|
695
|
+
return tool.effect !== FunctionToolEffect.READ || personalDataArgumentsResourceOf(tool) !== undefined;
|
|
696
|
+
}
|
|
697
|
+
|
|
698
|
+
/**
|
|
699
|
+
* Whether a turn's conversation is drawn for a person by the application: a turn over the application's own socket.
|
|
700
|
+
* A turn that records no door predates the door's recording and was a socket turn. Total over the vocabulary.
|
|
701
|
+
*/
|
|
702
|
+
function turnIsDrawnForAPerson(initiationKind: FlowsActors_InitiationKind | null | undefined): boolean {
|
|
703
|
+
if (initiationKind === null || initiationKind === undefined) return true;
|
|
704
|
+
const drawn: Record<FlowsActors_InitiationKind, boolean> = {
|
|
705
|
+
[FlowsActors_InitiationKind.WEBSOCKET_SESSION]: true,
|
|
706
|
+
[FlowsActors_InitiationKind.A2A_REQUEST]: false,
|
|
707
|
+
[FlowsActors_InitiationKind.AUTONOMOUS]: false,
|
|
708
|
+
// The reply is posted in Slack or Teams as text: a card the agent showed would reach nobody (#2665).
|
|
709
|
+
[FlowsActors_InitiationKind.CHAT_MESSAGE]: false,
|
|
710
|
+
};
|
|
711
|
+
return drawn[initiationKind];
|
|
712
|
+
}
|
|
713
|
+
|
|
410
714
|
/** Refused because a tool's approval gate cannot be answered as declared. */
|
|
411
715
|
export class FunctionToolApprovalGateError extends Error {}
|
|
412
716
|
|
|
@@ -417,18 +721,31 @@ export class FunctionToolApprovalGateError extends Error {}
|
|
|
417
721
|
* Throws {@link FunctionToolApprovalGateError} for a declaration nobody could answer. The registry
|
|
418
722
|
* calls it at registration, so that surfaces at startup rather than on the first gated call.
|
|
419
723
|
*/
|
|
420
|
-
|
|
724
|
+
// assurance-control: WILDO.AI.HUMAN_OVERSIGHT — a gated tool's call waits for the person its gate routes it to.
|
|
725
|
+
export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>): FunctionTool_HumanApprovalGate | undefined {
|
|
421
726
|
const gate = tool.humanApproval ?? (tool.requiresHumanApproval ? { route: HumanDecision_RouteKind.OWNER } : undefined);
|
|
727
|
+
// #2720: a question to the person is answered by the person in the conversation, so it is gated, on the OWNER route.
|
|
728
|
+
if (tool.asksThePerson && gate?.route !== HumanDecision_RouteKind.OWNER) {
|
|
729
|
+
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" asks the person and must be gated on the OWNER route: only the person whose turn it is answers it.`);
|
|
730
|
+
}
|
|
422
731
|
if (!gate) return undefined;
|
|
423
732
|
const refuse = (why: string): never => {
|
|
424
733
|
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" declares an approval gate nobody can answer: ${why}`);
|
|
425
734
|
};
|
|
426
735
|
refuseUnsoundDeadlines(tool.functionRef, gate);
|
|
736
|
+
// #2967: a required qualification names a kind, once each. Whether the application DECLARES it needs the configuration,
|
|
737
|
+
// which a tool does not see: the startup validator asks that.
|
|
738
|
+
const requiredKinds = gate.requiredQualificationKinds ?? [];
|
|
739
|
+
if (requiredKinds.some((kind) => typeof kind !== 'string' || kind.length === 0)) refuse('`requiredQualificationKinds` names an empty kind.');
|
|
740
|
+
if (new Set(requiredKinds).size !== requiredKinds.length) refuse('`requiredQualificationKinds` names a kind twice.');
|
|
427
741
|
switch (gate.route) {
|
|
428
742
|
case HumanDecision_RouteKind.OWNER:
|
|
429
743
|
if (gate.eligibleRole || gate.assignee || gate.escalateTo) {
|
|
430
744
|
refuse('an OWNER route is answered by the person whose turn it is, so it takes no role, assignee or escalation target.');
|
|
431
745
|
}
|
|
746
|
+
if (requiredKinds.length > 0) {
|
|
747
|
+
refuse('an OWNER route is answered by the person whose turn it is, who is not vetted, so it can require no qualification; route it to a ROLE.');
|
|
748
|
+
}
|
|
432
749
|
return gate;
|
|
433
750
|
case HumanDecision_RouteKind.ROLE:
|
|
434
751
|
if (!gate.eligibleRole) refuse('a ROLE route must name `eligibleRole`, the role it is routed to.');
|
|
@@ -1,12 +1,18 @@
|
|
|
1
1
|
# Frontend view + module contribution — source contracts
|
|
2
2
|
|
|
3
|
-
Read this when authoring Step
|
|
3
|
+
Read this when authoring Step 5 (view + launcher) and confirming the module
|
|
4
4
|
contribution shape:
|
|
5
5
|
|
|
6
6
|
- `FlowsActorsViewDefinition` — the authoring shape for a standalone flows-actors
|
|
7
7
|
view (`flowsActorsViews` entry). An addressable one routes at `/flows-actors/:ref`;
|
|
8
|
-
`systemRef` names one ActorSystem to expose.
|
|
9
|
-
|
|
8
|
+
`systemRef` names one ActorSystem to expose. `layoutPreset` names the preset of
|
|
9
|
+
the conversation surface (`AI_ConversationThread`) that draws the view: `'Default'`
|
|
10
|
+
is the framework's; register your own with `ComponentRegistryService.register(
|
|
11
|
+
FrontendComponentType.LOW_LEVEL_AI_CONVERSATION_THREAD, '<name>', …)` to restyle or
|
|
12
|
+
reshape the whole conversation. An unregistered name does not fall back to `'Default'`:
|
|
13
|
+
each part draws the "not injected" placeholder (visible in development, empty in
|
|
14
|
+
production) and the console warns. Import type
|
|
15
|
+
from `@wildo-ai/saas-frontend-lib/companion`.
|
|
10
16
|
- The backend module contribution `flowsActors` — where `flowActorSystemsFactoryMap`,
|
|
11
17
|
`agents`, and **`functionTools`** are registered. (The `functionTools` field is
|
|
12
18
|
the one you populate with `resourceReadTool(...)` instances.)
|
|
@@ -33,10 +39,16 @@ contribution shape:
|
|
|
33
39
|
* @property systemRef the registered flow/actor system ref to expose. ONE per view: a view
|
|
34
40
|
* hosting several assistants would need a switcher, and hosting several
|
|
35
41
|
* means declaring several views.
|
|
36
|
-
* @property layoutPreset
|
|
37
|
-
*
|
|
42
|
+
* @property layoutPreset the conversation surface preset (`AI_ConversationThread`) that draws the view;
|
|
43
|
+
* 'Default' is the framework's. An unregistered name does not fall back to
|
|
44
|
+
* 'Default': every part draws the not-injected placeholder (visible in
|
|
45
|
+
* development, empty in production) and the console warns.
|
|
38
46
|
* @property isAddressable set `true` to give the view its own URL/route.
|
|
39
47
|
* @property primaryScope scope whose context is injected for access/navigation.
|
|
48
|
+
* @property icon the glyph every launcher for this view shows (sidebar, command menu). Optional
|
|
49
|
+
* because the view can be embed-only (hosted inline by the utility panel, whose
|
|
50
|
+
* item carries its own icon); declare it whenever a launcher targets the view,
|
|
51
|
+
* or that launcher shows the alert-circle placeholder.
|
|
40
52
|
*/
|
|
41
53
|
export interface FlowsActorsViewDefinition {
|
|
42
54
|
scope: FrontendView_ScopeMode;
|
|
@@ -50,6 +62,8 @@ export interface FlowsActorsViewDefinition {
|
|
|
50
62
|
layoutPreset: string;
|
|
51
63
|
/** Required features for this view — gates navigation + route access */
|
|
52
64
|
requiredFeatures?: RequiredFeaturesConfig;
|
|
65
|
+
/** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */
|
|
66
|
+
icon?: IconLike;
|
|
53
67
|
}
|
|
54
68
|
```
|
|
55
69
|
## Import Origins
|
|
@@ -85,6 +99,19 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
85
99
|
* is bound to the ref. See `FlowsActors_AutonomousAgentDeclaration`.
|
|
86
100
|
*/
|
|
87
101
|
autonomousAgents?: FlowsActors_AutonomousAgentDeclaration[];
|
|
102
|
+
/**
|
|
103
|
+
* Agents that may answer people who write to the application's bot in a chat workspace (Slack, Microsoft Teams,
|
|
104
|
+
* #2665). Each organization chooses one per chat connection; the one declared `isDefault` answers where it chose
|
|
105
|
+
* none. Every turn runs as the linked member who wrote. See `FlowsActors_ChatAgentDeclaration`.
|
|
106
|
+
*/
|
|
107
|
+
chatAgents?: FlowsActors_ChatAgentDeclaration[];
|
|
108
|
+
/**
|
|
109
|
+
* How this module's actor-system runs continue once a person answers the question they asked (#2539) — one per
|
|
110
|
+
* actor system. A run raises a question through `ActorsSystemBackendService.runActorExecution(…, { suspendOn })`
|
|
111
|
+
* with `scope: { organizationId }`; the decision inbox answers it and calls the continuation. See
|
|
112
|
+
* `ActorExecutionContinuation`.
|
|
113
|
+
*/
|
|
114
|
+
actorExecutionContinuations?: ActorExecutionContinuation<any>[];
|
|
88
115
|
};
|
|
89
116
|
/**
|
|
90
117
|
* Backend-only direct PDF template bindings contributed by this module.
|
|
@@ -162,6 +189,26 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
162
189
|
* a missing dedup key, a scope mode without the roles to reach it — each stops the process.
|
|
163
190
|
*/
|
|
164
191
|
inboundHandlers?: AnyDeclaredInboundHandler[];
|
|
192
|
+
/**
|
|
193
|
+
* The application's decision-notice handler (#2664 S5b), built with `defineHumanDecisionNoticeHandler(...)`: how the
|
|
194
|
+
* people who may answer a pending decision are told about it outside the product (a Slack message, a Teams card), and
|
|
195
|
+
* how the card is taken back once the decision is settled or moves. At most ONE across every module: a decision's
|
|
196
|
+
* cards are one conversation with its answerers.
|
|
197
|
+
*/
|
|
198
|
+
humanDecisionNoticeHandler?: HumanDecisionNoticeHandlerDefinition;
|
|
199
|
+
/**
|
|
200
|
+
* The application's chat reply handlers (#2665 S6), each built with `defineChatReplyHandler(...)`: how a chat agent's
|
|
201
|
+
* answer is posted into a member's Slack or Microsoft Teams conversation. One per chat connection: a conversation's
|
|
202
|
+
* reply goes back through the connection it arrived on. A vendor module ships its connection's handler.
|
|
203
|
+
*/
|
|
204
|
+
chatReplyHandlers?: ChatReplyHandlerDefinition[];
|
|
205
|
+
/**
|
|
206
|
+
* The resolvers an operation approval is routed by (#2288), keyed by the name a variant's `requiresApproval.assignee`
|
|
207
|
+
* or `requiresApproval.escalateTo` uses: each names the one person who should approve a request. The engine vets the
|
|
208
|
+
* person (they must hold the variant's `eligibleRole`, and are never the requester), so a resolver only chooses among
|
|
209
|
+
* the people who already may approve. Startup refuses a name a variant uses and no module registers.
|
|
210
|
+
*/
|
|
211
|
+
operationApprovalResolvers?: OperationApprovalResolvers;
|
|
165
212
|
}
|
|
166
213
|
|
|
167
214
|
/**
|
|
@@ -176,9 +223,11 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
176
223
|
* |---|---|
|
|
177
224
|
* | `resourceConfigurations` | **last module wins, silently** |
|
|
178
225
|
* | `resourceFieldIdentifiers` | **last module wins, silently** |
|
|
179
|
-
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` | rejected, naming both modules |
|
|
226
|
+
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` · `operationApprovalResolvers` | rejected, naming both modules |
|
|
180
227
|
* | `resourceRelationships` · `operations` · `controllers` · `seeds` | concatenated — both are kept |
|
|
181
228
|
* | `inboundHandlers` | concatenated; a duplicate `ref` is rejected, naming both modules |
|
|
229
|
+
* | `humanDecisionNoticeHandler` | at most one across every module; a second is rejected, naming both modules |
|
|
230
|
+
* | `chatReplyHandlers` | concatenated; two for one connection are rejected at startup, naming both handlers |
|
|
182
231
|
*
|
|
183
232
|
* Do not generalise the rejection to the whole object. Two modules declaring the same resource
|
|
184
233
|
* identifier produce no error and no warning: whichever is later in the registry array replaces the
|
|
@@ -211,9 +260,47 @@ export function mergeBackendDomainModules(
|
|
|
211
260
|
seeds: modules.flatMap(m => m.seeds ?? []),
|
|
212
261
|
dataSeedScopeResolvers: mergeDataSeedScopeResolvers(modules),
|
|
213
262
|
inboundHandlers: mergeInboundHandlers(modules),
|
|
263
|
+
...mergeHumanDecisionNoticeHandler(modules),
|
|
264
|
+
chatReplyHandlers: modules.flatMap(m => m.chatReplyHandlers ?? []),
|
|
265
|
+
operationApprovalResolvers: mergeOperationApprovalResolvers(modules),
|
|
214
266
|
};
|
|
215
267
|
}
|
|
216
268
|
|
|
269
|
+
/** Every module's operation-approval resolvers in one record, refusing a name two modules register (naming both). */
|
|
270
|
+
function mergeOperationApprovalResolvers(modules: BackendDomainModule[]): OperationApprovalResolvers | undefined {
|
|
271
|
+
const merged: Record<string, OperationApprovalResolvers[string]> = {};
|
|
272
|
+
const sourceIndexByName = new Map<string, number>();
|
|
273
|
+
for (let moduleIndex = 0; moduleIndex < modules.length; moduleIndex++) {
|
|
274
|
+
for (const [name, resolver] of Object.entries(modules[moduleIndex]!.operationApprovalResolvers ?? {})) {
|
|
275
|
+
const firstSource = sourceIndexByName.get(name);
|
|
276
|
+
if (firstSource !== undefined) {
|
|
277
|
+
throw new Error(
|
|
278
|
+
`mergeBackendDomainModules: duplicate operationApprovalResolvers name '${name}' — registered by module index ${firstSource} AND module index ${moduleIndex}. Each name routes one decision; pick a unique one.`,
|
|
279
|
+
);
|
|
280
|
+
}
|
|
281
|
+
sourceIndexByName.set(name, moduleIndex);
|
|
282
|
+
merged[name] = resolver;
|
|
283
|
+
}
|
|
284
|
+
}
|
|
285
|
+
return Object.keys(merged).length > 0 ? merged : undefined;
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/** The one decision-notice handler, refusing a second module that declares another (naming both). */
|
|
289
|
+
function mergeHumanDecisionNoticeHandler(modules: BackendDomainModule[]): Pick<BackendDomainModule, 'humanDecisionNoticeHandler'> {
|
|
290
|
+
let found: { handler: HumanDecisionNoticeHandlerDefinition; moduleIndex: number } | undefined;
|
|
291
|
+
for (let moduleIndex = 0; moduleIndex < modules.length; moduleIndex++) {
|
|
292
|
+
const handler = modules[moduleIndex]!.humanDecisionNoticeHandler;
|
|
293
|
+
if (!handler) continue;
|
|
294
|
+
if (found && found.handler !== handler) {
|
|
295
|
+
throw new Error(
|
|
296
|
+
`mergeBackendDomainModules: two decision-notice handlers — '${found.handler.ref}' from module index ${found.moduleIndex} AND '${handler.ref}' from module index ${moduleIndex}. An application declares at most one: a decision's cards are one conversation with the people who may answer it.`,
|
|
297
|
+
);
|
|
298
|
+
}
|
|
299
|
+
found = { handler, moduleIndex };
|
|
300
|
+
}
|
|
301
|
+
return found ? { humanDecisionNoticeHandler: found.handler } : {};
|
|
302
|
+
}
|
|
303
|
+
|
|
217
304
|
/**
|
|
218
305
|
* Concatenate every module's inbound handlers, refusing a `ref` two modules both declare — with both
|
|
219
306
|
* module indices, which the startup registry cannot know. Everything else about a handler (its source,
|
|
@@ -386,6 +473,8 @@ function mergeFlowsActors(
|
|
|
386
473
|
agents: modules.flatMap(m => m.flowsActors?.agents ?? []),
|
|
387
474
|
functionTools: modules.flatMap(m => m.flowsActors?.functionTools ?? []),
|
|
388
475
|
autonomousAgents: modules.flatMap(m => m.flowsActors?.autonomousAgents ?? []),
|
|
476
|
+
chatAgents: modules.flatMap(m => m.flowsActors?.chatAgents ?? []),
|
|
477
|
+
actorExecutionContinuations: modules.flatMap(m => m.flowsActors?.actorExecutionContinuations ?? []),
|
|
389
478
|
};
|
|
390
479
|
}
|
|
391
480
|
```
|