@wildo-ai/framework-knowledge 1.1.10 → 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/derived-artifacts.md +4 -2
- 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 +459 -76
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.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.d.ts.map +1 -1
- 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/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +5 -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 +11 -6
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -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 +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +4 -1
- 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 +3 -3
- 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 +3 -2
- 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 +2 -2
- 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 +2 -2
- 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 +26 -7
- 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 -6
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.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.compliance-document-candidate/playbook.definition.d.ts.map +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 +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.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/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- 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 +6 -4
- 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.map +1 -1
- 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.map +1 -1
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.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.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.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.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.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 +8 -2
- 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 +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.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-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.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.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +4 -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 +350 -23
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +6 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +248 -9
- 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 +3 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +12 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +13 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +4 -3
- 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 +33 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +20 -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 +97 -23
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +30 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +1 -1
- 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 +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +2 -2
- 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/playbook.json +1 -1
- 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 +3 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -1
- 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 +4 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +5 -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.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +238 -8
- 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.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.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -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.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.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +52 -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.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 +16 -0
- 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.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +75 -13
- 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/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.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.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 +7 -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.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.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 +18 -16
- 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 +10 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- 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 +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +89 -51
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +9 -6
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +66 -4
- 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 +18 -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 +58 -6
- 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 +58 -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.organization-defaults.md +6 -6
- 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 +34 -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 +51 -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 +38 -9
- 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 +17 -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 +98 -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 +21 -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 +19 -4
- 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.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 +44 -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.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 +544 -32
- 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 +73 -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 +75 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- 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 +4 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +32 -4
- 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 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- 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 +2411 -139
- package/dist/knowledge/registries/playbooks.json +51 -30
- package/dist/knowledge/registries/source-tags.json +8500 -4768
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/skills/INDEX.md +60 -33
- 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-database-migrations/SKILL.md +27 -9
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +6 -6
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +124 -3
- 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 +35 -1
- 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 +3 -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 +127 -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/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 +134 -33
- 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 +57 -28
- 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 +17 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- 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/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 +2 -0
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +11 -3
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- 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 +5 -3
- 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 +14 -0
- 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 +46 -5
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +7 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- 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 +281 -20
- 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 +91 -5
- 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 +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +27 -17
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +136 -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 +1 -1
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +4 -1
- 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 +107 -2
- 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/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +9 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +9 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +2 -1
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +2 -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 +150 -4
- 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 +50 -27
- 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/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 +1 -1
- 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 +9 -5
- 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 +26 -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 +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- 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 +132 -55
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +49 -4
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +58 -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 +102 -4
- 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 +6 -0
- 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 +18 -0
- 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 +60 -3
- 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 +1 -1
- 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 +195 -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 +176 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +88 -50
- 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 +71 -12
- 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 +3 -1
- 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 +26 -10
- 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 +9 -7
- 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 +79 -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 +32 -4
- 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 +116 -66
- 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 +203 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +155 -76
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +19 -17
- 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 +168 -58
- 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/references/data-seeding-mode-picker.md +16 -1
- 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 +141 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +66 -4
- 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/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- 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 +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +5 -0
- 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 +11 -4
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- 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 +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +251 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1064 -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 +39 -18
- 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 +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- 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 +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- 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 +255 -397
- 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 +28 -6
- 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 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- 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 +24 -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 +48 -28
- 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 +561 -302
- 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 +647 -274
- 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 +572 -264
- 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 +603 -332
- 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 +549 -378
- 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 +739 -315
- 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 +183 -67
- 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 +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- 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 +16442 -8572
- 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
|
@@ -16,6 +16,8 @@
|
|
|
16
16
|
* the tool may use. The engine supplies this at call time; a tool never fabricates
|
|
17
17
|
* identity from the model's arguments.
|
|
18
18
|
*
|
|
19
|
+
* assurance-control: WILDO.AI.AGENT_AUTHORITY_CONFINEMENT — a tool acts on its caller's server-verified authority, which the model can never supply.
|
|
20
|
+
*
|
|
19
21
|
* Import path: `@wildo-ai/saas-backend-lib`.
|
|
20
22
|
*/
|
|
21
23
|
export interface FunctionToolExecutionContext {
|
|
@@ -55,6 +57,11 @@ export interface FunctionToolExecutionContext {
|
|
|
55
57
|
* reviewer — see {@link FunctionTool.effect}.
|
|
56
58
|
*/
|
|
57
59
|
autonomousTrigger?: AutonomousTurnTrigger;
|
|
60
|
+
/**
|
|
61
|
+
* #2292: this conversation's personal-data placeholders, when its agent declares `contentGuardrails.personalData` with
|
|
62
|
+
* `TOKENIZE`. Loaded by the engine from the conversation and stored again with the turn; a tool never needs it.
|
|
63
|
+
*/
|
|
64
|
+
personalDataPlaceholders?: PersonalDataPlaceholderTable;
|
|
58
65
|
}
|
|
59
66
|
|
|
60
67
|
/**
|
|
@@ -90,16 +97,34 @@ export enum FunctionToolEffect {
|
|
|
90
97
|
* functionRef: 'demo.echo',
|
|
91
98
|
* description: 'Echo the provided text back.',
|
|
92
99
|
* inputSchema: z.object({ text: z.string() }),
|
|
100
|
+
* effect: FunctionToolEffect.READ,
|
|
101
|
+
* // A hand-written tool says how it reaches data (#2839): this one reaches none.
|
|
102
|
+
* authority: { kind: FunctionToolAuthorityKind.NO_APPLICATION_DATA, reason: 'It returns its own argument.' },
|
|
93
103
|
* execute: async (args) => ({ echoed: args.text }),
|
|
94
104
|
* };
|
|
95
105
|
*/
|
|
96
106
|
export interface FunctionTool {
|
|
97
107
|
/** Stable id referenced from `agent.capabilities.tools.functionRefs`. */
|
|
98
108
|
functionRef: string;
|
|
99
|
-
/**
|
|
109
|
+
/**
|
|
110
|
+
* Natural-language description shown to the model (what the tool does + when).
|
|
111
|
+
*
|
|
112
|
+
* It is also the intent the labelling pipeline words the tool from for a PERSON (#2551): the title of the call's card
|
|
113
|
+
* in the conversation and its working line, `flows_actors_tools.<model tool name>.{title,working}`, generated by
|
|
114
|
+
* `wildo generate labels`. So say what the tool does for the person, not only how the model should call it.
|
|
115
|
+
*/
|
|
100
116
|
description: string;
|
|
101
117
|
/** Zod schema of the tool's arguments (surfaced to the model). */
|
|
102
118
|
inputSchema: z.ZodTypeAny;
|
|
119
|
+
/**
|
|
120
|
+
* The tool's arguments as the application's RESOURCES declare them. Called ONCE, when the tool is registered (both
|
|
121
|
+
* hosts register resources first; a host that does not keeps the authored schema, with a warning); what it answers
|
|
122
|
+
* REPLACES `inputSchema` and `description` for every reader — the
|
|
123
|
+
* model, an approval card, an approval's validation — so all of them read one schema. For a tool whose arguments ARE a
|
|
124
|
+
* resource's declaration: {@link resourceReadTool} offers the filters its resource's search declares. Answering
|
|
125
|
+
* `undefined` keeps the authored schema and description.
|
|
126
|
+
*/
|
|
127
|
+
bindToResources?: (resources: FunctionToolResourceDeclarations) => Pick<FunctionTool, 'inputSchema' | 'description'> | undefined;
|
|
103
128
|
/** Execute the tool with validated args under the caller's context. */
|
|
104
129
|
execute: (args: any, context: FunctionToolExecutionContext) => Promise<unknown>;
|
|
105
130
|
/**
|
|
@@ -153,6 +178,136 @@ export interface FunctionTool {
|
|
|
153
178
|
* tool you write by hand.
|
|
154
179
|
*/
|
|
155
180
|
effect?: FunctionToolEffect;
|
|
181
|
+
/**
|
|
182
|
+
* The resource whose fields this tool's arguments are (#1923). When a decider's decision on a call is exported as
|
|
183
|
+
* evaluation data, an argument is an identifier if the tool's `inputSchema` OR this resource's own schema declares it
|
|
184
|
+
* one (`.isForeignKey()`, `.isPrimaryKey()`, `IDENTITY` / `CONTACT_DETAILS` data), so a tool whose argument schema
|
|
185
|
+
* restates a resource field without its decorators still has the field's meaning. `rowIdArgument` names the
|
|
186
|
+
* argument that addresses the row (the row's own id). `resourceWriteTool` declares both for you.
|
|
187
|
+
*
|
|
188
|
+
* It also decides who sees a gated call's decision (#2734). The card shows the call's arguments, so a representative
|
|
189
|
+
* (someone working in the organization through an organization relationship) is shown and may answer it only when
|
|
190
|
+
* their relationship may read the row `rowIdArgument` names. Without a declared row, the decision goes to the
|
|
191
|
+
* organization's own staff and to representatives of the requester's own relationship only. An edit from someone
|
|
192
|
+
* answering only through a relationship may not point the row at a record their relationship cannot read, nor turn the
|
|
193
|
+
* row argument into something that names no record, nor change an argument that is, or contains at any depth, a field
|
|
194
|
+
* declared `.isForeignKey()` on the tool's argument schema or on any schema of this resource; and an edit the engine
|
|
195
|
+
* 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
|
|
196
|
+
* declare it. Declare `argumentsResource` on every write tool whose decisions representatives should answer.
|
|
197
|
+
*
|
|
198
|
+
* And it decides where a guarded agent's placeholders may go (#2292, #2848). For an agent that declares
|
|
199
|
+
* `contentGuardrails.personalData`, the arguments of every tool that can change something are checked before it runs:
|
|
200
|
+
* a `⟦withheld:…⟧` marker or a placeholder the conversation did not issue is refused whatever the tool declares, and
|
|
201
|
+
* an issued placeholder is put back only into a field this resource declares to hold data of the same kind. A write
|
|
202
|
+
* tool without `argumentsResource` (and whose result is not `RECORDS_OF_RESOURCE`) accepts no placeholder at all.
|
|
203
|
+
*/
|
|
204
|
+
argumentsResource?: FunctionTool_ArgumentsResource;
|
|
205
|
+
/**
|
|
206
|
+
* The tool IS a question to the person whose turn it is (#2720). Set by {@link askPersonTool}; do not set it on a
|
|
207
|
+
* tool you write by hand.
|
|
208
|
+
*
|
|
209
|
+
* Its approval is not an approval: the turn pauses on the call as on any gated tool, but the person is shown the
|
|
210
|
+
* call's QUESTIONS through a form and answers them, and the answer becomes the tool's result. Such a pause is settled
|
|
211
|
+
* by an answer carrying the person's values, or by declining, and never by a bare approve, which would run the tool
|
|
212
|
+
* on whatever answers the model wrote. It must be gated on the OWNER route: only the person in the conversation
|
|
213
|
+
* answers it (a question to a reviewer belongs to an actor system's run).
|
|
214
|
+
*/
|
|
215
|
+
asksThePerson?: boolean;
|
|
216
|
+
/**
|
|
217
|
+
* For a question tool (`asksThePerson`): whether the engine composes a form for its questions (#2720 D). `false` asks
|
|
218
|
+
* them through the request's default form, exactly as written: a text box, the options, a yes or no. For a host whose
|
|
219
|
+
* questions invite free answers ("none", "contact us", "not decided yet") that a typed control would refuse, such as
|
|
220
|
+
* the creation workbench's interview (#2731). Absent: composed.
|
|
221
|
+
*/
|
|
222
|
+
composesQuestionForm?: boolean;
|
|
223
|
+
/**
|
|
224
|
+
* For a question tool: what the agent is told when the person declines, in place of `ASK_PERSON_DECLINED_REASON`.
|
|
225
|
+
* A host whose own rules say what to do without an answer (propose answers for the person to review, say) names
|
|
226
|
+
* them here, so the agent is not told two different things.
|
|
227
|
+
*/
|
|
228
|
+
questionDeclinedReason?: string;
|
|
229
|
+
/**
|
|
230
|
+
* The tool SHOWS its person records: the conversation draws a successful call as the records' summary cards, read
|
|
231
|
+
* back from the call's input, rather than as a tool card. Set by {@link presentRecordsTool}; do not set it on a tool
|
|
232
|
+
* you write by hand, whose input would not read back as records.
|
|
233
|
+
*/
|
|
234
|
+
presentsRecords?: boolean;
|
|
235
|
+
/**
|
|
236
|
+
* The resources the tool SEARCHES through the retrieval index (#2300). Set by {@link retrievalTool}; startup refuses an
|
|
237
|
+
* application whose retrieval tool names a resource that declares no `.ragSource()` field, which would otherwise
|
|
238
|
+
* search nothing and answer as if nothing matched.
|
|
239
|
+
*/
|
|
240
|
+
retrievalSources?: readonly ResourceType[];
|
|
241
|
+
/**
|
|
242
|
+
* What this tool's RESULT carries, so an agent declaring `contentGuardrails.personalData` (#2292) can treat its personal
|
|
243
|
+
* fields before the model reads them. Declare it on every tool you write by hand: startup refuses a guarded agent
|
|
244
|
+
* offered a tool that does not say, because an undeclared result could carry anything. An organization's policy can put
|
|
245
|
+
* ANY language-model agent under a treatment (#2292 R8); an undeclared tool's result then reaches that agent's model
|
|
246
|
+
* withheld whole, and startup warns about every such tool.
|
|
247
|
+
*
|
|
248
|
+
* - `{ kind: RECORDS_OF_RESOURCE, resourceType }` — records of that resource: a record, or `{ data: [records] }`. Their
|
|
249
|
+
* personal fields are treated; for a tool that WRITES them, a placeholder in its arguments is put back too (only into
|
|
250
|
+
* a field of the same kind).
|
|
251
|
+
* - `{ kind: NOT_FROM_RECORDS, reason }` — nothing the engine moved from a record (an id list, a computed total, the
|
|
252
|
+
* answer a person chose to give). Say why: the reason is what a reviewer reads.
|
|
253
|
+
* - `{ kind: TREATED_BY_TOOL, treat }` — the tool knows its own shape and treats it (the engine's retrieval tool).
|
|
254
|
+
*
|
|
255
|
+
* `resourceReadTool`, `resourceWriteTool`, `presentRecordsTool`, `askPersonTool` and `retrievalTool` declare it for you.
|
|
256
|
+
* The model is sent the treated result; the person, the conversation's tool trace and the cards keep the real values.
|
|
257
|
+
*/
|
|
258
|
+
personalDataOutput?: FunctionTool_PersonalDataOutput;
|
|
259
|
+
/**
|
|
260
|
+
* How this tool reaches the application's data, and so on whose authority (#2839). The engine closes every tool over
|
|
261
|
+
* its caller's server-verified `auth`; what it does with that inside `execute` is the tool's own code, which nothing
|
|
262
|
+
* can check, so it is declared here:
|
|
263
|
+
*
|
|
264
|
+
* - `{ kind: PRINCIPAL_RESOURCE_OPERATION }` — every data access is {@link dispatchResourceOperationAsTool} (the
|
|
265
|
+
* operation's roles, the tenancy filter and its rate limit, for the caller);
|
|
266
|
+
* - `{ kind: PRINCIPAL_SCOPED_SERVICE, reason }` — a service given a context built from the caller's `auth`;
|
|
267
|
+
* - `{ kind: NO_APPLICATION_DATA, reason }` — the tool touches no application data;
|
|
268
|
+
* - `{ kind: SYSTEM_AUTHORITY, reason }` — it reaches data through a `*AsSystem` door, beyond the caller's own reach.
|
|
269
|
+
*
|
|
270
|
+
* `resourceReadTool`, `resourceWriteTool`, `presentRecordsTool`, `askPersonTool` and `retrievalTool` declare it for you.
|
|
271
|
+
* Declare it on every tool you write by hand: the evidence an application's `WILDO.AI.AGENT_AUTHORITY_CONFINEMENT`
|
|
272
|
+
* claim rests on lists every tool with its declaration, and reports one that declares nothing. It is never refused at
|
|
273
|
+
* registration.
|
|
274
|
+
*/
|
|
275
|
+
authority?: FunctionToolAuthorityDeclaration;
|
|
276
|
+
/**
|
|
277
|
+
* #2292: the result is the words of the PERSON the agent works for — the answer they gave to its question — and not
|
|
278
|
+
* content somebody else wrote. An agent's prompt-injection screening (`contentGuardrails.promptInjection`) does not
|
|
279
|
+
* screen it: the person's own words, on their own authority, are not a third party's injection. Set by
|
|
280
|
+
* {@link askPersonTool}. It opts a result out of a security control, so registration refuses it on any tool that is not
|
|
281
|
+
* a question tool (`asksThePerson`).
|
|
282
|
+
*/
|
|
283
|
+
returnsThePersonsOwnWords?: true;
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
/** How a tool's result relates to personal data. See {@link FunctionTool.personalDataOutput}. */
|
|
287
|
+
export enum FunctionToolPersonalDataOutputKind {
|
|
288
|
+
/** Records of one resource: a record, or `{ data: [records] }`. */
|
|
289
|
+
RECORDS_OF_RESOURCE = 'records_of_resource',
|
|
290
|
+
/** Nothing the engine moved from a record. */
|
|
291
|
+
NOT_FROM_RECORDS = 'not_from_records',
|
|
292
|
+
/** The tool treats its own result. */
|
|
293
|
+
TREATED_BY_TOOL = 'treated_by_tool',
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
/** See {@link FunctionTool.personalDataOutput}. */
|
|
297
|
+
export type FunctionTool_PersonalDataOutput =
|
|
298
|
+
| { readonly kind: FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE; readonly resourceType: ResourceType }
|
|
299
|
+
| { readonly kind: FunctionToolPersonalDataOutputKind.NOT_FROM_RECORDS; readonly reason: string }
|
|
300
|
+
| {
|
|
301
|
+
readonly kind: FunctionToolPersonalDataOutputKind.TREATED_BY_TOOL;
|
|
302
|
+
/** The result as the model may read it, every personal value replaced through `guard`. */
|
|
303
|
+
readonly treat: (output: unknown, guard: PersonalDataGuard) => unknown;
|
|
304
|
+
};
|
|
305
|
+
|
|
306
|
+
/** The resource a tool's arguments describe. See {@link FunctionTool.argumentsResource}. */
|
|
307
|
+
export interface FunctionTool_ArgumentsResource {
|
|
308
|
+
resourceType: ResourceType;
|
|
309
|
+
/** The argument holding the id of the row the call acts on, when there is one. */
|
|
310
|
+
rowIdArgument?: string;
|
|
156
311
|
}
|
|
157
312
|
|
|
158
313
|
/**
|
|
@@ -160,12 +315,45 @@ export interface FunctionTool {
|
|
|
160
315
|
*/
|
|
161
316
|
export interface FunctionTool_HumanApprovalGate {
|
|
162
317
|
route: HumanDecision_RouteKind;
|
|
318
|
+
/**
|
|
319
|
+
* How risky the CALL this gate holds is, in the vocabulary a resource operation declares its own risk in (#2526).
|
|
320
|
+
* Every surface that answers the decision reads it: HIGH and CRITICAL put Approve behind a confirmation, and the
|
|
321
|
+
* inbox can sort by it. Absent means no badge and no confirmation, never a default: a severity nobody declared would
|
|
322
|
+
* be a claim nobody made.
|
|
323
|
+
*
|
|
324
|
+
* Declare what the operation the tool performs declares. A tool that deletes through an operation declared HIGH
|
|
325
|
+
* declares HIGH here, so the person approving the call is warned exactly as one deleting the record by hand is.
|
|
326
|
+
*
|
|
327
|
+
* It is declared rather than derived because a hand-written tool names no operation: its `execute` may run several,
|
|
328
|
+
* or none, and `argumentsResource` names the resource its arguments describe, not the verb. A `resourceWriteTool`
|
|
329
|
+
* does know its operation, and still declares the risk here (pass `humanApproval: { route, riskLevel }`): the
|
|
330
|
+
* boolean `requiresHumanApproval` carries no risk. The actor system's own `riskLevel` says how much an assistant may
|
|
331
|
+
* be trusted overall, which is a different statement from how much this one call can do, so it is never shown in
|
|
332
|
+
* place of this.
|
|
333
|
+
*/
|
|
334
|
+
riskLevel?: ResourceOperationRiskLevel;
|
|
163
335
|
/**
|
|
164
336
|
* ROLE and ASSIGNEE: the role every answerer must hold. For ROLE it is the role the decision is
|
|
165
337
|
* routed to. It is also the floor for anyone the decision is later reassigned, escalated or claimed
|
|
166
338
|
* to: a move can never hand it to someone this gate would not have admitted.
|
|
167
339
|
*/
|
|
168
340
|
eligibleRole?: string;
|
|
341
|
+
/**
|
|
342
|
+
* ROLE and ASSIGNEE: the professional qualifications every answerer must ALSO hold (#2967), kinds the application
|
|
343
|
+
* declares in `professionalQualificationKinds`. Read when they act: a qualification verified, within its validity, and
|
|
344
|
+
* recorded by the organization they decide for here — their own organization for one of its own members, the
|
|
345
|
+
* representing organization for someone deciding through a relationship. A floor like `eligibleRole`: a reassignment,
|
|
346
|
+
* an escalation or a claim can never hand the decision to someone without them.
|
|
347
|
+
*
|
|
348
|
+
* Use it when the decision must be taken by a person who is qualified, not merely one who holds a role: a chartered
|
|
349
|
+
* accountant posting an adjustment, a licensed engineer signing off a design. Startup refuses a kind the application
|
|
350
|
+
* does not declare, and an OWNER route (its answerer is the person whose turn it is, who is not vetted).
|
|
351
|
+
*
|
|
352
|
+
* ```ts
|
|
353
|
+
* humanApproval: { route: HumanDecision_RouteKind.ROLE, eligibleRole: 'accountant', requiredQualificationKinds: ['chartered-accountant'] }
|
|
354
|
+
* ```
|
|
355
|
+
*/
|
|
356
|
+
requiredQualificationKinds?: readonly string[];
|
|
169
357
|
/**
|
|
170
358
|
* ASSIGNEE only: resolves the ONE person to route to, when the call pauses, from its arguments and
|
|
171
359
|
* context (for example, the record's account manager). Returning `undefined`, or a person without
|
|
@@ -205,6 +393,51 @@ export interface FunctionTool_HumanApprovalGate {
|
|
|
205
393
|
* target or on an OWNER gate.
|
|
206
394
|
*/
|
|
207
395
|
deadlines?: FunctionTool_HumanApprovalDeadlines;
|
|
396
|
+
/**
|
|
397
|
+
* What a person's DENIAL does to the record the call was about (#3015). A denied call does not run `execute`,
|
|
398
|
+
* so without this a denial changes nothing: an agent's proposal stays proposed, and the application needs a
|
|
399
|
+
* second, unsealed act to record the rejection. Declared here, the denial IS the rejection. It runs once the
|
|
400
|
+
* sealed REJECTED decision has committed, like `execute` once an approval has, with the same context: the
|
|
401
|
+
* requester's authority and the decision's `decisionRef`, which the effect reads back from the engine's record of
|
|
402
|
+
* the decision rather than trusting.
|
|
403
|
+
*
|
|
404
|
+
* It runs only for a person's REJECTED answer, never for a lapse, a withdrawal, or the engine's own denial of a
|
|
405
|
+
* call nobody can answer (nobody decided). It receives the arguments the model proposed (the denied call), and runs
|
|
406
|
+
* in the agent's actor frame, so the rows it writes name the agent, the tool and the decision. Its failure never
|
|
407
|
+
* undoes the decision: the denial stays sealed, the failure is logged, and the resumed turn is told that the record
|
|
408
|
+
* did not move.
|
|
409
|
+
*
|
|
410
|
+
* The usual effect is a server-owned transition (an `INTERNAL_CALL` operation) on the row the call named, given
|
|
411
|
+
* `ctx.decisionRef` and `ctx.executionId` so it can read the decision back before moving anything. The decision is
|
|
412
|
+
* on the conversation's execution row, in whichever of `userFlowActorExecutions`, `organizationFlowActorExecutions`
|
|
413
|
+
* and `applicationFlowActorExecutions` holds it: read each with `readAsSystem` on
|
|
414
|
+
* `{ executionId, lastResolvedDecisionRef: decisionRef }` (the fields are backend-only, and a NOT_FOUND means the
|
|
415
|
+
* next variant). The transition refuses unless `decisionOutcome` is `REJECTED`, `decidedByUserId` is set, and
|
|
416
|
+
* `decisionToolName` equals `modelToolNameForFunctionRef(<this tool's functionRef>)`: the name the model saw, in
|
|
417
|
+
* which a dot becomes `_`, never the dotted functionRef itself.
|
|
418
|
+
*
|
|
419
|
+
* ```ts
|
|
420
|
+
* humanApproval: {
|
|
421
|
+
* route: HumanDecision_RouteKind.ROLE,
|
|
422
|
+
* eligibleRole: 'accountant',
|
|
423
|
+
* onDenied: async (args, ctx) => {
|
|
424
|
+
* const { proposalId } = PostProposal_InputSchema.parse(args); // the arguments the model proposed
|
|
425
|
+
* const { resourcesRegistry, executionContextCreator, servicesRegistryHandler, authorizer } = ctx.services;
|
|
426
|
+
* const contextIds = ctx.organizationId ? { organizationId: ctx.organizationId } : {};
|
|
427
|
+
* const contextFor = (operation: string, path = resourcesRegistry.getServiceOperationPathDefault('proposals', operation)) =>
|
|
428
|
+
* executionContextCreator.buildContextFromSocketAuth(ctx.auth, resourcesRegistry.getOperationFromPath(path), contextIds);
|
|
429
|
+
* // An INTERNAL_CALL operation has no role gate of its own: the requester must hold the row's own UPDATE.
|
|
430
|
+
* await authorizer.authorizeInController(proposalId, await contextFor(CoreResourceOperation.UPDATE,
|
|
431
|
+
* resourcesRegistry.getOperationPathDefault('proposals', CoreResourceOperation.UPDATE)));
|
|
432
|
+
* await servicesRegistryHandler.executeCustomOperation('proposals', 'record_denial', await contextFor('record_denial'),
|
|
433
|
+
* proposalId, { decisionRef: ctx.decisionRef, executionId: ctx.executionId });
|
|
434
|
+
* },
|
|
435
|
+
* }
|
|
436
|
+
* ```
|
|
437
|
+
*
|
|
438
|
+
* 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.
|
|
439
|
+
*/
|
|
440
|
+
onDenied?: (args: unknown, context: FunctionToolExecutionContext) => Promise<void>;
|
|
208
441
|
}
|
|
209
442
|
|
|
210
443
|
/**
|
|
@@ -237,17 +470,68 @@ export interface FunctionTool_ReviewEscalationRule {
|
|
|
237
470
|
* only a tool that READS, or one gated on a REVIEWER — so a write that content from outside asks for is
|
|
238
471
|
* either impossible or seen by a person first. An OWNER-gated tool is not offered there either: a machine
|
|
239
472
|
* turn has no owner to ask, so the call could only ever be denied.
|
|
473
|
+
*
|
|
474
|
+
* A tool that SHOWS records (`presentsRecords`) is offered only to a turn a person watches in a conversation the
|
|
475
|
+
* application draws. An A2A caller receives the reply's text and no tool calls, and an autonomous turn has nobody
|
|
476
|
+
* watching: offered there, the agent would show cards nobody sees and leave them out of the text the reader does get.
|
|
240
477
|
*/
|
|
478
|
+
// assurance-control: WILDO.AI.AGENT_AUTHORITY_CONFINEMENT — a turn started by content from outside is offered no write a reviewer does not see first.
|
|
241
479
|
export function isFunctionToolOfferedToTurn(
|
|
242
|
-
tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'effect'>,
|
|
480
|
+
tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'effect' | 'presentsRecords'>,
|
|
243
481
|
autonomousTrigger: AutonomousTurnTrigger | undefined,
|
|
482
|
+
initiationKind?: FlowsActors_InitiationKind | null,
|
|
244
483
|
): boolean {
|
|
484
|
+
if (tool.presentsRecords === true && (autonomousTrigger !== undefined || !turnIsDrawnForAPerson(initiationKind))) return false;
|
|
245
485
|
if (autonomousTrigger !== AutonomousTurnTrigger.INBOUND_DELIVERY) return true;
|
|
246
486
|
if (tool.effect === FunctionToolEffect.READ) return true;
|
|
247
487
|
const route = resolveFunctionToolApprovalGate(tool)?.route;
|
|
248
488
|
return route === HumanDecision_RouteKind.ROLE || route === HumanDecision_RouteKind.ASSIGNEE;
|
|
249
489
|
}
|
|
250
490
|
|
|
491
|
+
/**
|
|
492
|
+
* The resource whose personal fields a guarded agent's placeholder may be put back into, in this tool's ARGUMENTS
|
|
493
|
+
* (#2848): the resource the arguments describe (`argumentsResource`), else the resource of the records the tool returns
|
|
494
|
+
* (`personalDataOutput: RECORDS_OF_RESOURCE`). `undefined` when the tool names neither: no argument may then carry a
|
|
495
|
+
* placeholder, because nothing says which field of which resource it would land in.
|
|
496
|
+
*
|
|
497
|
+
* Keyed on the ARGUMENTS first because the result declaration says what the model is SENT, not what the tool WRITES: a
|
|
498
|
+
* write whose result is only ids is `NOT_FROM_RECORDS`, and its arguments must still be checked.
|
|
499
|
+
*/
|
|
500
|
+
export function personalDataArgumentsResourceOf(tool: Pick<FunctionTool, 'argumentsResource' | 'personalDataOutput'>): ResourceType | undefined {
|
|
501
|
+
if (tool.argumentsResource !== undefined) return tool.argumentsResource.resourceType;
|
|
502
|
+
return tool.personalDataOutput?.kind === FunctionToolPersonalDataOutputKind.RECORDS_OF_RESOURCE ? tool.personalDataOutput.resourceType : undefined;
|
|
503
|
+
}
|
|
504
|
+
|
|
505
|
+
/**
|
|
506
|
+
* Whether a guarded agent's arguments to this tool are checked and re-identified before it runs (#2848): every tool that
|
|
507
|
+
* can change something (an undeclared `effect` counts as a write), and every tool that names a resource for its
|
|
508
|
+
* arguments or its records. Only a pure read naming no resource passes its arguments as the model wrote them, since
|
|
509
|
+
* nothing it does stores them.
|
|
510
|
+
*
|
|
511
|
+
* Until #2848 the check was keyed on the RESULT declaration alone, so a write tool declaring `NOT_FROM_RECORDS` stored a
|
|
512
|
+
* `⟦withheld:…⟧` marker or a placeholder exactly as the model wrote it.
|
|
513
|
+
*/
|
|
514
|
+
// 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.
|
|
515
|
+
export function functionToolArgumentsAreGuarded(tool: Pick<FunctionTool, 'effect' | 'argumentsResource' | 'personalDataOutput'>): boolean {
|
|
516
|
+
return tool.effect !== FunctionToolEffect.READ || personalDataArgumentsResourceOf(tool) !== undefined;
|
|
517
|
+
}
|
|
518
|
+
|
|
519
|
+
/**
|
|
520
|
+
* Whether a turn's conversation is drawn for a person by the application: a turn over the application's own socket.
|
|
521
|
+
* A turn that records no door predates the door's recording and was a socket turn. Total over the vocabulary.
|
|
522
|
+
*/
|
|
523
|
+
function turnIsDrawnForAPerson(initiationKind: FlowsActors_InitiationKind | null | undefined): boolean {
|
|
524
|
+
if (initiationKind === null || initiationKind === undefined) return true;
|
|
525
|
+
const drawn: Record<FlowsActors_InitiationKind, boolean> = {
|
|
526
|
+
[FlowsActors_InitiationKind.WEBSOCKET_SESSION]: true,
|
|
527
|
+
[FlowsActors_InitiationKind.A2A_REQUEST]: false,
|
|
528
|
+
[FlowsActors_InitiationKind.AUTONOMOUS]: false,
|
|
529
|
+
// The reply is posted in Slack or Teams as text: a card the agent showed would reach nobody (#2665).
|
|
530
|
+
[FlowsActors_InitiationKind.CHAT_MESSAGE]: false,
|
|
531
|
+
};
|
|
532
|
+
return drawn[initiationKind];
|
|
533
|
+
}
|
|
534
|
+
|
|
251
535
|
/** Refused because a tool's approval gate cannot be answered as declared. */
|
|
252
536
|
export class FunctionToolApprovalGateError extends Error {}
|
|
253
537
|
|
|
@@ -258,18 +542,31 @@ export class FunctionToolApprovalGateError extends Error {}
|
|
|
258
542
|
* Throws {@link FunctionToolApprovalGateError} for a declaration nobody could answer. The registry
|
|
259
543
|
* calls it at registration, so that surfaces at startup rather than on the first gated call.
|
|
260
544
|
*/
|
|
261
|
-
|
|
545
|
+
// assurance-control: WILDO.AI.HUMAN_OVERSIGHT — a gated tool's call waits for the person its gate routes it to.
|
|
546
|
+
export function resolveFunctionToolApprovalGate(tool: Pick<FunctionTool, 'functionRef' | 'requiresHumanApproval' | 'humanApproval' | 'asksThePerson'>): FunctionTool_HumanApprovalGate | undefined {
|
|
262
547
|
const gate = tool.humanApproval ?? (tool.requiresHumanApproval ? { route: HumanDecision_RouteKind.OWNER } : undefined);
|
|
548
|
+
// #2720: a question to the person is answered by the person in the conversation, so it is gated, on the OWNER route.
|
|
549
|
+
if (tool.asksThePerson && gate?.route !== HumanDecision_RouteKind.OWNER) {
|
|
550
|
+
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.`);
|
|
551
|
+
}
|
|
263
552
|
if (!gate) return undefined;
|
|
264
553
|
const refuse = (why: string): never => {
|
|
265
554
|
throw new FunctionToolApprovalGateError(`Function tool "${tool.functionRef}" declares an approval gate nobody can answer: ${why}`);
|
|
266
555
|
};
|
|
267
556
|
refuseUnsoundDeadlines(tool.functionRef, gate);
|
|
557
|
+
// #2967: a required qualification names a kind, once each. Whether the application DECLARES it needs the configuration,
|
|
558
|
+
// which a tool does not see: the startup validator asks that.
|
|
559
|
+
const requiredKinds = gate.requiredQualificationKinds ?? [];
|
|
560
|
+
if (requiredKinds.some((kind) => typeof kind !== 'string' || kind.length === 0)) refuse('`requiredQualificationKinds` names an empty kind.');
|
|
561
|
+
if (new Set(requiredKinds).size !== requiredKinds.length) refuse('`requiredQualificationKinds` names a kind twice.');
|
|
268
562
|
switch (gate.route) {
|
|
269
563
|
case HumanDecision_RouteKind.OWNER:
|
|
270
564
|
if (gate.eligibleRole || gate.assignee || gate.escalateTo) {
|
|
271
565
|
refuse('an OWNER route is answered by the person whose turn it is, so it takes no role, assignee or escalation target.');
|
|
272
566
|
}
|
|
567
|
+
if (requiredKinds.length > 0) {
|
|
568
|
+
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.');
|
|
569
|
+
}
|
|
273
570
|
return gate;
|
|
274
571
|
case HumanDecision_RouteKind.ROLE:
|
|
275
572
|
if (!gate.eligibleRole) refuse('a ROLE route must name `eligibleRole`, the role it is routed to.');
|
|
@@ -37,8 +37,19 @@
|
|
|
37
37
|
* @param hostContext backend-owned physical execution context, required only
|
|
38
38
|
* once the selected declared transport is CLI.
|
|
39
39
|
* @returns the same envelope with `output` normalized and `executionContext` enriched.
|
|
40
|
-
* @throws a typed backend error — unknown/inactive agent,
|
|
41
|
-
*
|
|
40
|
+
* @throws a typed backend error — unknown/inactive agent, an agent an administrator suspended (`AGENT_SUSPENDED`, a
|
|
41
|
+
* CONFLICT, read back with `agentSuspensionRefusalOf`, #2843), missing provider key,
|
|
42
|
+
* missing `input.schema` on a structured call, or a provider failure. A provider failure
|
|
43
|
+
* delivered on a STREAMED operation (`STREAM_TEXT`, `STREAM_STRUCTURED`) throws
|
|
44
|
+
* `AgentModelCallFailedError` instead (exported from `@wildo-ai/saas-backend-lib`, not a
|
|
45
|
+
* backend error: test it with `instanceof`), carrying the provider's error, its HTTP
|
|
46
|
+
* `statusCode` when it refused, and the `usage` of the steps that finished first. Inside a flow run, a
|
|
47
|
+
* `FEATURE_LIMIT_EXCEEDED` backend error when the organization's model allowance is spent, or `INFRASTRUCTURE`
|
|
48
|
+
* when it cannot be checked, before the model is called (#2935).
|
|
49
|
+
*
|
|
50
|
+
* Every call is charged to the model allowance of the work it is made in (#2935): the conversational turn or flow
|
|
51
|
+
* run around it, else the organization its work is attributed to. A call whose provider reported no usage is charged
|
|
52
|
+
* an estimate. Application code needs to do nothing for this.
|
|
42
53
|
*/
|
|
43
54
|
public async invokeAgent(
|
|
44
55
|
request: FlowsActors_Agent_Invocation<any, any, any>,
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# saas.backend.flows-actors.operation-approval-resolvers
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/** What a resolver is told about the request it routes. */
|
|
13
|
+
export interface OperationApprovalResolverInput {
|
|
14
|
+
/** The organization the operation was asked in, where the approver must hold the role. */
|
|
15
|
+
readonly organizationId: string;
|
|
16
|
+
/** The person who asked. Never a valid answer: the requester cannot approve their own request. */
|
|
17
|
+
readonly requesterUserId: string;
|
|
18
|
+
readonly resourceType: ResourceType;
|
|
19
|
+
readonly operationIdentifier: string;
|
|
20
|
+
/** The record the operation acts on, for an operation addressed to one record. Absent for a create. */
|
|
21
|
+
readonly targetRecordId?: string;
|
|
22
|
+
/** That record as it stood when the request was held. Absent for a create, and when an escalation re-reads nothing. */
|
|
23
|
+
readonly currentRecord?: Readonly<Record<string, unknown>>;
|
|
24
|
+
/** The values the requester asked for (never a secret: a held request cannot carry one). */
|
|
25
|
+
readonly requestedValues: Readonly<Record<string, unknown>>;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* Names the one person who should approve a request: its `userId`, or `undefined` for nobody. Called when the request
|
|
30
|
+
* is held (`assignee`), when someone escalates it without naming a person, and when a REASSIGN deadline rule fires
|
|
31
|
+
* (`escalateTo`). It may read the application's data; it must not write.
|
|
32
|
+
*
|
|
33
|
+
* @example
|
|
34
|
+
* ```ts
|
|
35
|
+
* export const procurementBackendModule: BackendDomainModule = {
|
|
36
|
+
* // …
|
|
37
|
+
* operationApprovalResolvers: {
|
|
38
|
+
* // The finance approver of the supplier's category, chosen among the people holding the declared role.
|
|
39
|
+
* supplierCategoryOwner: async ({ requestedValues }) => categoryOwners[String(requestedValues.category)],
|
|
40
|
+
* },
|
|
41
|
+
* };
|
|
42
|
+
* // shared resource configuration
|
|
43
|
+
* requiresApproval: { eligibleRole: 'finance-approver', assignee: 'supplierCategoryOwner' }
|
|
44
|
+
* ```
|
|
45
|
+
*/
|
|
46
|
+
export type OperationApprovalResolver = (input: OperationApprovalResolverInput) => Promise<string | undefined>;
|
|
47
|
+
|
|
48
|
+
/** The resolvers one backend module contributes, keyed by the name a variant's `requiresApproval` uses. */
|
|
49
|
+
export type OperationApprovalResolvers = Readonly<Record<string, OperationApprovalResolver>>;
|
|
50
|
+
```
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
# saas.backend.flows-actors.present-records-tool
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The ref `presentRecordsTool` registers under unless told otherwise.
|
|
14
|
+
*/
|
|
15
|
+
export const PRESENT_RECORDS_FUNCTION_REF = 'engine.present-records';
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* A tool through which an agent SHOWS its person the records it is talking about, in the conversation.
|
|
19
|
+
*
|
|
20
|
+
* The agent calls it with a resource type, the ids a read or write tool returned, and the view (`summary`, one card per
|
|
21
|
+
* record). The conversation draws the call as those records' summary cards, with the turn's other work, above its reply.
|
|
22
|
+
* Use it when a list of records says more than a sentence: the todos due this week, the record the agent just created
|
|
23
|
+
* or changed, the candidates it is asking about.
|
|
24
|
+
*
|
|
25
|
+
* Only a reference is kept. The transcript stores a tool call's input and never its result, so the ids are what
|
|
26
|
+
* survives a reload. The browser fetches each record with the viewer's own session whenever it draws the conversation,
|
|
27
|
+
* in the organization the tool read in: a record the viewer cannot read shows as unavailable, and a card shows the
|
|
28
|
+
* record as it was when the conversation was drawn, so a record changed later shows its change on the next draw (the
|
|
29
|
+
* default description tells the agent to show a record again after changing it). A card opens its record when the
|
|
30
|
+
* resource has a page in the application within the viewer's tenancy; otherwise it is drawn without a link.
|
|
31
|
+
*
|
|
32
|
+
* The tool reads each record as the person first, through the resource's own READ operation and its access rules, and
|
|
33
|
+
* tells the agent which records the person sees (`shown`) and which they could not be shown (`unavailable`: missing,
|
|
34
|
+
* or out of their reach, which answer alike). Any other refusal (the operation's roles, a rate limit, a fault) fails the
|
|
35
|
+
* whole call.
|
|
36
|
+
*
|
|
37
|
+
* The tool's result is never stored, so the cards add no copy of a record to the requester's transcript. The agent's
|
|
38
|
+
* reply is stored like any reply, and it names the records it shows.
|
|
39
|
+
*
|
|
40
|
+
* Offered only to a turn a person watches in a conversation the application draws: an external agent over A2A
|
|
41
|
+
* receives the reply's text and no tool calls, and an autonomous turn has nobody watching, so neither is offered it
|
|
42
|
+
* (`isFunctionToolOfferedToTurn`). On a later turn the agent does not see which records it showed (a turn replays the
|
|
43
|
+
* conversation's text only), so it reads a record again before acting on it.
|
|
44
|
+
*
|
|
45
|
+
* `resourceTypes` are the resources the agent may show. Grant only resources it can already read. Each needs a READ
|
|
46
|
+
* operation reachable over HTTP, and its summary is the resource's authored summary layout, else the engine's default
|
|
47
|
+
* from its summary fields.
|
|
48
|
+
*
|
|
49
|
+
* Import path: `@wildo-ai/saas-backend-lib`.
|
|
50
|
+
*
|
|
51
|
+
* @example
|
|
52
|
+
* // backend-api/src/modules/<module>/index.ts
|
|
53
|
+
* flowsActors: { functionTools: [presentRecordsTool({ resourceTypes: ['todos', 'todoLists'] })] }
|
|
54
|
+
* // the agent: capabilities: { tools: { functionRefs: [PRESENT_RECORDS_FUNCTION_REF] } }
|
|
55
|
+
*/
|
|
56
|
+
export function presentRecordsTool(options: {
|
|
57
|
+
resourceTypes: readonly [ResourceType, ...ResourceType[]];
|
|
58
|
+
functionRef?: string;
|
|
59
|
+
description?: string;
|
|
60
|
+
}): FunctionTool {
|
|
61
|
+
const resourceTypes = [...new Set(options.resourceTypes)] as [ResourceType, ...ResourceType[]];
|
|
62
|
+
return {
|
|
63
|
+
functionRef: options.functionRef ?? PRESENT_RECORDS_FUNCTION_REF,
|
|
64
|
+
description: options.description
|
|
65
|
+
?? 'Show the person records you are talking about, as cards in the conversation: the records a question is about, '
|
|
66
|
+
+ 'what you just created or changed, or a short list they asked for. Pass the ids exactly as a read or write tool '
|
|
67
|
+
+ 'returned them, each once. The cards are drawn above your reply, so refer to them as above, name each record you show, and '
|
|
68
|
+
+ 'do not repeat the fields the cards carry. A card shows the record as it is when the conversation is drawn: '
|
|
69
|
+
+ 'after you change a record you showed, show it again. On a later turn, read a record again before acting on it. '
|
|
70
|
+
+ 'It returns { shown, unavailable }: tell the person when a record could not be shown.',
|
|
71
|
+
inputSchema: PresentRecords_ToolInputSchema.extend({
|
|
72
|
+
resourceType: z.enum(resourceTypes).describe('The kind of record to show.'),
|
|
73
|
+
}),
|
|
74
|
+
effect: FunctionToolEffect.READ,
|
|
75
|
+
presentsRecords: true,
|
|
76
|
+
personalDataOutput: { kind: FunctionToolPersonalDataOutputKind.NOT_FROM_RECORDS, reason: 'It returns which record ids were shown or unavailable, never their fields.' },
|
|
77
|
+
authority: { kind: FunctionToolAuthorityKind.PRINCIPAL_RESOURCE_OPERATION },
|
|
78
|
+
execute: async (args: PresentRecords_ToolInput, ctx: FunctionToolExecutionContext): Promise<PresentRecords_ToolResult> => {
|
|
79
|
+
const input = PresentRecords_ToolInputSchema.parse(args);
|
|
80
|
+
if (!resourceTypes.includes(input.resourceType as ResourceType)) {
|
|
81
|
+
throw new Error(`This tool shows only ${resourceTypes.join(', ')} records.`);
|
|
82
|
+
}
|
|
83
|
+
const resourceType = input.resourceType as ResourceType;
|
|
84
|
+
// A resource exposing no URL-bearing READ cannot be drawn by the browser either: a refusal naming the operation,
|
|
85
|
+
// never "unavailable".
|
|
86
|
+
requireDispatchableOperation(ctx, OperationDispatchPlane.AGENT_TOOL, resourceType, CoreResourceOperation.READ);
|
|
87
|
+
const contextIds: Record<string, string> = ctx.organizationId ? { organizationId: ctx.organizationId } : {};
|
|
88
|
+
const readable = await Promise.all(input.ids.map(async (id) => {
|
|
89
|
+
try {
|
|
90
|
+
const record = await dispatchResourceOperationAsTool({ ctx, resourceType, operationIdentifier: CoreResourceOperation.READ, recordId: id, contextIds });
|
|
91
|
+
return record !== null && record !== undefined;
|
|
92
|
+
} catch (error) {
|
|
93
|
+
// A missing row and a row out of the person's reach both answer NOT_FOUND on the row path, alike by design
|
|
94
|
+
// (as `resourceReadTool`). Every other refusal (the operation's roles, a rate limit) fails the call.
|
|
95
|
+
if (isWildoBackendError(error) && error.type === ErrorType.NOT_FOUND) return false;
|
|
96
|
+
throw error;
|
|
97
|
+
}
|
|
98
|
+
}));
|
|
99
|
+
return {
|
|
100
|
+
shown: input.ids.filter((_id, index) => readable[index]),
|
|
101
|
+
unavailable: input.ids.filter((_id, index) => !readable[index]),
|
|
102
|
+
};
|
|
103
|
+
},
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
```
|
|
@@ -26,7 +26,7 @@
|
|
|
26
26
|
* would run with the ACL unread — which is what this factory did until 2026-09-08.) A resource
|
|
27
27
|
* that declares no URL-bearing default for the operation is REFUSED rather than served through its
|
|
28
28
|
* route-less internal variant. WHO the caller is is NEVER taken
|
|
29
|
-
* from the model — only the record `id`, `searchQuery` and `limit` args are. Its `functionRef`
|
|
29
|
+
* from the model — only the record `id`, `searchQuery`, `filters` and `limit` args are. Its `functionRef`
|
|
30
30
|
* defaults to `resource.<resourceType>.read` — reference that exact string from
|
|
31
31
|
* your agent's `capabilities.tools.functionRefs`. Import path:
|
|
32
32
|
* `@wildo-ai/saas-backend-lib`.
|
|
@@ -42,6 +42,19 @@
|
|
|
42
42
|
* record". A resource that declares no URL-bearing READ is refused, as for any operation it does
|
|
43
43
|
* not expose.
|
|
44
44
|
*
|
|
45
|
+
* **Narrowing by a field's value.** The tool also offers `filters`: the filter fields the resource's
|
|
46
|
+
* default SEARCH declares (else its LIST), each as it accepts values — one of an enum's values, a
|
|
47
|
+
* string, a number, a boolean, or a `{ startDate, endDate }` / `{ min, max }` range. They are bound
|
|
48
|
+
* when the tool is registered, from the operation it dispatches, so the model is offered what that
|
|
49
|
+
* operation's repository allows — less the primary scope's field (`organizationId`), which the
|
|
50
|
+
* conversation's own context decides. A question about a status or a category is a filter, never a
|
|
51
|
+
* `searchQuery`: a search for the word "pending" matches no title. Filters work with or without a
|
|
52
|
+
* `searchQuery`, and a resource that declares none offers none. A calendar-day `endDate` includes
|
|
53
|
+
* that whole day (UTC). The result's `truncated` says more records matched than came back.
|
|
54
|
+
* `searchQuery` itself is offered only when the resource's SEARCH can take a text (`isSearchable`
|
|
55
|
+
* with `searchableFields`); when a search fails at run time, the answer is the filtered list and
|
|
56
|
+
* says `searchQueryNotApplied`, so it is never read as what the text found.
|
|
57
|
+
*
|
|
45
58
|
* @param resourceType the resource to expose (any registered `ResourceType`).
|
|
46
59
|
* @param options optional `functionRef` / `description` / `defaultLimit` / `maxLimit` overrides.
|
|
47
60
|
* @example
|