@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,130 @@
|
|
|
1
|
+
# Invocation envelope + the `invokeAgent` seam — source contracts
|
|
2
|
+
|
|
3
|
+
Read this at Step 6 (invoke) and Step 7 (unwrap). It surfaces:
|
|
4
|
+
|
|
5
|
+
- `FlowsActors_Agent_Invocation` — one call to one agent. The same shape goes in
|
|
6
|
+
and comes back: you fill `agentRef` + `input`, the engine returns it with
|
|
7
|
+
`output` normalized and `executionContext` enriched (`executionTime`,
|
|
8
|
+
`finishedAt`, and provider token `usage` when the transport reports it).
|
|
9
|
+
`initiator: {}`, `invocationContext: []`, and `artifactBindings: []` are the
|
|
10
|
+
correct values when you have nothing to correlate.
|
|
11
|
+
- `AgentsBackendService.invokeAgent` — the seam itself, injected by DI symbol from
|
|
12
|
+
`@wildo-ai/saas-backend-lib`. Its documentation records what the engine owns
|
|
13
|
+
around the call and the one rule that surprises people: **declared function
|
|
14
|
+
tools do not execute on this path.**
|
|
15
|
+
|
|
16
|
+
## Two traps worth stating twice
|
|
17
|
+
|
|
18
|
+
**`input.schema` is required for structured calls.** `GENERATE_STRUCTURED` throws
|
|
19
|
+
a validation error when `input.schema` is missing — it does not fall back to text.
|
|
20
|
+
The schema is per-invocation on purpose, so one agent can serve several output
|
|
21
|
+
shapes.
|
|
22
|
+
|
|
23
|
+
**The output is wrapped.** `normalizeOperationOutput` puts the answer under a key
|
|
24
|
+
determined by the operation: `{ text }` for `GENERATE_TEXT`, `{ object }` for
|
|
25
|
+
`GENERATE_STRUCTURED`, `{ message }` for `CHAT_COMPLETION` / `CHAT_MULTIMODAL`.
|
|
26
|
+
Reading `result.output` as if it were the bare value yields an object, not your
|
|
27
|
+
answer — and it fails as bad data downstream rather than as an error here. Unwrap,
|
|
28
|
+
then re-parse with your own schema.
|
|
29
|
+
|
|
30
|
+
Errors are typed backend errors — catch with `isWildoBackendError(error)`. The
|
|
31
|
+
ones you will actually meet: unknown or non-`ACTIVE` `agentRef`, a provider with
|
|
32
|
+
no configured API key (fail-closed configuration error), a missing structured
|
|
33
|
+
schema, and provider failures surfaced with their details.
|
|
34
|
+
|
|
35
|
+
## Import Origins
|
|
36
|
+
|
|
37
|
+
- `@wildo-ai/saas-models`
|
|
38
|
+
|
|
39
|
+
## Source Excerpts
|
|
40
|
+
|
|
41
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
42
|
+
|
|
43
|
+
```typescript
|
|
44
|
+
*
|
|
45
|
+
* One call to one agent — the envelope you build and hand to
|
|
46
|
+
* `AgentsBackendService.invokeAgent`, and the SAME shape you get back with
|
|
47
|
+
* `output` and `executionContext` filled in.
|
|
48
|
+
*
|
|
49
|
+
* What you supply:
|
|
50
|
+
* - `agentRef` — the `ref` of a registered agent (unknown ref throws).
|
|
51
|
+
* - `input` — the per-call task. `{ prompt }` for text; add `{ schema }` (a Zod
|
|
52
|
+
* schema) for `GENERATE_STRUCTURED`, which REQUIRES it. Anything else you put
|
|
53
|
+
* here is JSON-serialized into the user prompt.
|
|
54
|
+
* - `output` — an empty value of the expected shape (`{ text: '' }`,
|
|
55
|
+
* `{ object: {} }`). It is a typing seed; the returned envelope replaces it.
|
|
56
|
+
* - `initiator` / `invocationContext` / `artifactBindings` — `{}` / `[]` / `[]`
|
|
57
|
+
* when you have nothing to correlate.
|
|
58
|
+
*
|
|
59
|
+
* What comes back: `output` normalized to the operation's shape, and
|
|
60
|
+
* `executionContext` enriched with `executionTime`, `finishedAt`, and provider
|
|
61
|
+
* `usage` (tokens) when the transport reports it.
|
|
62
|
+
*
|
|
63
|
+
* Import path: `@wildo-ai/saas-models`.
|
|
64
|
+
*/
|
|
65
|
+
export type FlowsActors_Agent_Invocation<
|
|
66
|
+
InputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,
|
|
67
|
+
OutputSchema extends z.ZodSchema<any> = z.ZodSchema<any>,
|
|
68
|
+
ContextSchema extends z.ZodSchema<any> = z.ZodSchema<any>,
|
|
69
|
+
> = {
|
|
70
|
+
_id?: string,
|
|
71
|
+
agentRef: string,
|
|
72
|
+
initiator: ExecutionContext_InitiatorIds,
|
|
73
|
+
invocationContext : FlowsActors_Relationship[],
|
|
74
|
+
|
|
75
|
+
input: z.infer<InputSchema>,
|
|
76
|
+
output: z.infer<OutputSchema>,
|
|
77
|
+
executionContext: z.infer<ContextSchema>,
|
|
78
|
+
artifactBindings: {
|
|
79
|
+
kind: FlowsActors_IO_PartKind,
|
|
80
|
+
ref: string,
|
|
81
|
+
}[],
|
|
82
|
+
|
|
83
|
+
};
|
|
84
|
+
```
|
|
85
|
+
## Import Origins
|
|
86
|
+
|
|
87
|
+
- `@wildo-ai/saas-backend-lib`
|
|
88
|
+
|
|
89
|
+
## Source Excerpts
|
|
90
|
+
|
|
91
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
92
|
+
|
|
93
|
+
```typescript
|
|
94
|
+
*
|
|
95
|
+
* Run ONE agent, once, and await its complete answer. This is the seam an
|
|
96
|
+
* application calls to use its `AI_LLM` capability from its own backend code
|
|
97
|
+
* (a service, a custom resource operation, a batch job).
|
|
98
|
+
*
|
|
99
|
+
* Inject it by DI symbol:
|
|
100
|
+
* `@inject(SAAS_SERVICE_TYPES.AgentsBackendService) private readonly agentsService: AgentsBackendService`
|
|
101
|
+
* — import both from `@wildo-ai/saas-backend-lib`.
|
|
102
|
+
*
|
|
103
|
+
* The engine owns everything around the call: it resolves the agent by
|
|
104
|
+
* `request.agentRef` (unknown ref → throws), refuses a non-`ACTIVE` agent,
|
|
105
|
+
* compiles `promptSpec` into a provider-shaped system prompt, resolves the
|
|
106
|
+
* provider client + API key (fail-closed if unconfigured), schedules the call
|
|
107
|
+
* through that provider's rate limiter, normalizes the output to the
|
|
108
|
+
* operation's wrapped shape, and emits the usage/latency trace. You supply an
|
|
109
|
+
* invocation and read `result.output`.
|
|
110
|
+
*
|
|
111
|
+
* **Function tools do NOT run on this path.** An agent's declared
|
|
112
|
+
* `capabilities.tools.functionRefs` are resolved and executed only by the
|
|
113
|
+
* STREAMING/conversational path ({@link invokeAgentStreaming}). A one-shot
|
|
114
|
+
* agent must therefore receive everything it needs in `request.input` — fetch
|
|
115
|
+
* the data yourself first. Declaring tools here is silently inert, not an error.
|
|
116
|
+
*
|
|
117
|
+
* @param request the invocation envelope (`agentRef` + `input` + empty `output` seed).
|
|
118
|
+
* @param traceContext optional correlation for the agent-call trace sink.
|
|
119
|
+
* @param hostContext backend-owned physical execution context, required only
|
|
120
|
+
* once the selected declared transport is CLI.
|
|
121
|
+
* @returns the same envelope with `output` normalized and `executionContext` enriched.
|
|
122
|
+
* @throws a typed backend error — unknown/inactive agent, missing provider key,
|
|
123
|
+
* missing `input.schema` on a structured call, or a provider failure.
|
|
124
|
+
*/
|
|
125
|
+
public async invokeAgent(
|
|
126
|
+
request: FlowsActors_Agent_Invocation<any, any, any>,
|
|
127
|
+
traceContext?: AgentTraceContext,
|
|
128
|
+
hostContext?: AgentInvocationHostContext,
|
|
129
|
+
): Promise<FlowsActors_Agent_Invocation<any, any, any>> {
|
|
130
|
+
```
|
|
@@ -0,0 +1,214 @@
|
|
|
1
|
+
# Prompt specification — source contract
|
|
2
|
+
|
|
3
|
+
Read this at Step 3 when writing the agent's prompt. It surfaces:
|
|
4
|
+
|
|
5
|
+
- `FlowsActors_Agent_PromptSpec` — the prompt authored as STRUCTURE, not as one
|
|
6
|
+
prose blob. The prompt compiler renders these fields into the provider's
|
|
7
|
+
preferred format (XML boundaries for Claude, message roles for OpenAI, markdown
|
|
8
|
+
headings as fallback), so you never hand-format a system prompt or branch on the
|
|
9
|
+
provider.
|
|
10
|
+
- `FlowsActors_Agent_Skill_Type` — what KIND of work the agent does. This is a
|
|
11
|
+
real behavioral input, not a label: it selects the baseline instructions the
|
|
12
|
+
compiler emits before your own `instructions[]`.
|
|
13
|
+
|
|
14
|
+
`role` + `skillType` are the only required fields. Add the rest as the behavior
|
|
15
|
+
needs them — an over-specified prompt spec is as bad as an under-specified one.
|
|
16
|
+
|
|
17
|
+
**Precedence when the model must choose**: `constraints` (prohibitions, highest) >
|
|
18
|
+
`instructions` (hard rules) > `hints` (soft preferences). Use `outOfScope` for
|
|
19
|
+
explicit "don't do" statements that prevent scope creep, `examples` for few-shot
|
|
20
|
+
pairs when the output style is hard to describe, and `uncertainty` to say what the
|
|
21
|
+
agent should do when it does not know.
|
|
22
|
+
|
|
23
|
+
**The boundary that matters**: everything here is DURABLE — true of the agent on
|
|
24
|
+
every call, for every caller. The per-call task belongs in the invocation's
|
|
25
|
+
`input.prompt`. Putting call-specific text here forces one agent per input.
|
|
26
|
+
|
|
27
|
+
Imports from `@wildo-ai/saas-models`.
|
|
28
|
+
|
|
29
|
+
## Import Origins
|
|
30
|
+
|
|
31
|
+
- `@wildo-ai/saas-models`
|
|
32
|
+
|
|
33
|
+
## Source Excerpts
|
|
34
|
+
|
|
35
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
36
|
+
|
|
37
|
+
```typescript
|
|
38
|
+
*
|
|
39
|
+
* What KIND of work the agent does. The prompt compiler turns this into the
|
|
40
|
+
* agent's baseline behavioral instructions before your own `instructions[]` are
|
|
41
|
+
* appended — so it is a real behavioral input, not a label. Pick the one that
|
|
42
|
+
* matches the job: `GENERATION` (write something new), `ANALYSIS` (read and
|
|
43
|
+
* report), `TRANSFORMATION` (reshape given input), `DECISION` (choose/judge),
|
|
44
|
+
* `CHAT` (multi-turn conversation — see the chat-assistant skill), `CUSTOM`
|
|
45
|
+
* (none of the baselines fit).
|
|
46
|
+
*/
|
|
47
|
+
export enum FlowsActors_Agent_Skill_Type {
|
|
48
|
+
GENERATION = "generation",
|
|
49
|
+
ANALYSIS = "analysis",
|
|
50
|
+
TRANSFORMATION = "transformation",
|
|
51
|
+
DECISION = "decision",
|
|
52
|
+
CHAT = "chat",
|
|
53
|
+
CUSTOM = "custom",
|
|
54
|
+
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
58
|
+
|
|
59
|
+
```typescript
|
|
60
|
+
*
|
|
61
|
+
* The agent's prompt, authored as STRUCTURE rather than one prose blob. The
|
|
62
|
+
* prompt compiler renders these fields into the provider's preferred format
|
|
63
|
+
* (XML boundaries for Claude, message roles for OpenAI, …), so you never
|
|
64
|
+
* hand-format a system prompt or branch on the provider yourself.
|
|
65
|
+
*
|
|
66
|
+
* `role` + `skillType` are the only required fields — start there and add the
|
|
67
|
+
* rest as the behavior needs them. Precedence when the model must choose:
|
|
68
|
+
* `constraints` (prohibitions — highest) > `instructions` (hard rules) >
|
|
69
|
+
* `hints` (soft preferences). Keep the per-call task in the invocation's
|
|
70
|
+
* `input.prompt`; keep everything durable about the agent here.
|
|
71
|
+
*/
|
|
72
|
+
export const FlowsActors_Agent_PromptSpecSchema = z.object({
|
|
73
|
+
//====================
|
|
74
|
+
// IDENTITY (migrated from legacy skill)
|
|
75
|
+
//====================
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Agent's role description
|
|
79
|
+
* Explains what this agent does and its primary function
|
|
80
|
+
*/
|
|
81
|
+
role: z.string(),
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* Agent's persona/character
|
|
85
|
+
* Defines the agent's personality, expertise, and communication approach
|
|
86
|
+
*/
|
|
87
|
+
persona: z.string().optional(),
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* Agent skill type - determines baseline behavioral instructions
|
|
91
|
+
*/
|
|
92
|
+
skillType: z.enum(FlowsActors_Agent_Skill_Type),
|
|
93
|
+
|
|
94
|
+
//====================
|
|
95
|
+
// CONSTRAINTS (highest precedence)
|
|
96
|
+
//====================
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Constraints - HIGHEST precedence, never violate
|
|
100
|
+
* Different from instructions: constraints are prohibitions, instructions are rules
|
|
101
|
+
*/
|
|
102
|
+
constraints: z.array(FlowsActors_Agent_ConstraintSchema).optional(),
|
|
103
|
+
|
|
104
|
+
//====================
|
|
105
|
+
// GOAL
|
|
106
|
+
//====================
|
|
107
|
+
|
|
108
|
+
/**
|
|
109
|
+
* Goal statement - what the agent aims to achieve
|
|
110
|
+
* Single sentence describing success criteria
|
|
111
|
+
*/
|
|
112
|
+
goal: z.string().optional(),
|
|
113
|
+
|
|
114
|
+
//====================
|
|
115
|
+
// OUTPUT SPECIFICATION
|
|
116
|
+
//====================
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* Output specification - format and structure requirements
|
|
120
|
+
*/
|
|
121
|
+
output: FlowsActors_Agent_OutputSpecSchema.optional(),
|
|
122
|
+
|
|
123
|
+
//====================
|
|
124
|
+
// INSTRUCTIONS & HINTS
|
|
125
|
+
//====================
|
|
126
|
+
|
|
127
|
+
/** Hard rules - behavioral instructions (in addition to skill type baseline) */
|
|
128
|
+
instructions: z.array(z.string()).default([]),
|
|
129
|
+
|
|
130
|
+
/** Soft hints - preferences, can be overridden by task constraints */
|
|
131
|
+
hints: z.array(z.string()).optional(),
|
|
132
|
+
|
|
133
|
+
//====================
|
|
134
|
+
// UNCERTAINTY HANDLING
|
|
135
|
+
//====================
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* Uncertainty handling policy
|
|
139
|
+
*/
|
|
140
|
+
uncertainty: FlowsActors_Agent_UncertaintySchema.optional(),
|
|
141
|
+
|
|
142
|
+
//====================
|
|
143
|
+
// SCOPE BOUNDARIES
|
|
144
|
+
//====================
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* Scope boundaries - explicit "don't do" statements
|
|
148
|
+
* Helps prevent scope creep
|
|
149
|
+
*/
|
|
150
|
+
outOfScope: z.array(z.string()).optional(),
|
|
151
|
+
|
|
152
|
+
//====================
|
|
153
|
+
// EXAMPLES (few-shot)
|
|
154
|
+
//====================
|
|
155
|
+
|
|
156
|
+
/**
|
|
157
|
+
* Examples - few-shot examples for better output quality
|
|
158
|
+
* Format: input/output pairs with optional explanation
|
|
159
|
+
*/
|
|
160
|
+
examples: z.array(z.object({
|
|
161
|
+
input: z.string(),
|
|
162
|
+
output: z.string(),
|
|
163
|
+
explanation: z.string().optional(),
|
|
164
|
+
})).optional(),
|
|
165
|
+
|
|
166
|
+
//====================
|
|
167
|
+
// STYLE
|
|
168
|
+
//====================
|
|
169
|
+
|
|
170
|
+
/** Style preferences */
|
|
171
|
+
style: z.object({
|
|
172
|
+
verbosity: z.enum(FlowsActors_Agent_Verbosity).optional(),
|
|
173
|
+
tone: z.enum(FlowsActors_Agent_Tone).optional(),
|
|
174
|
+
}).optional(),
|
|
175
|
+
|
|
176
|
+
//====================
|
|
177
|
+
// CONTEXT CURATION
|
|
178
|
+
//====================
|
|
179
|
+
|
|
180
|
+
/** Context curation settings */
|
|
181
|
+
curation: z.object({
|
|
182
|
+
/** Maximum context items to include */
|
|
183
|
+
maxItems: z.number().min(1).max(100).optional(),
|
|
184
|
+
/** Minimum relevance score threshold (0-1) */
|
|
185
|
+
minRelevance: z.number().min(0).max(1).optional(),
|
|
186
|
+
/** Maximum total tokens for context */
|
|
187
|
+
maxTokens: z.number().optional(),
|
|
188
|
+
}).optional(),
|
|
189
|
+
|
|
190
|
+
//====================
|
|
191
|
+
// FORMAT & METADATA
|
|
192
|
+
//====================
|
|
193
|
+
|
|
194
|
+
/** Override provider's default prompt format */
|
|
195
|
+
promptFormatOverride: z.enum(LLMProvider_PromptFormat).optional(),
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* Prompt specification metadata for versioning and tracking
|
|
199
|
+
* Helps track prompt iterations and authorship for 200+ agents
|
|
200
|
+
*/
|
|
201
|
+
metadata: z.object({
|
|
202
|
+
/** Semantic version of this prompt spec (e.g., "1.2.0") */
|
|
203
|
+
version: z.string().optional(),
|
|
204
|
+
/** Last modification date (ISO 8601) */
|
|
205
|
+
lastModified: z.string().optional(),
|
|
206
|
+
/** Author or team responsible */
|
|
207
|
+
author: z.string().optional(),
|
|
208
|
+
/** Brief changelog or reason for current version */
|
|
209
|
+
changelog: z.string().optional(),
|
|
210
|
+
}).optional(),
|
|
211
|
+
});
|
|
212
|
+
|
|
213
|
+
export type FlowsActors_Agent_PromptSpec = z.infer<typeof FlowsActors_Agent_PromptSpecSchema>;
|
|
214
|
+
```
|
|
@@ -0,0 +1,195 @@
|
|
|
1
|
+
# Operation vocabulary + model configuration — source contracts
|
|
2
|
+
|
|
3
|
+
Read this at Step 1 (pick the operation key) and Step 4 (sampling / reasoning).
|
|
4
|
+
It surfaces:
|
|
5
|
+
|
|
6
|
+
- `LLMProvider_OperationKey` — the operation vocabulary. The key you set on an
|
|
7
|
+
agent's `config.operationKey` selects the executor, and with it BOTH the
|
|
8
|
+
invocation `input` shape you must supply and the wrapped `output` shape you get
|
|
9
|
+
back. `GENERATE_STRUCTURED` requires `input.schema`.
|
|
10
|
+
- `LLMProvider_OperationModelConfiguration` — the provider/model/sampling surface
|
|
11
|
+
every LLM agent config inherits (`providerRef`, `model`, `temperature`,
|
|
12
|
+
`maxTokens`, `topP`, `reasoningEffort`, `toolChoice`, …). Every field beyond
|
|
13
|
+
`providerRef` + `model` is optional and forwarded verbatim.
|
|
14
|
+
- `LLMProvider_ReasoningEffort` — the single authority on thinking depth, with the
|
|
15
|
+
**live-verified per-model support matrix**. Read the matrix before setting it:
|
|
16
|
+
`NONE` is not portable (fine on GPT-5.6, a hard error on Claude 5), and
|
|
17
|
+
`PROVIDER_DEFAULT` is rejected as an explicit value by GPT-5.6 — omit the field
|
|
18
|
+
instead of naming the default.
|
|
19
|
+
- `validateReasoningEffortForModel` — the guard the framework runs when your agent
|
|
20
|
+
REGISTERS. An impossible `model × effort` pair becomes a named startup error
|
|
21
|
+
instead of a provider 400 in the middle of a paid call. It fails OPEN on model
|
|
22
|
+
ids it has not verified, so a clean startup is not proof that an exotic model
|
|
23
|
+
accepts your effort level.
|
|
24
|
+
|
|
25
|
+
All import from `@wildo-ai/external-connectors-models`.
|
|
26
|
+
|
|
27
|
+
## Import Origins
|
|
28
|
+
|
|
29
|
+
- `@wildo-ai/external-connectors-models`
|
|
30
|
+
|
|
31
|
+
## Source Excerpts
|
|
32
|
+
|
|
33
|
+
### Origin Package: `@wildo-ai/external-connectors-models`
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
*
|
|
37
|
+
* The LLM operation vocabulary — WHAT a call does, never HOW HARD it thinks.
|
|
38
|
+
*
|
|
39
|
+
* This is the key you put on an agent's `config.operationKey`. It selects the
|
|
40
|
+
* executor, and with it BOTH the invocation `input` shape you must supply and
|
|
41
|
+
* the `output` shape you get back:
|
|
42
|
+
*
|
|
43
|
+
* | Operation key | `invocation.input` | `invocation.output` |
|
|
44
|
+
* |-----------------------|-------------------------------|---------------------|
|
|
45
|
+
* | `GENERATE_TEXT` | `{ prompt }` | `{ text }` |
|
|
46
|
+
* | `GENERATE_STRUCTURED` | `{ prompt, schema }` (Zod) | `{ object }` |
|
|
47
|
+
* | `CHAT_COMPLETION` | `{ messages }` or `{ prompt }`| `{ message }` |
|
|
48
|
+
* | `CHAT_MULTIMODAL` | `{ prompt, images }` | `{ message }` |
|
|
49
|
+
*
|
|
50
|
+
* `GENERATE_STRUCTURED` REQUIRES `input.schema`; omitting it is a validation
|
|
51
|
+
* error, not a silent fallback to text. The `STREAM_*` keys exist for the
|
|
52
|
+
* conversational runtime — a one-shot caller uses the buffered keys above.
|
|
53
|
+
*
|
|
54
|
+
* Import path: `@wildo-ai/external-connectors-models`.
|
|
55
|
+
*
|
|
56
|
+
* Reasoning depth is a PARAMETER ({@link LLMProvider_ReasoningEffort} on the
|
|
57
|
+
* model configuration), not an operation. The six `*_THINKING` op keys that
|
|
58
|
+
* used to live here were RETIRED (2026-07-17): they were inert at execution
|
|
59
|
+
* (each routed to the exact same executor as its non-thinking sibling) and,
|
|
60
|
+
* once `reasoningEffort` landed, they became a SECOND authority axis for the
|
|
61
|
+
* same concept — two ways to say "think harder", neither carrying its own
|
|
62
|
+
* semantic weight. A model's ability to reason is a property of the model +
|
|
63
|
+
* the effort parameter, not a parallel operation surface.
|
|
64
|
+
*/
|
|
65
|
+
export enum LLMProvider_OperationKey {
|
|
66
|
+
GENERATE_TEXT = "llm.generateText",
|
|
67
|
+
CHAT_COMPLETION = "llm.chatCompletion",
|
|
68
|
+
STREAM_TEXT = "llm.streamText",
|
|
69
|
+
GENERATE_STRUCTURED = "llm.generateStructured",
|
|
70
|
+
CHAT_MULTIMODAL = "llm.chatMultimodal",
|
|
71
|
+
STREAM_STRUCTURED = "llm.streamStructured",
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
## Import Origins
|
|
75
|
+
|
|
76
|
+
- `@wildo-ai/external-connectors-models`
|
|
77
|
+
|
|
78
|
+
## Source Excerpts
|
|
79
|
+
|
|
80
|
+
### Origin Package: `@wildo-ai/external-connectors-models`
|
|
81
|
+
|
|
82
|
+
```typescript
|
|
83
|
+
*
|
|
84
|
+
* Reasoning-effort control for reasoning-capable models (GPT-5.6 Sol/Terra/Luna,
|
|
85
|
+
* OpenAI o-series, Claude 5 thinking, Gemini reasoning, …). The values mirror
|
|
86
|
+
* the AI SDK 7 top-level `reasoning` option EXACTLY, which the SDK translates to
|
|
87
|
+
* each provider's native reasoning setting (OpenAI `reasoning_effort`, Anthropic
|
|
88
|
+
* thinking budget, …). Omit for non-reasoning models or to accept the provider
|
|
89
|
+
* default.
|
|
90
|
+
*
|
|
91
|
+
* Effort ladder (cost/latency ↑ with depth):
|
|
92
|
+
* - `NONE` — reasoning off; mechanical tasks (extraction, formatting, labelling).
|
|
93
|
+
* - `MINIMAL` / `LOW` — brief reasoning; simple structured output.
|
|
94
|
+
* - `MEDIUM` — balanced; most authored generation (market/email copy).
|
|
95
|
+
* - `HIGH` / `XHIGH` — deep reasoning; judgment work (persona derivation,
|
|
96
|
+
* deliberation, logo/quality judges).
|
|
97
|
+
* - `PROVIDER_DEFAULT` — explicitly defer to the model's own default effort.
|
|
98
|
+
*
|
|
99
|
+
* NOT EVERY MODEL SUPPORTS EVERY LEVEL — the SDK forwards the value and the
|
|
100
|
+
* provider validates it. Support matrix VERIFIED LIVE (2026-07-16/17); pick a
|
|
101
|
+
* level the target model actually supports:
|
|
102
|
+
*
|
|
103
|
+
* | Model family | Supported | Rejected |
|
|
104
|
+
* |---------------------|------------------------------------|--------------------------------|
|
|
105
|
+
* | OpenAI GPT-5.6 | none, low, medium, high, xhigh | `minimal`, `max` |
|
|
106
|
+
* | Anthropic Claude 5 | low, medium, high, xhigh | **`none`** — thinking CANNOT |
|
|
107
|
+
* | (fable-5, …) | | be disabled ("thinking.type. |
|
|
108
|
+
* | | | disabled is not supported…"; |
|
|
109
|
+
* | | | defaults to adaptive) |
|
|
110
|
+
*
|
|
111
|
+
* ⚠️ `NONE` is therefore NOT portable: it turns reasoning off on GPT-5.6 but
|
|
112
|
+
* ERRORS on Claude 5. `PROVIDER_DEFAULT` as an explicit value is also rejected
|
|
113
|
+
* by GPT-5.6 — omit the field entirely for the model's default instead.
|
|
114
|
+
*/
|
|
115
|
+
export enum LLMProvider_ReasoningEffort {
|
|
116
|
+
PROVIDER_DEFAULT = "provider-default",
|
|
117
|
+
NONE = "none",
|
|
118
|
+
MINIMAL = "minimal",
|
|
119
|
+
LOW = "low",
|
|
120
|
+
MEDIUM = "medium",
|
|
121
|
+
HIGH = "high",
|
|
122
|
+
XHIGH = "xhigh",
|
|
123
|
+
}
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
### Origin Package: `@wildo-ai/external-connectors-models`
|
|
127
|
+
|
|
128
|
+
```typescript
|
|
129
|
+
*
|
|
130
|
+
* Validate a `model × reasoningEffort` pair against verified capability.
|
|
131
|
+
*
|
|
132
|
+
* Returns a human-readable violation, or `null` when the pair is valid OR
|
|
133
|
+
* cannot be judged. **Fails OPEN by design** (unknown model, or omitted effort
|
|
134
|
+
* → `null`): the alternative would reject legitimate custom deployments.
|
|
135
|
+
*
|
|
136
|
+
* Call this at authoring/registration time so an impossible pair surfaces as a
|
|
137
|
+
* named startup error instead of a provider 400 in the middle of a long agent
|
|
138
|
+
* pipeline — the trap this exists to catch is `NONE`, which turns reasoning off
|
|
139
|
+
* on GPT-5.6 but hard-errors on Claude 5.
|
|
140
|
+
*
|
|
141
|
+
* @param model The configured model id (free-form; unknown ids pass).
|
|
142
|
+
* @param effort The configured effort; omit/undefined always passes.
|
|
143
|
+
* @returns A violation message, or `null` if valid/unjudgeable.
|
|
144
|
+
*/
|
|
145
|
+
export const validateReasoningEffortForModel = (
|
|
146
|
+
model: string,
|
|
147
|
+
effort: LLMProvider_ReasoningEffort | undefined,
|
|
148
|
+
): string | null => {
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
### Origin Package: `@wildo-ai/external-connectors-models`
|
|
152
|
+
|
|
153
|
+
```typescript
|
|
154
|
+
*
|
|
155
|
+
* The provider/model/sampling surface every LLM agent config inherits — this is
|
|
156
|
+
* the shape behind an agent's `config` (an agent adds `operationKey` on top).
|
|
157
|
+
*
|
|
158
|
+
* `providerRef` names a provider you enabled for the `AI_LLM` capability in
|
|
159
|
+
* `defineSaaSProviders`; `model` is a free-form string so fine-tuned and custom
|
|
160
|
+
* deployment ids stay legal. Every sampling field is OPTIONAL and every one of
|
|
161
|
+
* them is forwarded to the provider verbatim — so an unsupported value is a
|
|
162
|
+
* provider 400, not a framework-side clamp. Omit a field to accept the model's
|
|
163
|
+
* own default; that is the portable choice (notably: the Claude 5 family
|
|
164
|
+
* REJECTS an explicit `temperature`).
|
|
165
|
+
*/
|
|
166
|
+
export const LLMProvider_OperationModelConfiguration_Schema = z.object({
|
|
167
|
+
model: z.string(),
|
|
168
|
+
providerRef: z.string(),
|
|
169
|
+
temperature: z.number().optional(),
|
|
170
|
+
maxTokens: z.number().optional(),
|
|
171
|
+
topP: z.number().optional(),
|
|
172
|
+
frequencyPenalty: z.number().optional(),
|
|
173
|
+
presencePenalty: z.number().optional(),
|
|
174
|
+
stopStringSequences: z.array(z.string()).optional(),
|
|
175
|
+
/**
|
|
176
|
+
* Reasoning-effort for reasoning-capable models — forwarded as the AI SDK
|
|
177
|
+
* top-level `reasoning` option (see {@link LLMProvider_ReasoningEffort}).
|
|
178
|
+
* Optional + additive: an agent that omits it keeps the model's default
|
|
179
|
+
* effort (the pre-Phase-3 behavior).
|
|
180
|
+
*/
|
|
181
|
+
reasoningEffort: z.enum(LLMProvider_ReasoningEffort).optional(),
|
|
182
|
+
// NOTE: a `thinkingEnabled: boolean` field used to sit here. RETIRED
|
|
183
|
+
// (2026-07-17) — it was a THIRD authority axis on reasoning (alongside
|
|
184
|
+
// `reasoningEffort` and the `*_THINKING` op keys), it was strictly subsumed
|
|
185
|
+
// by `reasoningEffort` (which expresses on/off AND depth), and it was never
|
|
186
|
+
// read by any executor: the `THINKING_MODE` model preset and the
|
|
187
|
+
// `ThinkingModeFacet` set it, and nothing acted on it. Authors composing that
|
|
188
|
+
// facet believed they were enabling deep reasoning and got nothing. Use
|
|
189
|
+
// `reasoningEffort` — it is the single authority.
|
|
190
|
+
toolingFunctionEnabled: z.boolean().optional(),
|
|
191
|
+
mcpCompatible: z.boolean().optional(),
|
|
192
|
+
toolChoice: LLMProvider_ToolChoice_Schema.optional(),
|
|
193
|
+
});
|
|
194
|
+
export type LLMProvider_OperationModelConfiguration = z.infer<typeof LLMProvider_OperationModelConfiguration_Schema>;
|
|
195
|
+
```
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Choosing the operation key + enabling the provider
|
|
2
|
+
|
|
3
|
+
Two decisions come before you write the agent. Both are cheap to get right now
|
|
4
|
+
and expensive to discover at runtime.
|
|
5
|
+
|
|
6
|
+
## 1. Which operation key?
|
|
7
|
+
|
|
8
|
+
| You want back | Operation key | `invocation.input` | `result.output` |
|
|
9
|
+
|---|---|---|---|
|
|
10
|
+
| Fields you will act on in code (a category, a score, extracted values) | `GENERATE_STRUCTURED` | `{ prompt, schema }` — `schema` is a Zod schema and is **required** | `{ object }` |
|
|
11
|
+
| Prose a human reads (a summary, a draft, a rewrite) | `GENERATE_TEXT` | `{ prompt }` | `{ text }` |
|
|
12
|
+
| An answer in a message turn, with prior turns supplied | `CHAT_COMPLETION` | `{ messages }` (or `{ prompt }`) | `{ message }` |
|
|
13
|
+
| A judgement about an image | `CHAT_MULTIMODAL` | `{ prompt, images }` | `{ message }` |
|
|
14
|
+
|
|
15
|
+
Bias to `GENERATE_STRUCTURED`. If any part of the answer will be compared,
|
|
16
|
+
stored in a field, or branched on, structured output removes a parsing step and
|
|
17
|
+
gives you a schema to validate against. Use `GENERATE_TEXT` only when the whole
|
|
18
|
+
answer is prose.
|
|
19
|
+
|
|
20
|
+
`CHAT_COMPLETION` here means "one call that happens to carry message history" —
|
|
21
|
+
it is still one-shot. A real assistant (streamed tokens, persisted conversation,
|
|
22
|
+
tool grounding, a view) is a different skill: `flows-actors-chat-assistant`.
|
|
23
|
+
|
|
24
|
+
The `STREAM_TEXT` / `STREAM_STRUCTURED` keys belong to the conversational
|
|
25
|
+
runtime. A one-shot caller does not use them; awaiting `invokeAgent` already
|
|
26
|
+
returns the complete answer.
|
|
27
|
+
|
|
28
|
+
## 2. Is the provider enabled for `AI_LLM`?
|
|
29
|
+
|
|
30
|
+
The agent's `providerRef` must resolve to a provider you declared in
|
|
31
|
+
`wildo.saas.config.ts` under `defineSaaSProviders({ scopes: { backend: … } })`,
|
|
32
|
+
with:
|
|
33
|
+
|
|
34
|
+
- `engineCapabilities: [EngineCapability.AI_LLM]` — the capability slot the
|
|
35
|
+
agent runtime queries;
|
|
36
|
+
- `providerCapabilities` including the LLM capability it satisfies (e.g.
|
|
37
|
+
`'LLM_CHAT'`);
|
|
38
|
+
- `protocols` including `'LLM_PROVIDER'` (the API transport).
|
|
39
|
+
|
|
40
|
+
Then configure that provider's credentials for the environment. **The call fails
|
|
41
|
+
closed**: with no API key, invocation raises a configuration error rather than
|
|
42
|
+
degrading or returning empty — which is the behavior you want, but it means an
|
|
43
|
+
unconfigured environment fails at the first call, not at startup.
|
|
44
|
+
|
|
45
|
+
Declaring several `AI_LLM` providers is normal (one per model family). The agent
|
|
46
|
+
picks among them by `providerRef`; the capability declaration is what makes the
|
|
47
|
+
ref resolvable at all.
|
|
48
|
+
|
|
49
|
+
## 3. Which model?
|
|
50
|
+
|
|
51
|
+
`model` is a free-form string, so fine-tuned and custom deployment ids are legal
|
|
52
|
+
— and nothing validates the id itself. Two consequences worth internalising:
|
|
53
|
+
|
|
54
|
+
- A typo in a model id is a provider error at call time, not a startup error.
|
|
55
|
+
- The reasoning-capability guard cannot judge a model it has not verified, so it
|
|
56
|
+
**passes** unknown ids. A clean startup does not prove the model accepts your
|
|
57
|
+
`reasoningEffort`.
|
|
58
|
+
|
|
59
|
+
See `framework-llm-operation-and-model-api.md` for the verified support matrix
|
|
60
|
+
before choosing a reasoning level.
|