@wildo-ai/framework-knowledge 1.1.0
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/LICENSE +34 -0
- package/dist/esm/.builder.pid +9 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +51 -0
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.definitions.js +1571 -0
- package/dist/esm/framework-knowledge.definitions.js.map +1 -0
- package/dist/esm/framework-knowledge.loader.d.ts +72 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.loader.js +258 -0
- package/dist/esm/framework-knowledge.loader.js.map +1 -0
- package/dist/esm/framework-knowledge.schemas.d.ts +236 -0
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.schemas.js +23 -0
- package/dist/esm/framework-knowledge.schemas.js.map +1 -0
- package/dist/esm/index.d.ts +4 -0
- package/dist/esm/index.d.ts.map +1 -0
- package/dist/esm/index.js +4 -0
- package/dist/esm/index.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +56 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +200 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +228 -0
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +39 -0
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +261 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +412 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +61 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +65 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +54 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +43 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +73 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +53 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +114 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +102 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +258 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +241 -0
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +241 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +202 -0
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +82 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +89 -0
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +56 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +76 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +30 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +27 -0
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +31 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +26 -0
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +254 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +219 -0
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +180 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +302 -0
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +249 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +286 -0
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +48 -0
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +250 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +218 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -0
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -0
- package/dist/knowledge/manifest.json +45 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +407 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +556 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +47 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +344 -0
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +259 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +83 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +321 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +79 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +185 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +737 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +44 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +261 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +151 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +124 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.business-model/method.md +128 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +102 -0
- package/dist/knowledge/playbooks/top_down.business-model/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +73 -0
- package/dist/knowledge/playbooks/top_down.capability-map/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +177 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +95 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +64 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +49 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +239 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +69 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +96 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +77 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +53 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +61 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +280 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +87 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/structured-artifact-action.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +204 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +146 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/structured-artifact-action.json +1 -0
- package/dist/knowledge/references/application.database.migration-change-risk.md +28 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +90 -0
- package/dist/knowledge/references/assertions.behaviors.wire-contracts.md +223 -0
- package/dist/knowledge/references/assertions.references.conventions.md +92 -0
- package/dist/knowledge/references/assertions.snapshot.validation.md +317 -0
- package/dist/knowledge/references/assertions.specification.config.md +287 -0
- package/dist/knowledge/references/brand.asset.config.md +167 -0
- package/dist/knowledge/references/brand.authored-metadata.config.md +51 -0
- package/dist/knowledge/references/brand.logo-direction.config.md +88 -0
- package/dist/knowledge/references/brand.name.config.md +46 -0
- package/dist/knowledge/references/brand.snapshot.config.md +76 -0
- package/dist/knowledge/references/brand.snapshot.validation.md +446 -0
- package/dist/knowledge/references/brand.visual-tone.config.md +56 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +198 -0
- package/dist/knowledge/references/business-model.authored-metadata.config.md +65 -0
- package/dist/knowledge/references/business-model.pricing-plan.config.md +122 -0
- package/dist/knowledge/references/business-model.references.conventions.md +99 -0
- package/dist/knowledge/references/business-model.snapshot.config.md +121 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +325 -0
- package/dist/knowledge/references/cli.market.generate-command.md +230 -0
- package/dist/knowledge/references/cli.market.utils.md +147 -0
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +90 -0
- package/dist/knowledge/references/companion.introspection.handlers.market.md +42 -0
- package/dist/knowledge/references/companion.market.generation-service.md +270 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +244 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +809 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +125 -0
- package/dist/knowledge/references/engine.client-bundle.discipline.md +130 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +55 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +215 -0
- package/dist/knowledge/references/engine.saas-website.config.md +331 -0
- package/dist/knowledge/references/example.authorization.unit-narrowing.declaration.md +24 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +55 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +35 -0
- package/dist/knowledge/references/example.backend.operation.error-throw.md +17 -0
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +63 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +147 -0
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.quick-switcher-fields.md +37 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +20 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +46 -0
- package/dist/knowledge/references/example.config.design-system.full.md +162 -0
- package/dist/knowledge/references/example.config.navigation.full.md +71 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +27 -0
- package/dist/knowledge/references/example.data-seeding.minimal.md +114 -0
- package/dist/knowledge/references/example.email.template.minimal.md +54 -0
- package/dist/knowledge/references/example.engine.component-registration.lazy-load.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +146 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +196 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +174 -0
- package/dist/knowledge/references/example.i18n.label-generation.engine-barrel.md +15 -0
- package/dist/knowledge/references/example.infra.cdn.cloudflare.md +23 -0
- package/dist/knowledge/references/example.infra.cdn.generic.md +17 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +250 -0
- package/dist/knowledge/references/example.market.alternative.in-house-build.md +49 -0
- package/dist/knowledge/references/example.market.authored-metadata.md +32 -0
- package/dist/knowledge/references/example.market.buying-journey.core-icp.md +140 -0
- package/dist/knowledge/references/example.market.category.config.md +71 -0
- package/dist/knowledge/references/example.market.channel.community.md +39 -0
- package/dist/knowledge/references/example.market.feature-benefit.kano-threshold.md +67 -0
- package/dist/knowledge/references/example.market.feature-benefit.pain-reliever.md +65 -0
- package/dist/knowledge/references/example.market.icp.anti-target.md +47 -0
- package/dist/knowledge/references/example.market.icp.individual.md +82 -0
- package/dist/knowledge/references/example.market.icp.legal-entity-with-geographies.md +95 -0
- package/dist/knowledge/references/example.market.is-benefit-available.composition.md +40 -0
- package/dist/knowledge/references/example.market.job.emotional.md +27 -0
- package/dist/knowledge/references/example.market.job.functional.md +28 -0
- package/dist/knowledge/references/example.market.message-template.seeds.md +106 -0
- package/dist/knowledge/references/example.market.objection.pricing.md +39 -0
- package/dist/knowledge/references/example.market.persona.dmu-with-inheritance.md +62 -0
- package/dist/knowledge/references/example.market.persona.individual-self.md +51 -0
- package/dist/knowledge/references/example.market.positioning.per-icp.md +103 -0
- package/dist/knowledge/references/example.market.proof.metric.md +39 -0
- package/dist/knowledge/references/example.market.scoring.golden-case.md +46 -0
- package/dist/knowledge/references/example.market.scoring.no-coverage-zero.md +40 -0
- package/dist/knowledge/references/example.market.snapshot-validation.duplicate-journey-stage.md +36 -0
- package/dist/knowledge/references/example.market.snapshot-validation.errors-by-kind.md +55 -0
- package/dist/knowledge/references/example.market.snapshot-validation.objection-proof-benefit-mismatch.md +74 -0
- package/dist/knowledge/references/example.market.snapshot-validation.proof-without-support.md +32 -0
- package/dist/knowledge/references/example.market.snapshot-validation.threshold-without-job.md +44 -0
- package/dist/knowledge/references/example.market.snapshot.assembled.md +49 -0
- package/dist/knowledge/references/example.market.tone-of-voice.config.md +41 -0
- package/dist/knowledge/references/example.market.trigger.growth-milestone.md +43 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +142 -0
- package/dist/knowledge/references/example.module.registration.shared.md +16 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +47 -0
- package/dist/knowledge/references/example.module.relationships.discriminator.md +25 -0
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +110 -0
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +12 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +30 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +21 -0
- package/dist/knowledge/references/example.rag.source-fields.declaration.md +83 -0
- package/dist/knowledge/references/example.rate-limit.custom-controller-surface.md +25 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +24 -0
- package/dist/knowledge/references/example.resource.add-field.priority-enum.md +19 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +21 -0
- package/dist/knowledge/references/example.resource.config-wiring.fk-relationship.md +33 -0
- package/dist/knowledge/references/example.resource.custom-view.read-host.md +28 -0
- package/dist/knowledge/references/example.resource.mcp-exposure.md +65 -0
- package/dist/knowledge/references/example.resource.reference-constraints.role-constrained.md +27 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +22 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +43 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +72 -0
- package/dist/knowledge/references/example.spec.feature.flag-with-codehandling.md +64 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +88 -0
- package/dist/knowledge/references/example.spec.resource.semantic-field.md +23 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +19 -0
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +69 -0
- package/dist/knowledge/references/example.views.composite-view.host-embeds.md +31 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +65 -0
- package/dist/knowledge/references/example.views.custom-view.execution-host.md +41 -0
- package/dist/knowledge/references/example.views.execution-view.resource-owned.md +25 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +42 -0
- package/dist/knowledge/references/market.alternative.config.md +68 -0
- package/dist/knowledge/references/market.alternative.kind.md +32 -0
- package/dist/knowledge/references/market.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/market.buying-journey.config.md +43 -0
- package/dist/knowledge/references/market.buying-journey.stage.md +33 -0
- package/dist/knowledge/references/market.category.config.md +63 -0
- package/dist/knowledge/references/market.channel.config.md +59 -0
- package/dist/knowledge/references/market.channel.kind.md +49 -0
- package/dist/knowledge/references/market.context-block.builder.md +544 -0
- package/dist/knowledge/references/market.context-block.response.md +57 -0
- package/dist/knowledge/references/market.feature-benefit.config.md +84 -0
- package/dist/knowledge/references/market.feature-benefit.kano.md +41 -0
- package/dist/knowledge/references/market.gain.config.md +50 -0
- package/dist/knowledge/references/market.generation.response.md +108 -0
- package/dist/knowledge/references/market.icp.config.md +162 -0
- package/dist/knowledge/references/market.icp.geographic-targeting.md +57 -0
- package/dist/knowledge/references/market.inherit-from.md +74 -0
- package/dist/knowledge/references/market.is-benefit-available.md +58 -0
- package/dist/knowledge/references/market.job.config.md +48 -0
- package/dist/knowledge/references/market.message-template.config.md +86 -0
- package/dist/knowledge/references/market.objection.config.md +56 -0
- package/dist/knowledge/references/market.objection.kind.md +34 -0
- package/dist/knowledge/references/market.pain.config.md +50 -0
- package/dist/knowledge/references/market.persona.config.md +64 -0
- package/dist/knowledge/references/market.positioning.config.md +84 -0
- package/dist/knowledge/references/market.proof.config.md +48 -0
- package/dist/knowledge/references/market.proof.kind.md +34 -0
- package/dist/knowledge/references/market.references.weighted-edges.md +105 -0
- package/dist/knowledge/references/market.scoring.fit.md +215 -0
- package/dist/knowledge/references/market.snapshot.config.md +34 -0
- package/dist/knowledge/references/market.snapshot.validation.md +1171 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +80 -0
- package/dist/knowledge/references/market.trigger.config.md +45 -0
- package/dist/knowledge/references/market.trigger.kind.md +35 -0
- package/dist/knowledge/references/placement-plan.config.md +330 -0
- package/dist/knowledge/references/platform.config.application-database.md +74 -0
- package/dist/knowledge/references/platform.config.application-modules.md +30 -0
- package/dist/knowledge/references/platform.config.backing-services.md +266 -0
- package/dist/knowledge/references/platform.config.cdn.md +167 -0
- package/dist/knowledge/references/platform.config.environment.deployment.md +263 -0
- package/dist/knowledge/references/platform.config.saas.md +405 -0
- package/dist/knowledge/references/presets.models.design-system.configuration.md +59 -0
- package/dist/knowledge/references/presets.models.design-system.source-config.md +72 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +64 -0
- package/dist/knowledge/references/presets.models.material.profile-contract.md +192 -0
- package/dist/knowledge/references/presets.models.material.runtime-policy.md +60 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +613 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +534 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +56 -0
- package/dist/knowledge/references/requirements.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +68 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +100 -0
- package/dist/knowledge/references/requirements.references.conventions.md +125 -0
- package/dist/knowledge/references/requirements.snapshot.config.md +73 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +333 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/roadmap.phase.config.md +149 -0
- package/dist/knowledge/references/roadmap.references.conventions.md +89 -0
- package/dist/knowledge/references/roadmap.snapshot.config.md +65 -0
- package/dist/knowledge/references/roadmap.snapshot.validation.md +325 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +32 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +38 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +45 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +53 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +120 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +237 -0
- package/dist/knowledge/references/saas.backend.email-template.definition.md +69 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-agent-card.md +89 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +118 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +48 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +39 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +67 -0
- package/dist/knowledge/references/saas.backend.pdf-template.bindings.md +52 -0
- package/dist/knowledge/references/saas.backend.pdf-template.definition.md +113 -0
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +75 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +994 -0
- package/dist/knowledge/references/saas.data-seeding.admin-endpoints.md +59 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +184 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +95 -0
- package/dist/knowledge/references/saas.data-seeding.modes.md +72 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +198 -0
- package/dist/knowledge/references/saas.data-seeding.run-status.md +35 -0
- package/dist/knowledge/references/saas.data-seeding.schedule.md +91 -0
- package/dist/knowledge/references/saas.data-seeding.scope-iteration-strategy.md +46 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +55 -0
- package/dist/knowledge/references/saas.external-providers.document-extraction.applicability.md +26 -0
- package/dist/knowledge/references/saas.external-providers.embeddings.applicability.md +30 -0
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +124 -0
- package/dist/knowledge/references/saas.external-providers.llm.operation-key.md +49 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +265 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +148 -0
- package/dist/knowledge/references/saas.frontend.app-shell.hosted-components.md +145 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +80 -0
- package/dist/knowledge/references/saas.frontend.command-menu.omnibox.md +88 -0
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +109 -0
- package/dist/knowledge/references/saas.frontend.component-registration.entry.md +21 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +102 -0
- package/dist/knowledge/references/saas.frontend.composite-view.define-helper.md +31 -0
- package/dist/knowledge/references/saas.frontend.domain-module.md +31 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +37 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +115 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +172 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.local-pane.md +109 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-bridge-contract.md +55 -0
- package/dist/knowledge/references/saas.frontend.execution-view.dirty-state-contract.md +151 -0
- package/dist/knowledge/references/saas.frontend.execution-view.failure-handling-contract.md +302 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.md +89 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.md +231 -0
- package/dist/knowledge/references/saas.frontend.execution-view.loading-aggregation.participation-prefetch.shell-data-hydrator.md +174 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.navigation-handling-and-embedding.resolution.md +45 -0
- package/dist/knowledge/references/saas.frontend.execution-view.outcome-emission-contract.md +71 -0
- package/dist/knowledge/references/saas.frontend.execution-view.participation-and-anchor.md +80 -0
- package/dist/knowledge/references/saas.frontend.execution-view.three-zone-contract.md +147 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +40 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +80 -0
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +64 -0
- package/dist/knowledge/references/saas.frontend.inserted-view.identity-bindings-descriptor.md +149 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +63 -0
- package/dist/knowledge/references/saas.frontend.quick-switcher.scope-field.md +102 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +86 -0
- package/dist/knowledge/references/saas.frontend.related-resource-preview.md +23 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +28 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +43 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +215 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +531 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +210 -0
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-preset-map.md +39 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +58 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +118 -0
- package/dist/knowledge/references/saas.frontend.view-definition-scope.md +42 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +104 -0
- package/dist/knowledge/references/saas.models.core-resource-operation.md +86 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +395 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +114 -0
- package/dist/knowledge/references/saas.models.error-type.md +45 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +162 -0
- package/dist/knowledge/references/saas.models.feature-limit-semantic.md +51 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +127 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +115 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-invocation.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-prompt-spec.md +188 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +237 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +149 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +22 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-declaration.md +42 -0
- package/dist/knowledge/references/saas.models.polymorphism.optout-business-key.md +62 -0
- package/dist/knowledge/references/saas.models.polymorphism.variant-definition.md +74 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +97 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +67 -0
- package/dist/knowledge/references/saas.models.relationship-handling-contract.md +30 -0
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +62 -0
- package/dist/knowledge/references/saas.models.relationship-nature-and-models.md +112 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +431 -0
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +88 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +79 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-path.md +27 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +26 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +62 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +124 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-relationships-buckets.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.searchable-relation.md +89 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +121 -0
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +145 -0
- package/dist/knowledge/references/saas.models.resource-field-identifier.md +25 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +77 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +58 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +36 -0
- package/dist/knowledge/references/saas.models.resource-relationship-access-scope.md +26 -0
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +100 -0
- package/dist/knowledge/references/saas.models.resource-relationship-cardinality.md +57 -0
- package/dist/knowledge/references/saas.models.resource-relationship-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.resource-relationship-resolved-semantics.md +60 -0
- package/dist/knowledge/references/saas.models.resource-relationship-schema.md +172 -0
- package/dist/knowledge/references/saas.models.resource-server-instance.md +109 -0
- package/dist/knowledge/references/saas.models.resource-type.md +24 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +242 -0
- package/dist/knowledge/references/saas.models.scope-membership.md +143 -0
- package/dist/knowledge/references/saas.models.shared-domain-module.md +36 -0
- package/dist/knowledge/references/saas.models.shared-saas-module.md +36 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +229 -0
- package/dist/knowledge/references/saas.rag.retrieval-bounds.md +106 -0
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +89 -0
- package/dist/knowledge/references/saas.rag.retrieval-request.md +130 -0
- package/dist/knowledge/references/saas.rag.retrieval-result.md +147 -0
- package/dist/knowledge/references/saas.rag.retrieval-scores.md +54 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +59 -0
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +1158 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +2602 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +180 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +138 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-rating.md +47 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-article.md +49 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-blog-posting.md +62 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-breadcrumb-list.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-faq-page.md +51 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-offer.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-organization.md +48 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +59 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-review.md +46 -0
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-website.md +46 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +530 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +49 -0
- package/dist/knowledge/references/saas.specifications.error-message-specification.md +92 -0
- package/dist/knowledge/references/saas.specifications.family-specifications.md +109 -0
- package/dist/knowledge/references/saas.specifications.feature-specification.md +93 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-factory.md +113 -0
- package/dist/knowledge/references/saas.specifications.frontend-component-spec-model.md +366 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +41 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +1978 -0
- package/dist/knowledge/references/saas.specifications.resource-pdf-template-spec.md +58 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-code-handling.md +49 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +156 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +171 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-config-type.md +54 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +171 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +262 -0
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +271 -0
- package/dist/knowledge/references/saas.website.astro.headers-renderer.md +41 -0
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +121 -0
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +117 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +377 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +46 -0
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +90 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +187 -0
- package/dist/knowledge/references/saas.website.astro.site-context.md +141 -0
- package/dist/knowledge/references/saas.website.astro.sitemap-coverage.md +188 -0
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +174 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +396 -0
- package/dist/knowledge/references/saas.website.blog.collection-config.md +180 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +116 -0
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +292 -0
- package/dist/knowledge/references/saas.website.blog.mdx-provider.md +100 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +291 -0
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +29 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +64 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +38 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +98 -0
- package/dist/knowledge/references/saas.website.factories.define-section.md +128 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +36 -0
- package/dist/knowledge/references/saas.website.label-keys.format.md +67 -0
- package/dist/knowledge/references/saas.website.label-pack.validator.md +206 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +217 -0
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +47 -0
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +49 -0
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +186 -0
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +46 -0
- package/dist/knowledge/references/saas.website.page.context.md +57 -0
- package/dist/knowledge/references/saas.website.primitives.button.md +123 -0
- package/dist/knowledge/references/saas.website.primitives.heading.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.image.md +103 -0
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +151 -0
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +193 -0
- package/dist/knowledge/references/saas.website.primitives.link.md +78 -0
- package/dist/knowledge/references/saas.website.primitives.text.md +82 -0
- package/dist/knowledge/references/saas.website.refs.page.md +56 -0
- package/dist/knowledge/references/saas.website.refs.section.md +57 -0
- package/dist/knowledge/references/saas.website.root-config.navigation.md +37 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +192 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +98 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +84 -0
- package/dist/knowledge/references/saas.website.runtime.context.md +174 -0
- package/dist/knowledge/references/saas.website.section.component.md +138 -0
- package/dist/knowledge/references/saas.website.section.context.md +63 -0
- package/dist/knowledge/references/saas.website.sections.category-enum.md +72 -0
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +121 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +37 -0
- package/dist/knowledge/references/saas.website.seo.robots-config.md +106 -0
- package/dist/knowledge/references/saas.website.seo.sitemap-config.md +73 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +71 -0
- package/dist/knowledge/references/saas.website.use-label-by-key.hook.md +45 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +82 -0
- package/dist/knowledge/references/saas.website.use-page.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-section.hook.md +30 -0
- package/dist/knowledge/references/saas.website.use-tokens.hook.md +32 -0
- package/dist/knowledge/references/vision.authored-metadata.config.md +64 -0
- package/dist/knowledge/references/vision.constraint.config.md +66 -0
- package/dist/knowledge/references/vision.idea.config.md +45 -0
- package/dist/knowledge/references/vision.mission.config.md +46 -0
- package/dist/knowledge/references/vision.problem.config.md +51 -0
- package/dist/knowledge/references/vision.references.conventions.md +115 -0
- package/dist/knowledge/references/vision.snapshot.config.md +85 -0
- package/dist/knowledge/references/vision.snapshot.validation.md +226 -0
- package/dist/knowledge/references/vision.success-criterion.config.md +60 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +550 -0
- package/dist/knowledge/references/zod.decorators.conditional-visibility.md +104 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +436 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +174 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +101 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +317 -0
- package/dist/knowledge/references/zod.decorators.file-generation.md +36 -0
- package/dist/knowledge/references/zod.decorators.file-rag-source.md +56 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +319 -0
- package/dist/knowledge/references/zod.decorators.foreign-key-display-mode.md +83 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +459 -0
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +123 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +164 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +122 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +152 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +314 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +529 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +155 -0
- package/dist/knowledge/references/zod.factories.code.md +127 -0
- package/dist/knowledge/references/zod.factories.duration.md +246 -0
- package/dist/knowledge/references/zod.factories.money.md +166 -0
- package/dist/knowledge/references/zod.factories.phone.md +88 -0
- package/dist/knowledge/references/zod.factories.range.md +174 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +15 -0
- package/dist/knowledge/registries/framework-topics.json +5212 -0
- package/dist/knowledge/registries/playbooks.json +488 -0
- package/dist/knowledge/registries/source-tags.json +7664 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +77 -0
- package/dist/knowledge/skills/INDEX.md +349 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/examples/domain-use-case-and-admin-task.example.md +49 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +52 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +218 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +84 -0
- package/dist/knowledge/skills/application-database-migrations/references/framework-migration-change-risk-api.md +37 -0
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +323 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +84 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +324 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/backend-di-routing.md +7 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +374 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +118 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +107 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +134 -0
- package/dist/knowledge/skills/backend-custom-operation/references/operation-file-conventions.md +10 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +192 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +55 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +184 -0
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +279 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +346 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +160 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +158 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +95 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +100 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +1210 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +40 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +698 -0
- package/dist/knowledge/skills/config-app-shell/references/app-shell-surfaces.md +5 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +415 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +170 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +212 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-quick-switcher-scope-field-api.md +178 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +424 -0
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +10 -0
- package/dist/knowledge/skills/config-design-system/references/framework-design-system-configuration-api.md +77 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-profile-api.md +200 -0
- package/dist/knowledge/skills/config-design-system/references/framework-material-runtime-policy-api.md +68 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +1212 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +92 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +249 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +152 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +5 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +209 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +221 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +408 -0
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +183 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +40 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +261 -0
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +90 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +122 -0
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +48 -0
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +69 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +57 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +439 -0
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +9 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +72 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +62 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +64 -0
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +62 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +257 -0
- package/dist/knowledge/skills/engine-component-registration/references/component-registration-file.md +7 -0
- package/dist/knowledge/skills/engine-component-registration/references/framework-component-registration-api.md +24 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +429 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +287 -0
- package/dist/knowledge/skills/engine-product-definitions/references/product-registry-scope.md +5 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +491 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +227 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-named-a2a-agents-contract.md +143 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +368 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +226 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +286 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +376 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +262 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +130 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-prompt-spec-api.md +214 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +195 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/operation-key-selection.md +60 -0
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +237 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/cloudflare-and-operator-setup.md +56 -0
- package/dist/knowledge/skills/frontend-cdn-publish/references/framework-cdn-config-api.md +176 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +261 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-label-generation/references/label-placement.md +7 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +269 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/i18n-routing.md +9 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +245 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +67 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +17 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +646 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +77 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +282 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +265 -0
- package/dist/knowledge/skills/infra-environment-config/references/infra-config-files.md +7 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-next/SKILL.md +42 -0
- package/dist/knowledge/skills/journey-report/SKILL.md +43 -0
- package/dist/knowledge/skills/journey-run/SKILL.md +55 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +370 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +50 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +409 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +247 -0
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +474 -0
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +139 -0
- package/dist/knowledge/skills/market-alternatives/SKILL.md +543 -0
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +354 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +138 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +129 -0
- package/dist/knowledge/skills/market-category/SKILL.md +290 -0
- package/dist/knowledge/skills/market-channels/SKILL.md +361 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +2752 -0
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +2443 -0
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +1484 -0
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +1230 -0
- package/dist/knowledge/skills/market-icp/SKILL.md +625 -0
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +352 -0
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +415 -0
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1439 -0
- package/dist/knowledge/skills/market-persona/SKILL.md +407 -0
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +392 -0
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +97 -0
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +665 -0
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +620 -0
- package/dist/knowledge/skills/market-scoring-interpretation/references/framework-scoring-api.md +291 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1706 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +1228 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +260 -0
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +579 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +318 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +544 -0
- package/dist/knowledge/skills/module-registration/SKILL.md +212 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +366 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +9 -0
- package/dist/knowledge/skills/module-relationships/SKILL.md +523 -0
- package/dist/knowledge/skills/module-relationships/references/cross-resource-fk-checklist.md +7 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +738 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +174 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-api.md +203 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-template-spec-api.md +62 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +239 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +90 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +50 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +652 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +182 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/scope-key-and-bucket-conventions.md +137 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +272 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +153 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +845 -0
- package/dist/knowledge/skills/resource-add-module/SKILL.md +322 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +67 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +15 -0
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +222 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +540 -0
- package/dist/knowledge/skills/resource-add-resource/references/scaffold-surfaces-checklist.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +370 -0
- package/dist/knowledge/skills/resource-config-wiring/references/config-change-routing.md +11 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +622 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +248 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +1769 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +1209 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +228 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +693 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +349 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +187 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +261 -0
- package/dist/knowledge/skills/resource-external-data/references/lane-selection.md +49 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +43 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +308 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-named-mcp-servers-contract.md +166 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +63 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +77 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-client-registration-postures.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +424 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/corpus-field-selection.md +90 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +261 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-file-rag-source-api.md +117 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +597 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +181 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +318 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +132 -0
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +70 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +559 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-polymorphic-resources-api.md +147 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +247 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +164 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +327 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +1286 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +1080 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +75 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +62 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +69 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +45 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +389 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-conditional-visibility-api.md +106 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +176 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +103 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-foreign-key-ui-api.md +97 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +839 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +461 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +125 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +245 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +302 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/ui-layer-boundaries.md +13 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +569 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +154 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +176 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +505 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +337 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +171 -0
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +662 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +134 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +65 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +127 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +726 -0
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +242 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +362 -0
- package/dist/knowledge/skills/spec-companion-exports/references/companion-export-checklist.md +8 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +533 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +315 -0
- package/dist/knowledge/skills/spec-component-update/references/component-spec-props.md +8 -0
- package/dist/knowledge/skills/spec-component-update/references/framework-frontend-component-spec-api.md +481 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +283 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/composite-spec-sections.md +5 -0
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +51 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +300 -0
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +13 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-error-message-specifications-api.md +108 -0
- package/dist/knowledge/skills/spec-family-update/references/framework-family-specifications-api.md +111 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +306 -0
- package/dist/knowledge/skills/spec-feature-update/references/feature-spec-scope.md +5 -0
- package/dist/knowledge/skills/spec-feature-update/references/framework-feature-specification-api.md +95 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +220 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +319 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +2610 -0
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +12 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +195 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +173 -0
- package/dist/knowledge/skills/spec-update-after-change/references/spec-maintenance-by-surface.md +33 -0
- package/dist/knowledge/skills/spec-update-after-change/references/surface-to-spec-routing.md +14 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +259 -0
- package/dist/knowledge/skills/views-add-composite-view/references/composite-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-composite-view/references/framework-inserted-view-identity-api.md +151 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +225 -0
- package/dist/knowledge/skills/views-add-custom-view/references/custom-view-routing.md +10 -0
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +201 -0
- package/dist/knowledge/skills/views-app-level/references/app-level-views-routing.md +9 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +107 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +264 -0
- package/dist/knowledge/skills/views-chart-authoring/references/chart-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +82 -0
- package/dist/knowledge/skills/views-chart-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +302 -0
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +23 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +133 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +209 -0
- package/dist/knowledge/skills/views-execution-authoring/references/execution-view-checklist.md +7 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +389 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-inserted-view-identity-api.md +152 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +444 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +587 -0
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1426 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +553 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +52 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +357 -0
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +511 -0
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +376 -0
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +304 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +390 -0
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +461 -0
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +264 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +414 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +366 -0
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +420 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +256 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +302 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +950 -0
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-cta/SKILL.md +822 -0
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-faq/SKILL.md +917 -0
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +878 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +895 -0
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +814 -0
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-hero/SKILL.md +944 -0
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +583 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +934 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +912 -0
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +579 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +624 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +633 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +193 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +790 -0
- package/dist/knowledge/topic-index.json +17510 -0
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -0
- package/package.json +49 -0
|
@@ -0,0 +1,491 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: flows-actors-a2a-exposure
|
|
3
|
+
description: Expose your app's actor systems to EXTERNAL AI agents over the Agent2Agent (A2A) protocol, so other agents can discover and converse with them. Use when the user says "expose my actor as an A2A agent", "let other AI agents call my assistant", "agent2agent", "A2A endpoint", "expose an agent to external agents", "machine / client-credentials access to my chat agent", "how do external agents authenticate to my actor system", or "agent card" — i.e. the intent is EXTERNAL agent-to-agent access, NOT the in-app chat view and NOT exposing resource CRUD as tools (that is MCP).
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Expose an Actor System over Agent2Agent (A2A) — Workflow
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
A2A exposes your **agentic actor systems** to external AI agents so they can
|
|
23
|
+
discover and converse with them agent-to-agent. The engine owns the whole
|
|
24
|
+
transport — you author almost nothing:
|
|
25
|
+
|
|
26
|
+
- **Exposure is automatic.** Every ACTOR system with an AGENTIC actor bound to an
|
|
27
|
+
agent is served as one A2A skill (`skill.id === system.ref`). Build the actor
|
|
28
|
+
system exactly as for the in-app assistant (`flows-actors-chat-assistant`); no
|
|
29
|
+
per-system A2A flag.
|
|
30
|
+
- **The engine serves two endpoints**: a public agent card at
|
|
31
|
+
`GET /a2a/.well-known/agent-card.json` (discovery) and the Bearer-authenticated
|
|
32
|
+
JSON-RPC endpoint `POST /a2a` (`message/send` blocking, `message/stream` SSE).
|
|
33
|
+
- **Auth is your app's OIDC provider**, two principals (external-access D6): a
|
|
34
|
+
**user-delegated** token (`authorizationCode` → the conversation is owned by the
|
|
35
|
+
delegating user) OR a **machine** token (`clientCredentials` → owned by the org
|
|
36
|
+
or app the credential belongs to). The turn runs under the caller's OWN roles +
|
|
37
|
+
scope — tools read with the caller's visibility, never LLM-supplied identity, no
|
|
38
|
+
`systemAccessPolicy` bypass.
|
|
39
|
+
|
|
40
|
+
So your job is: (1) have an agentic actor system, (2) enable the OIDC provider and
|
|
41
|
+
provision an OAuth client for machine callers, (3) hand external agents the card
|
|
42
|
+
URL. Ownership is polymorphic: user / org / app conversations are separate,
|
|
43
|
+
scope-isolated variants.
|
|
44
|
+
|
|
45
|
+
## App Paths
|
|
46
|
+
|
|
47
|
+
| Surface | Glob (relative to app root) |
|
|
48
|
+
|---|---|
|
|
49
|
+
| Agentic actor system + agent + tools (the exposed skill) | `backend-api/src/modules/<module>/addons/flows-actors/*.ts` |
|
|
50
|
+
| OIDC provider + OAuth clients config (external auth) | `wildo.saas.config.ts` · `infrastructure/**` (auth/OIDC + OAuth-client provisioning) |
|
|
51
|
+
| Backend module assembly (`flowsActors: …`) | `backend-api/src/modules/<module>/index.ts` |
|
|
52
|
+
|
|
53
|
+
## When to Use
|
|
54
|
+
|
|
55
|
+
- An **external** AI agent (another company's agent, an orchestrator, an MCP/A2A
|
|
56
|
+
client) must **discover and converse** with one of your actor systems.
|
|
57
|
+
- You need **machine (client-credentials)** access so an autonomous agent — not a
|
|
58
|
+
signed-in human — owns and drives a conversation at org/app scope.
|
|
59
|
+
|
|
60
|
+
## When NOT to Use
|
|
61
|
+
|
|
62
|
+
- **An in-app chat page for your own users** → `flows-actors-chat-assistant` (same
|
|
63
|
+
actor system; that skill builds the WebSocket view).
|
|
64
|
+
- **Exposing resource CRUD as callable tools** to external agents → that is **MCP**
|
|
65
|
+
(`operation.mcp.exposed`) — the sibling skill `resource-mcp-tool-exposure`, not A2A.
|
|
66
|
+
- **A one-shot generation agent** with no conversation → a plain `FlowsActors_Agent`
|
|
67
|
+
invoked by your own service.
|
|
68
|
+
|
|
69
|
+
## Workflow
|
|
70
|
+
|
|
71
|
+
### Step 1: Confirm the actor system is agentic (→ it is already exposed)
|
|
72
|
+
File: `backend-api/src/modules/<module>/addons/flows-actors/*.ts`. The system must
|
|
73
|
+
be `kind: ACTOR` with an actor whose `executionMode` is `AGENTIC` and a bound
|
|
74
|
+
`agentRef`. If it renders an in-app chat, it already qualifies — build it via
|
|
75
|
+
`flows-actors-chat-assistant`. Verify what will be advertised:
|
|
76
|
+
// TODO CLI COMMAND: wildo context flows-actors --a2a-exposable
|
|
77
|
+
|
|
78
|
+
### Step 2: Enable external auth (OIDC provider + OAuth client)
|
|
79
|
+
External agents get a token from YOUR app's OIDC provider. For **user-delegated**
|
|
80
|
+
callers, the `authorizationCode` flow issues a token whose `aud` is the agent card
|
|
81
|
+
`url`. For **machine** callers, provision an **OAuth client** (org- or app-scoped)
|
|
82
|
+
and use the `clientCredentials` flow. Configure both in your auth/OIDC config;
|
|
83
|
+
the agent card advertises whichever flows are available.
|
|
84
|
+
|
|
85
|
+
### Step 3: Understand what external agents do (you do not author this)
|
|
86
|
+
1. `GET /a2a/.well-known/agent-card.json` → the card (skills + `securitySchemes`).
|
|
87
|
+
2. Obtain a Bearer token from the OIDC provider (`/oauth/authorize` + `/oauth/token`
|
|
88
|
+
for user-delegated; `/oauth/token` `grant_type=client_credentials` for machine).
|
|
89
|
+
3. `POST /a2a` JSON-RPC `message/send` (or `message/stream`), selecting a skill via
|
|
90
|
+
`message.metadata.skillId` (omit when the app exposes exactly one).
|
|
91
|
+
|
|
92
|
+
### Step 4: Verify ownership + isolation
|
|
93
|
+
A user-delegated turn persists to `userFlowActorExecutions` (owned by the user); a
|
|
94
|
+
machine turn persists to `organization`/`applicationFlowActorExecutions` (owned by
|
|
95
|
+
the org/app). Each is scope-isolated — a caller only ever sees its own scope's
|
|
96
|
+
conversations. Nothing to author; confirm the right variant is written.
|
|
97
|
+
|
|
98
|
+
### Step 5 (optional): Split the skills across NAMED agents
|
|
99
|
+
|
|
100
|
+
Skip this when one agent card is enough — it is, for most apps.
|
|
101
|
+
|
|
102
|
+
By default your app serves ONE agent at `/a2a`, advertising every exposable actor
|
|
103
|
+
system as a skill. Declare **named agents** when you need distinct agent
|
|
104
|
+
IDENTITIES: a partner-facing agent and an internal one, each with its own name,
|
|
105
|
+
description, URL and **skill subset**.
|
|
106
|
+
|
|
107
|
+
Declare them on `ApplicationInitializationConfig.resourceServerInstances` in your
|
|
108
|
+
backend's initialization config — the same place named MCP servers are declared:
|
|
109
|
+
|
|
110
|
+
<!-- TIER C WAIVER: Tier A rejected — the reference application declares named MCP SERVERS, not named
|
|
111
|
+
A2A AGENTS, so there is no natural span to anchor; inventing one would mount a live agent purely
|
|
112
|
+
to host an example. Tier B rejected — the declaration is an APP-side config literal, not a
|
|
113
|
+
framework-owned contract, so an illustrative block beside the contract would misrepresent where it
|
|
114
|
+
lives. The contract itself IS anchored and cited via
|
|
115
|
+
references/framework-named-a2a-agents-contract.md; only this short call-site literal is inline. -->
|
|
116
|
+
|
|
117
|
+
```ts
|
|
118
|
+
import { ResourceServerKind, type ResourceServerInstance } from '@wildo-ai/saas-models';
|
|
119
|
+
|
|
120
|
+
export const AGENTS: ResourceServerInstance[] = [
|
|
121
|
+
{
|
|
122
|
+
ref: 'concierge', // → /a2a/concierge + its own audience
|
|
123
|
+
kind: ResourceServerKind.A2A,
|
|
124
|
+
displayName: 'Acme Concierge',
|
|
125
|
+
description: 'Customer-facing assistant for order questions.',
|
|
126
|
+
actorSystemRefs: ['supportAssistant'], // this agent's skills — omit to expose them all
|
|
127
|
+
},
|
|
128
|
+
];
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
What the engine then serves, and the rules that matter:
|
|
132
|
+
|
|
133
|
+
- **`GET /a2a/<ref>/.well-known/agent-card.json`** — the agent's OWN card: its
|
|
134
|
+
`displayName`/`description` as identity, `url` = its own RFC 8707 audience
|
|
135
|
+
(`…/a2a/<ref>`), and `skills` = only its `actorSystemRefs`.
|
|
136
|
+
- **`POST /a2a/<ref>`** — its task endpoint. A token must be audience-bound to THIS
|
|
137
|
+
agent; one minted for another agent (or for the default `/a2a`) is rejected.
|
|
138
|
+
- **Skills stay the routing mechanism WITHIN a card.** A named agent GROUPS skills,
|
|
139
|
+
it does not replace `metadata.skillId`. A `skillId` outside the agent's subset is
|
|
140
|
+
rejected exactly like an unknown skill — a named agent is never a side-door into
|
|
141
|
+
another agent's actor system.
|
|
142
|
+
- **`actorSystemRefs` is omitted-or-non-empty.** Omitted ⇒ every exposable system
|
|
143
|
+
("no restriction"). Present ⇒ exactly those, and at least one; an EMPTY array
|
|
144
|
+
fails startup rather than being read as "all".
|
|
145
|
+
- **Every ref must resolve.** An `actorSystemRefs` entry that is not a registered
|
|
146
|
+
actor system is a STARTUP error, so a typo cannot advertise an unroutable skill.
|
|
147
|
+
- **The default `/a2a` is untouched** and always present — declaring agents is
|
|
148
|
+
purely additive.
|
|
149
|
+
- **`ref` is the URL + audience segment.** Keep it short, stable and URL-safe;
|
|
150
|
+
renaming it changes the audience and invalidates already-minted tokens.
|
|
151
|
+
|
|
152
|
+
Named agents are a token-replay + curation boundary, NOT an authorization axis:
|
|
153
|
+
every turn still runs under the caller's own roles and scope.
|
|
154
|
+
|
|
155
|
+
## Worked Example
|
|
156
|
+
|
|
157
|
+
The exposed skill IS an ordinary agentic actor system — the same shape the in-app
|
|
158
|
+
assistant uses. This is the system that becomes an `A2A_Skill` (its `ref` → the
|
|
159
|
+
skill `id`); everything below the agent definition is served automatically:
|
|
160
|
+
|
|
161
|
+
|
|
162
|
+
## Usage Example
|
|
163
|
+
|
|
164
|
+
```typescript
|
|
165
|
+
const TODO_ASSISTANT_CHAT_AGENT_REF = 'todo-assistant.chat.agent' as const;
|
|
166
|
+
const TODO_ASSISTANT_SYSTEM_REF = 'todo-assistant' as const;
|
|
167
|
+
|
|
168
|
+
/** Function refs the assistant may call (must match the registered `functionTools`). */
|
|
169
|
+
const TODOS_READ_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.read`;
|
|
170
|
+
const TODO_LISTS_READ_TOOL_REF = `resource.${TasksManager_ResourceType.TODO_LISTS}.read`;
|
|
171
|
+
// The WRITE ref — built the same way the `resourceWriteTool` factory derives its
|
|
172
|
+
// default functionRef (`resource.<type>.<op>`), so the agent's declared ref and the
|
|
173
|
+
// tool's ref cannot drift. Resolves to `resource.todos.create`.
|
|
174
|
+
const TODOS_CREATE_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.${CoreResourceOperation.CREATE}`;
|
|
175
|
+
/**
|
|
176
|
+
* The APPROVAL-GATED write ref. UPDATE is gated where CREATE is not, and the asymmetry is the
|
|
177
|
+
* point: creating a todo is additive and trivially undone, whereas editing one MUTATES something
|
|
178
|
+
* the user already relies on — overwriting a title or status is the change they would want to be
|
|
179
|
+
* asked about. Gating every write instead would train the user to approve reflexively, which is
|
|
180
|
+
* how an approval prompt stops being read at all.
|
|
181
|
+
*/
|
|
182
|
+
const TODOS_UPDATE_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.${CoreResourceOperation.UPDATE}`;
|
|
183
|
+
|
|
184
|
+
/** The conversational chat agent behind the assistant actor. */
|
|
185
|
+
const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
186
|
+
ref: TODO_ASSISTANT_CHAT_AGENT_REF,
|
|
187
|
+
displayName: 'Todo Assistant',
|
|
188
|
+
status: FlowsActors_Agent_Status.ACTIVE,
|
|
189
|
+
config: {
|
|
190
|
+
providerRef: 'anthropic',
|
|
191
|
+
model: LLM_Model.CLAUDE_SONNET_5,
|
|
192
|
+
operationKey: LLMProvider_OperationKey.CHAT_COMPLETION,
|
|
193
|
+
// No sampling params: the whole Claude 5 family (sonnet-5 AND fable-5)
|
|
194
|
+
// REJECTS explicit `temperature` ("deprecated for this model", verified
|
|
195
|
+
// live 2026-07-16) — model defaults rule.
|
|
196
|
+
accessControl: [{
|
|
197
|
+
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
198
|
+
requiresApproval: false,
|
|
199
|
+
}],
|
|
200
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
201
|
+
},
|
|
202
|
+
operationDefinition: {
|
|
203
|
+
operationKey: LLMProvider_OperationKey.CHAT_COMPLETION,
|
|
204
|
+
providerRef: 'anthropic',
|
|
205
|
+
inputSchema: LLMProvider_ChatCompletionInputSchema,
|
|
206
|
+
outputSchema: LLMProvider_ChatCompletionOutputSchema,
|
|
207
|
+
operationContextSchema: LLMProvider_OperationContext_BaseSchema,
|
|
208
|
+
} satisfies LLMProvider_OperationDefinitionBase,
|
|
209
|
+
promptSpec: {
|
|
210
|
+
role: 'You are the Todo Assistant for a personal task-management app. You answer the '
|
|
211
|
+
+ 'user\'s questions about their own todos and todo lists — what is due, what is '
|
|
212
|
+
+ 'outstanding, how work is grouped, and simple summaries or counts — and you CREATE '
|
|
213
|
+
+ 'a new todo for the user when they explicitly ask you to.',
|
|
214
|
+
persona: 'You are concise, practical, and grounded. You NEVER invent todos: when a question '
|
|
215
|
+
+ 'needs the user\'s data, call the read tools to look it up, then answer from what you '
|
|
216
|
+
+ 'find. If the tools return nothing relevant, say so plainly rather than guessing. You '
|
|
217
|
+
+ 'only ever discuss the current user\'s own items. You create a todo ONLY when the user '
|
|
218
|
+
+ 'explicitly asks — never speculatively and never in bulk — and you confirm the created '
|
|
219
|
+
+ 'todo\'s title back to them.',
|
|
220
|
+
skillType: FlowsActors_Agent_Skill_Type.CHAT,
|
|
221
|
+
instructions: [
|
|
222
|
+
'Answer ONLY the user\'s current question, concisely. Do NOT restate or re-list information you already gave earlier in the conversation.',
|
|
223
|
+
'Call tools SILENTLY: never narrate your process (no "Let me check…", no announcing that you are using a tool). Return only the final answer.',
|
|
224
|
+
'When the user asks about ONE specific item, answer about that item only — do not re-list every todo.',
|
|
225
|
+
'Use resource.todos.read to look up the user\'s todos (pass a searchQuery when a topic is named); use resource.todoLists.read for lists/grouping. Reference concrete item titles.',
|
|
226
|
+
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first, then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
227
|
+
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted. If it returns no sources, say the knowledge base has nothing on it rather than answering from general knowledge.',
|
|
228
|
+
'To CREATE a todo (only when explicitly asked), you MUST supply a todoListId: if the user names a list, resolve its id with resource.todoLists.read first; if they name none and have exactly one list, use it; if they have several and none is specified, ask which one. Then call resource.todos.create with the title (plus any description/priority/status/dueDate the user gave) and confirm the created title.',
|
|
229
|
+
],
|
|
230
|
+
},
|
|
231
|
+
capabilities: {
|
|
232
|
+
tools: {
|
|
233
|
+
functionRefs: [
|
|
234
|
+
TODOS_READ_TOOL_REF,
|
|
235
|
+
TODO_LISTS_READ_TOOL_REF,
|
|
236
|
+
TODOS_CREATE_TOOL_REF,
|
|
237
|
+
TODOS_UPDATE_TOOL_REF,
|
|
238
|
+
// RETRIEVAL grounding — a different KIND of source from the three above. Those return ROWS
|
|
239
|
+
// matched by a column; this returns PASSAGES matched by wording (and, with an embeddings
|
|
240
|
+
// provider, by meaning) out of the organization's reference documents, including the text of
|
|
241
|
+
// uploaded files that no row query can reach.
|
|
242
|
+
KNOWLEDGE_BASE_ASK_TOOL_REF,
|
|
243
|
+
],
|
|
244
|
+
mcpRefs: [],
|
|
245
|
+
},
|
|
246
|
+
},
|
|
247
|
+
createdAt: '2026-07-12T00:00:00.000Z',
|
|
248
|
+
};
|
|
249
|
+
|
|
250
|
+
/** The "Todo Assistant" actor system exposed to the frontend flows-actors view. */
|
|
251
|
+
const todoAssistantActorSystem: ActorSystem = {
|
|
252
|
+
ref: TODO_ASSISTANT_SYSTEM_REF,
|
|
253
|
+
displayName: 'Todo Assistant',
|
|
254
|
+
description: 'Ask questions about your todos and lists — grounded in your own data.',
|
|
255
|
+
kind: FlowActorSystem_Kind.ACTOR,
|
|
256
|
+
status: FlowActorSystem_Status.ACTIVE,
|
|
257
|
+
// FRONTEND so the flows-actors view can list + start conversations with it.
|
|
258
|
+
visibility: FlowActorSystem_Visibility.FRONTEND,
|
|
259
|
+
config: {
|
|
260
|
+
timeout: 60000,
|
|
261
|
+
accessControl: [{
|
|
262
|
+
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
263
|
+
requiresApproval: false,
|
|
264
|
+
}],
|
|
265
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
266
|
+
},
|
|
267
|
+
actors: [{
|
|
268
|
+
ref: 'assistant',
|
|
269
|
+
displayName: 'Assistant',
|
|
270
|
+
roleCategory: Actor_Role_Category.OPERATOR,
|
|
271
|
+
executionMode: Actor_ExecutionMode.AGENTIC,
|
|
272
|
+
agentRef: TODO_ASSISTANT_CHAT_AGENT_REF,
|
|
273
|
+
}],
|
|
274
|
+
createdAt: '2026-07-12T00:00:00.000Z',
|
|
275
|
+
};
|
|
276
|
+
|
|
277
|
+
// Export with consistent naming convention matching resources registry pattern
|
|
278
|
+
export const moduleBackend_FlowsActorsRegistry: {
|
|
279
|
+
flowActorSystemsFactoryMap: FlowActorSystem_InitializationFactoryMap;
|
|
280
|
+
agents: FlowsActors_Agent[];
|
|
281
|
+
functionTools?: FunctionTool[];
|
|
282
|
+
} = {
|
|
283
|
+
flowActorSystemsFactoryMap: {
|
|
284
|
+
[TODO_ASSISTANT_SYSTEM_REF]: () => todoAssistantActorSystem,
|
|
285
|
+
},
|
|
286
|
+
agents: [todoAssistantChatAgent],
|
|
287
|
+
// Generic engine factories instantiated per resource — every tool runs AS THE
|
|
288
|
+
// CALLER (the engine rebuilds a scoped ExecutionContext from the caller's verified
|
|
289
|
+
// auth; identity is never LLM-supplied) and each op's own ACL is enforced by the
|
|
290
|
+
// service tier, so there is no privilege escalation through a tool.
|
|
291
|
+
functionTools: [
|
|
292
|
+
// READS — functionRef `resource.<type>.read`, matching the declared functionRefs above.
|
|
293
|
+
resourceReadTool(TasksManager_ResourceType.TODOS),
|
|
294
|
+
resourceReadTool(TasksManager_ResourceType.TODO_LISTS),
|
|
295
|
+
// WRITE — CREATE a todo as the caller (functionRef `resource.todos.create`). The todos
|
|
296
|
+
// CREATE ACL is ORG_MEMBER-gated, so a caller without the role is refused. The model-facing
|
|
297
|
+
// inputSchema is app-owned (design axis A): it exposes only the fields the model may set —
|
|
298
|
+
// owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
|
|
299
|
+
// DTO coerces the ISO `dueDate` string to a Date at the service boundary.
|
|
300
|
+
//
|
|
301
|
+
// `recurringType` IS supplied (pinned to ONE_TIME): todos is a discriminated-union inheritance
|
|
302
|
+
// resource (one-time / recurring), so its CREATE DTO REQUIRES the `recurringType` discriminator
|
|
303
|
+
// to select a variant — omitting it fails with "no matching discriminator". The assistant only
|
|
304
|
+
// creates NON-recurring todos, so we default it to ONE_TIME (the model need not supply it) and
|
|
305
|
+
// use a literal so the model cannot select the recurring variant, whose extra fields
|
|
306
|
+
// (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
|
|
307
|
+
// defaulted (not merely optional) so they are always present for the discriminated base branch.
|
|
308
|
+
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
|
|
309
|
+
inputSchema: z.object({
|
|
310
|
+
title: z.string().min(1).max(200)
|
|
311
|
+
.describe('Short title of the todo. Required.'),
|
|
312
|
+
todoListId: z.string().min(1)
|
|
313
|
+
.describe('Id of the todo list the todo belongs to. Required — resolve it with the todoLists read tool when the user names a list.'),
|
|
314
|
+
description: z.string().max(1000).optional()
|
|
315
|
+
.describe('Optional longer description / notes.'),
|
|
316
|
+
status: z.enum(Todos_Status).default(Todos_Status.PENDING)
|
|
317
|
+
.describe('Initial status. Defaults to "pending".'),
|
|
318
|
+
priority: z.enum(Todos_Priority).default(Todos_Priority.MEDIUM)
|
|
319
|
+
.describe('Priority. Defaults to "medium".'),
|
|
320
|
+
recurringType: z.literal(Todos_RecurrenceType.ONE_TIME).default(Todos_RecurrenceType.ONE_TIME)
|
|
321
|
+
.describe('Always "one_time"; the assistant creates non-recurring todos.'),
|
|
322
|
+
dueDate: z.string().optional()
|
|
323
|
+
.describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
|
|
324
|
+
}),
|
|
325
|
+
}),
|
|
326
|
+
// WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
|
|
327
|
+
// `requiresHumanApproval` suspends the turn at this tool and emits an approval request carrying
|
|
328
|
+
// the arguments; the turn resumes only on a decision, and a DENIAL resumes it too so the agent
|
|
329
|
+
// can explain rather than leaving a dead thread. The approval is an ADDITIONAL gate: the todos
|
|
330
|
+
// UPDATE ACL still applies, so approving something the caller may not do changes nothing.
|
|
331
|
+
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.UPDATE, {
|
|
332
|
+
requiresHumanApproval: true,
|
|
333
|
+
inputSchema: z.object({
|
|
334
|
+
id: z.string().min(1)
|
|
335
|
+
.describe('Id of the todo to update. Required — resolve it with the todos read tool.'),
|
|
336
|
+
title: z.string().min(1).max(200).optional()
|
|
337
|
+
.describe('New title, if the user asked to rename it.'),
|
|
338
|
+
description: z.string().max(1000).optional()
|
|
339
|
+
.describe('New description / notes.'),
|
|
340
|
+
status: z.enum(Todos_Status).optional()
|
|
341
|
+
.describe('New status.'),
|
|
342
|
+
priority: z.enum(Todos_Priority).optional()
|
|
343
|
+
.describe('New priority.'),
|
|
344
|
+
}),
|
|
345
|
+
}),
|
|
346
|
+
// RETRIEVAL — a hand-written tool rather than a factory instance, because its result is not a
|
|
347
|
+
// record set. It calls the app's own `knowledgeDocuments.ask` operation through the full
|
|
348
|
+
// pipeline (request parse → role gate → custom impl → response projection) on a context rebuilt
|
|
349
|
+
// from the caller's verified socket auth, so the agent reaches the corpus through exactly the
|
|
350
|
+
// feature an HTTP client reaches, with exactly the same roles. See `./knowledge-base-tool.ts`.
|
|
351
|
+
knowledgeBaseAskTool,
|
|
352
|
+
],
|
|
353
|
+
};
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+
An external agent then discovers and calls it over plain HTTP (no app code):
|
|
357
|
+
|
|
358
|
+
```bash
|
|
359
|
+
# 1. Discover
|
|
360
|
+
curl https://your-app.example.com/api/v1/a2a/.well-known/agent-card.json
|
|
361
|
+
|
|
362
|
+
# 2. Machine token from YOUR OIDC provider (client-credentials)
|
|
363
|
+
curl -X POST https://your-app.example.com/api/v1/oauth/token \
|
|
364
|
+
-d grant_type=client_credentials -d client_id=oc_org_… -d client_secret=…
|
|
365
|
+
|
|
366
|
+
# 3. Converse (JSON-RPC message/send); skillId omitted → the single exposed skill
|
|
367
|
+
curl -X POST https://your-app.example.com/api/v1/a2a \
|
|
368
|
+
-H 'Authorization: Bearer <token>' -H 'Content-Type: application/json' \
|
|
369
|
+
-d '{"jsonrpc":"2.0","id":1,"method":"message/send",
|
|
370
|
+
"params":{"message":{"role":"user","parts":[{"kind":"text","text":"hi"}]}}}'
|
|
371
|
+
```
|
|
372
|
+
|
|
373
|
+
## Tasks: when a turn becomes addressable
|
|
374
|
+
|
|
375
|
+
Most A2A turns answer inline and leave nothing behind. A **task** — an addressable,
|
|
376
|
+
pollable, cancelable record — is created only when the turn cannot finish in the
|
|
377
|
+
response:
|
|
378
|
+
|
|
379
|
+
| The client sends | What it gets back | Is a task row written? |
|
|
380
|
+
|---|---|---|
|
|
381
|
+
| nothing special (blocking) | an A2A `Message` with the agent's reply | **No** |
|
|
382
|
+
| `configuration.blocking: false` | an A2A `Task` it can poll | Yes |
|
|
383
|
+
| anything, but the turn pauses for approval | a `Task` in `input-required` | **Not yet — Phase 2** |
|
|
384
|
+
|
|
385
|
+
⚠️ The approval-pause row is **not implemented yet** — the runtime cannot pause a turn until
|
|
386
|
+
the human-in-the-loop phase ships. Today a task is created only when the client asks for it.
|
|
387
|
+
|
|
388
|
+
Both shapes are protocol-conformant; the spec lets an agent return either. Defaulting to
|
|
389
|
+
the inline `Message` is what stops a chatty agent from accumulating one row per turn.
|
|
390
|
+
|
|
391
|
+
Once a task exists the client can `tasks/get` it and `tasks/cancel` it. Two behaviours
|
|
392
|
+
worth knowing because they surprise people:
|
|
393
|
+
|
|
394
|
+
- **Cancel is a status transition, not a delete.** The spec requires `tasks/cancel` to
|
|
395
|
+
return the task's *updated state*, so a cancelled task stays readable.
|
|
396
|
+
- **Cancelling an already-finished task FAILS.** Once the task is terminal this server answers
|
|
397
|
+
`TaskNotCancelable` (`-32002`) rather than the task. The protocol permits that answer rather than
|
|
398
|
+
requiring it, so treat it as this server's behaviour, not as an A2A guarantee you can assume of
|
|
399
|
+
every agent. <!-- spec-cite: A2A v0.2.5 §7.4 lists TaskNotCancelableError among the errors a
|
|
400
|
+
cancel may answer; it does not mandate the refusal. -->
|
|
401
|
+
That is deliberate: answering success would make "I stopped it" and "it had already finished"
|
|
402
|
+
indistinguishable, which is exactly the distinction a client reconciling state needs. Read the
|
|
403
|
+
task with `tasks/get` to see which happened.
|
|
404
|
+
- **Cancel means "stop as soon as the runtime can", not "stop instantly".** It always
|
|
405
|
+
records the cancellation and aborts the model call for the normal streaming transports.
|
|
406
|
+
An agent that buffers its whole reply (a CLI-transport agent, or a non-text operation)
|
|
407
|
+
and a tool call already in flight both run to completion first. Do not promise your users
|
|
408
|
+
an instant stop for those agents.
|
|
409
|
+
- **A task whose worker died reports `failed`, not `working`.** The engine holds a
|
|
410
|
+
liveness lease while a turn runs; if the process serving it disappears, the task stops
|
|
411
|
+
claiming to be in progress. You do not have to reconcile that yourself.
|
|
412
|
+
|
|
413
|
+
Your app does not implement any of this — it is served by the engine for every actor
|
|
414
|
+
system you expose. What you control is which systems are exposed at all (above) and
|
|
415
|
+
whether a tool requires approval (see the HITL guidance).
|
|
416
|
+
|
|
417
|
+
## References
|
|
418
|
+
|
|
419
|
+
- `references/framework-flows-actors-a2a-contract.md` — source-backed: the served
|
|
420
|
+
`A2A_AgentCard` / `A2A_Skill` discovery contract external agents consume.
|
|
421
|
+
- `references/framework-named-a2a-agents-contract.md` — source-backed: the
|
|
422
|
+
`ResourceServerInstance` declaration for NAMED agents (Step 5) — refs, audiences,
|
|
423
|
+
and the `actorSystemRefs` skill subset.
|
|
424
|
+
- `flows-actors-chat-assistant/SKILL.md` references — the agent + tool + view
|
|
425
|
+
contracts for the actor system you expose.
|
|
426
|
+
|
|
427
|
+
## Verification
|
|
428
|
+
|
|
429
|
+
- [ ] The system is `kind: ACTOR` with an `AGENTIC` actor + `agentRef` (else it is
|
|
430
|
+
not advertised). Grep: `rg "executionMode.*AGENTIC" backend-api/src/modules`
|
|
431
|
+
- [ ] The agent card resolves (app public URL set): `curl …/a2a/.well-known/agent-card.json`
|
|
432
|
+
returns your skills, not `503 temporarily_unavailable`.
|
|
433
|
+
- [ ] Machine access requires a provisioned OAuth client — a `clientCredentials`
|
|
434
|
+
flow appears in the card's `securitySchemes`. Grep the card JSON for
|
|
435
|
+
`clientCredentials`.
|
|
436
|
+
- [ ] A machine turn persists to `organizationFlowActorExecutions` /
|
|
437
|
+
`applicationFlowActorExecutions` (NOT `userFlowActorExecutions`).
|
|
438
|
+
- [ ] **Named agents only** — every `actorSystemRefs` entry is a REGISTERED actor system
|
|
439
|
+
(else the app fails to START). Reconcile the two lists:
|
|
440
|
+
`comm -23 <(rg -o "actorSystemRefs: \[[^]]*" backend-api/src -r '$0' | rg -o "'[a-zA-Z0-9_-]+'" | tr -d "'" | sort -u) <(rg -o "ref: '[a-zA-Z0-9_-]+'" backend-api/src/modules/*/addons/flows-actors | rg -o "'[a-zA-Z0-9_-]+'" | tr -d "'" | sort -u)`
|
|
441
|
+
— any output is a ref that names no actor system.
|
|
442
|
+
- [ ] **Named agents only** — no declaration carries an EMPTY subset (startup error, not "all"):
|
|
443
|
+
`rg "actorSystemRefs: \[\s*\]" backend-api/src` returns nothing.
|
|
444
|
+
- [ ] **Named agents only** — each named card advertises ONLY its subset, and its `url` is its own
|
|
445
|
+
audience: `curl …/a2a/<ref>/.well-known/agent-card.json` shows `"url": ".../a2a/<ref>"` and
|
|
446
|
+
strictly fewer skills than the default card.
|
|
447
|
+
- [ ] **Named agents only** — an undeclared ref is fail-closed, never the default card:
|
|
448
|
+
`curl -o /dev/null -w '%{http_code}' …/a2a/ghost/.well-known/agent-card.json` returns `404`.
|
|
449
|
+
|
|
450
|
+
## Common Rationalizations
|
|
451
|
+
|
|
452
|
+
| Rationalization | Reality |
|
|
453
|
+
|---|---|
|
|
454
|
+
| "I must add an `a2a: true` flag to my actor system." | No — exposure is automatic for every agentic actor system. There is no per-system opt-in. |
|
|
455
|
+
| "A2A and MCP are the same, either exposes my agent." | No. A2A exposes CONVERSATIONAL actor systems (agent-to-agent chat). MCP exposes RESOURCE OPERATIONS as callable tools (`operation.mcp.exposed`). Different surfaces. |
|
|
456
|
+
| "The external agent can pass a userId to act as any user." | No. Identity is the verified token ONLY; the turn runs under the caller's own roles/scope, never LLM- or caller-supplied identity. |
|
|
457
|
+
| "A machine caller can read a user's private conversations in its org." | No. Conversations are polymorphic per owner scope — a machine only ever sees its org/app-owned variant, never a user's. |
|
|
458
|
+
| "Any valid token for the app can call any agent." | User tokens are audience-bound to THIS agent's card `url` (D7); a token minted for another agent is rejected. |
|
|
459
|
+
| "I need named agents to give different callers different skills." | Usually not. ONE card already advertises many skills and a caller selects one via `metadata.skillId`. Reach for named agents only when you need distinct agent IDENTITIES (own name, description, URL, audience) — not merely to route between skills. |
|
|
460
|
+
| "A named agent stops a caller from performing an operation." | No. Named agents CURATE and confine tokens; they are not an authorization axis. Every turn runs under the caller's own roles and scope, exactly as on the default agent. Constrain ROLES when a caller must be unable to do something. |
|
|
461
|
+
| "`actorSystemRefs: []` means the agent exposes everything." | It means the app does not START. Omitted ⇒ every exposable system; present ⇒ exactly those, at least one. The empty case is rejected precisely so a typo cannot silently WIDEN an agent. |
|
|
462
|
+
|
|
463
|
+
## Red Flags
|
|
464
|
+
|
|
465
|
+
- **Adding an A2A opt-in flag to the actor-system config** — there is none; catch
|
|
466
|
+
with the "agentic actor system" verification (exposure is automatic).
|
|
467
|
+
- **Passing a `userId` / owner in the A2A message payload** — identity is the token;
|
|
468
|
+
the runtime ignores caller-supplied identity.
|
|
469
|
+
- **Reusing a normal app access token for A2A** — this server requires an audience-bound
|
|
470
|
+
OIDC token (user) or a client-credentials machine token; a plain `AUTH_TOKEN` is rejected.
|
|
471
|
+
<!-- spec-cite: N/A — a WILDO requirement (design decision D7), not an A2A mandate. §4 of the
|
|
472
|
+
specification requires only HTTPS and declares schemes via the agent card's `securitySchemes`,
|
|
473
|
+
stating that credential acquisition is outside the protocol's scope. Saying "A2A requires" here
|
|
474
|
+
taught app builders a protocol rule that does not exist. -->
|
|
475
|
+
- **Expecting one shared conversation store** — user/org/app conversations are
|
|
476
|
+
separate scope-isolated variants; a machine's turns never land in the user store.
|
|
477
|
+
- **Typing an actor-system ref into `actorSystemRefs` without checking it is registered** — the app
|
|
478
|
+
fails to START rather than serving an unroutable skill; catch with the `comm` reconcile above.
|
|
479
|
+
- **Writing `actorSystemRefs: []` to mean "everything"** — that is a startup error; omit the field
|
|
480
|
+
instead. Catch with the empty-subset grep above.
|
|
481
|
+
- **Renaming an agent's `ref` to tidy it up** — the ref IS the audience segment, so every already-minted
|
|
482
|
+
token for that agent stops working; treat a rename as a credential rotation.
|
|
483
|
+
- **Reusing a token across named agents** — each agent is a separate resource server; catch with the
|
|
484
|
+
per-agent `url` check above (the card tells a client exactly which audience to request).
|
|
485
|
+
|
|
486
|
+
## Related Skills
|
|
487
|
+
|
|
488
|
+
- `flows-actors-chat-assistant` — builds the agentic actor system this skill exposes
|
|
489
|
+
(agent + `resourceReadTool` grounding + in-app WebSocket view).
|
|
490
|
+
- `resource-mcp-tool-exposure` — the sibling for exposing resource OPERATIONS (not
|
|
491
|
+
conversations) as MCP tools to external agents.
|