@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,376 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: flows-actors-llm-agent-invocation
|
|
3
|
+
description: Author a one-shot LLM agent and call it from your own backend code — plain text or schema-constrained structured output. Use when the user says "summarize this with AI", "classify/categorize these with an LLM", "extract fields from this text", "call Claude / GPT from the backend", "add an AI agent that generates X", "get structured JSON out of a model", "score or triage this automatically", or "invokeAgent" — i.e. one request, one answer, no back-and-forth and no chat screen. Covers picking the operation key, the agent definition, provider/model/reasoning settings, registering the agent, building the invocation envelope, and reading the wrapped output.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# One-Shot LLM Agent — Authoring & Invocation
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
Your app uses its `AI_LLM` capability by authoring an **agent** and **invoking**
|
|
23
|
+
it. Two small pieces:
|
|
24
|
+
|
|
25
|
+
1. a `FlowsActors_Agent` — the durable declaration (provider, model, operation,
|
|
26
|
+
prompt), registered on a backend module's `flowsActors.agents`;
|
|
27
|
+
2. a call to `AgentsBackendService.invokeAgent(invocation)` from your own
|
|
28
|
+
service, custom operation, or batch job.
|
|
29
|
+
|
|
30
|
+
Everything between those two is engine-owned: provider-client resolution, API-key
|
|
31
|
+
lookup (fail-closed), per-provider rate limiting, prompt compilation into the
|
|
32
|
+
provider's preferred format, output normalization, usage/latency tracing. You
|
|
33
|
+
never write an SDK call, an API key read, or a retry loop.
|
|
34
|
+
|
|
35
|
+
The split matters: what is **durable about the agent** (its role, rules, model)
|
|
36
|
+
belongs in the definition; what is **specific to this call** (the text to act on,
|
|
37
|
+
the output schema) belongs in the invocation.
|
|
38
|
+
|
|
39
|
+
## App Paths
|
|
40
|
+
|
|
41
|
+
| Surface | Glob (relative to app root) |
|
|
42
|
+
|---|---|
|
|
43
|
+
| Agent definition | `backend-api/src/modules/<module>/addons/flows-actors/*.ts` |
|
|
44
|
+
| Backend module assembly (`flowsActors: …`) | `backend-api/src/modules/<module>/index.ts` |
|
|
45
|
+
| Calling service | `backend-api/src/modules/<module>/services/*.backend.service.ts` |
|
|
46
|
+
| Calling custom operation | `backend-api/src/modules/<module>/resources/**/*.operation.ts` |
|
|
47
|
+
| Provider selection (`defineSaaSProviders`) | `wildo.saas.config.ts` |
|
|
48
|
+
| Provider credentials per environment | `infrastructure/<env>/*.ts` |
|
|
49
|
+
|
|
50
|
+
## When to Use
|
|
51
|
+
|
|
52
|
+
- One request → one answer: summarize, classify, extract, rewrite, score, triage.
|
|
53
|
+
- You want a **typed object** back from a model, validated against your own schema.
|
|
54
|
+
- The call runs server-side from your code — not from a user typing in a chat box.
|
|
55
|
+
|
|
56
|
+
## When NOT to Use
|
|
57
|
+
|
|
58
|
+
- **A conversational assistant** (multi-turn, streamed, surfaced as a view, calls
|
|
59
|
+
tools to look up the user's data) → `flows-actors-chat-assistant`. Function
|
|
60
|
+
tools only execute on that path.
|
|
61
|
+
- **Generating an image** → that is the image modality arm; see `brand-logo-authoring`.
|
|
62
|
+
- **Exposing an agent to external callers** → `flows-actors-a2a-exposure`.
|
|
63
|
+
- **Wiring the service that calls the agent** into DI → `backend-addon-wiring`.
|
|
64
|
+
|
|
65
|
+
## Workflow
|
|
66
|
+
|
|
67
|
+
### Step 1: Pick the operation key
|
|
68
|
+
It fixes both the input you must supply and the output shape you get back.
|
|
69
|
+
Structured (`GENERATE_STRUCTURED`) whenever you need fields you will act on
|
|
70
|
+
programmatically; text (`GENERATE_TEXT`) only when the answer is prose a human
|
|
71
|
+
reads. See `references/operation-key-selection.md` for the decision table and the
|
|
72
|
+
full input/output map.
|
|
73
|
+
|
|
74
|
+
### Step 2: Confirm the provider is enabled
|
|
75
|
+
The agent's `providerRef` must name a provider you enabled for the `AI_LLM`
|
|
76
|
+
capability in `defineSaaSProviders`, with credentials configured for the
|
|
77
|
+
environment. Without a key the call fails closed at invocation with a
|
|
78
|
+
configuration error — it does not degrade. Same reference file.
|
|
79
|
+
|
|
80
|
+
### Step 3: Author the agent
|
|
81
|
+
File: `backend-api/src/modules/<module>/addons/flows-actors/index.ts`. Set `ref`,
|
|
82
|
+
`status: ACTIVE`, `config` (`providerRef` + `model` + `operationKey` +
|
|
83
|
+
`accessControl` + `riskLevel`), a matching `operationDefinition`, and a
|
|
84
|
+
`promptSpec` (`role` + `skillType` are the required minimum). Put the agent's
|
|
85
|
+
durable rules in `promptSpec.instructions`, never the per-call text. See
|
|
86
|
+
`references/framework-llm-agent-definition-api.md` and
|
|
87
|
+
`references/framework-llm-agent-prompt-spec-api.md`.
|
|
88
|
+
|
|
89
|
+
### Step 4: Choose sampling deliberately, or not at all
|
|
90
|
+
Every sampling field is optional and forwarded to the provider verbatim, so a
|
|
91
|
+
wrong value is a provider 400, not a clamp. Omitting is portable. `reasoningEffort`
|
|
92
|
+
is the single authority on thinking depth — and its values are **not** portable
|
|
93
|
+
across model families. Read the support matrix in
|
|
94
|
+
`references/framework-llm-operation-and-model-api.md` before setting it; a bad
|
|
95
|
+
`model × effort` pair is refused at startup, when the agent registers.
|
|
96
|
+
|
|
97
|
+
### Step 5: Register the agent
|
|
98
|
+
Add it to the module's `flowsActors.agents` array so the registry can resolve
|
|
99
|
+
`agentRef`. An unregistered ref throws at invocation. See `backend-addon-wiring`
|
|
100
|
+
for how the module contribution is assembled.
|
|
101
|
+
|
|
102
|
+
### Step 6: Invoke it
|
|
103
|
+
Inject `AgentsBackendService` by its DI symbol, build the invocation envelope
|
|
104
|
+
(`agentRef`, `input`, an empty `output` seed, `initiator: {}`,
|
|
105
|
+
`invocationContext: []`, `artifactBindings: []`), and await
|
|
106
|
+
`invokeAgent(invocation)`. See `references/framework-llm-agent-invocation-api.md`.
|
|
107
|
+
|
|
108
|
+
### Step 7: Unwrap and re-validate the output
|
|
109
|
+
`result.output` is **wrapped by operation** — `{ text }`, `{ object }`,
|
|
110
|
+
`{ message }`. Read the right key, then re-parse with your own Zod schema before
|
|
111
|
+
using the values. The model is the one input you do not control.
|
|
112
|
+
|
|
113
|
+
### Step 8: Verify
|
|
114
|
+
Run the grep invariants below.
|
|
115
|
+
|
|
116
|
+
## Worked Example
|
|
117
|
+
|
|
118
|
+
The complete vertical for a structured one-shot call — the Zod output contract,
|
|
119
|
+
the `GENERATE_STRUCTURED` agent, its registration, and the invoking service with
|
|
120
|
+
envelope construction and output unwrapping. Note how the output schema is passed
|
|
121
|
+
**per invocation** (`input.schema`), not baked into the agent, so one agent can
|
|
122
|
+
serve several shapes:
|
|
123
|
+
|
|
124
|
+
|
|
125
|
+
## Usage Example
|
|
126
|
+
|
|
127
|
+
```typescript
|
|
128
|
+
import { z } from 'zod';
|
|
129
|
+
import { inject, injectable } from 'inversify';
|
|
130
|
+
import {
|
|
131
|
+
FlowsActors_Agent,
|
|
132
|
+
FlowsActors_Agent_Invocation,
|
|
133
|
+
FlowsActors_Agent_Skill_Type,
|
|
134
|
+
FlowsActors_Agent_Status,
|
|
135
|
+
ResourceOperationRiskLevel,
|
|
136
|
+
ResourcePrimaryScope,
|
|
137
|
+
} from '@wildo-ai/saas-models';
|
|
138
|
+
import {
|
|
139
|
+
LLMProvider_GenerateStructuredInputSchema,
|
|
140
|
+
LLMProvider_GenerateStructuredOutputSchema,
|
|
141
|
+
LLMProvider_OperationContext_BaseSchema,
|
|
142
|
+
LLMProvider_OperationDefinitionBase,
|
|
143
|
+
LLMProvider_OperationKey,
|
|
144
|
+
LLMProvider_ReasoningEffort,
|
|
145
|
+
LLM_Model,
|
|
146
|
+
} from '@wildo-ai/external-connectors-models';
|
|
147
|
+
import { AgentsBackendService, SAAS_SERVICE_TYPES } from '@wildo-ai/saas-backend-lib';
|
|
148
|
+
|
|
149
|
+
const TICKET_TRIAGE_AGENT_REF = 'support.ticket-triage.agent' as const;
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* 1a. THE VOCABULARIES the output contract closes over. Declare each one ONCE as a
|
|
153
|
+
* named enum and derive the schema from it — never inline `z.enum(['...'])`.
|
|
154
|
+
*
|
|
155
|
+
* This is not ceremony. The enum is the only place a per-member explanation can
|
|
156
|
+
* live, and that explanation is doing double duty here: your own code reads it,
|
|
157
|
+
* and `.describe()` puts the same meaning in front of the model. A bare literal
|
|
158
|
+
* union has nowhere to write either one, and every consumer that later compares
|
|
159
|
+
* against `'feature_request'` is spelling the value from memory.
|
|
160
|
+
*/
|
|
161
|
+
enum TicketCategory {
|
|
162
|
+
/** Charges, invoices, refunds, plan changes. */
|
|
163
|
+
BILLING = 'billing',
|
|
164
|
+
/** Something is broken that used to work. */
|
|
165
|
+
BUG = 'bug',
|
|
166
|
+
/** A request for behavior the product does not have yet. */
|
|
167
|
+
FEATURE_REQUEST = 'feature_request',
|
|
168
|
+
/** Login, access, seats, profile — not a charge dispute. */
|
|
169
|
+
ACCOUNT = 'account',
|
|
170
|
+
/** Deliberate escape hatch, so the model is never forced into a wrong bucket. */
|
|
171
|
+
OTHER = 'other',
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
enum TicketUrgency {
|
|
175
|
+
/** Answer within the normal support window. */
|
|
176
|
+
LOW = 'low',
|
|
177
|
+
/** Answer the same day. */
|
|
178
|
+
MEDIUM = 'medium',
|
|
179
|
+
/** Outage, data loss, or billing failure — page a human now. */
|
|
180
|
+
HIGH = 'high',
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/**
|
|
184
|
+
* 1b. THE OUTPUT CONTRACT — an ordinary Zod schema. This is what makes the call
|
|
185
|
+
* structured: it is passed per-invocation as `input.schema`, so one agent can
|
|
186
|
+
* serve several shapes. Describe every field — the descriptions are part of
|
|
187
|
+
* the prompt the provider sees, and they do most of the accuracy work.
|
|
188
|
+
*/
|
|
189
|
+
const TicketTriageSchema = z.object({
|
|
190
|
+
category: z.enum(TicketCategory)
|
|
191
|
+
.describe('The single best-fitting category for the ticket.'),
|
|
192
|
+
urgency: z.enum(TicketUrgency)
|
|
193
|
+
.describe(`How quickly a human must respond. "${TicketUrgency.HIGH}" only for outages, data loss, or billing failures.`),
|
|
194
|
+
summary: z.string().max(200)
|
|
195
|
+
.describe('One-sentence neutral summary of what the customer is asking for.'),
|
|
196
|
+
});
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* 2. THE AGENT — declarative, durable. Provider, model, operation, and prompt
|
|
200
|
+
* live here; the per-call task does not. `status` must be ACTIVE to be
|
|
201
|
+
* invocable, and `promptSpec.role` + `skillType` are the only required
|
|
202
|
+
* prompt fields.
|
|
203
|
+
*/
|
|
204
|
+
export const ticketTriageAgent: FlowsActors_Agent = {
|
|
205
|
+
ref: TICKET_TRIAGE_AGENT_REF,
|
|
206
|
+
displayName: 'Support Ticket Triage',
|
|
207
|
+
status: FlowsActors_Agent_Status.ACTIVE,
|
|
208
|
+
config: {
|
|
209
|
+
providerRef: 'anthropic',
|
|
210
|
+
model: LLM_Model.CLAUDE_SONNET_5,
|
|
211
|
+
operationKey: LLMProvider_OperationKey.GENERATE_STRUCTURED,
|
|
212
|
+
// Classification is shallow work — buy the cheapest reasoning rather than
|
|
213
|
+
// none. `NONE` would be a provider 400 here: the Claude 5 family ALWAYS
|
|
214
|
+
// reasons. Omitting the field entirely is the other portable choice.
|
|
215
|
+
reasoningEffort: LLMProvider_ReasoningEffort.LOW,
|
|
216
|
+
// No `temperature`: the Claude 5 family rejects it explicitly. Model
|
|
217
|
+
// defaults are the portable option for every sampling parameter.
|
|
218
|
+
accessControl: [{ primaryScope: ResourcePrimaryScope.APPLICATION, requiresApproval: false }],
|
|
219
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
220
|
+
},
|
|
221
|
+
operationDefinition: {
|
|
222
|
+
operationKey: LLMProvider_OperationKey.GENERATE_STRUCTURED,
|
|
223
|
+
providerRef: 'anthropic',
|
|
224
|
+
inputSchema: LLMProvider_GenerateStructuredInputSchema,
|
|
225
|
+
outputSchema: LLMProvider_GenerateStructuredOutputSchema,
|
|
226
|
+
operationContextSchema: LLMProvider_OperationContext_BaseSchema,
|
|
227
|
+
} satisfies LLMProvider_OperationDefinitionBase,
|
|
228
|
+
promptSpec: {
|
|
229
|
+
role: 'You triage inbound customer support tickets for a SaaS product.',
|
|
230
|
+
persona: 'You are terse and literal. You classify only what the ticket actually says.',
|
|
231
|
+
skillType: FlowsActors_Agent_Skill_Type.ANALYSIS,
|
|
232
|
+
instructions: [
|
|
233
|
+
'Choose exactly one category. When a ticket spans several, pick the one the customer is asking you to ACT on.',
|
|
234
|
+
'Reserve "high" urgency for outages, data loss, or failed payments. Frustrated tone alone is not urgency.',
|
|
235
|
+
'Summarize what the customer wants, never what you would do about it.',
|
|
236
|
+
'Never infer facts the ticket does not state — no account ids, no product names, no dates.',
|
|
237
|
+
],
|
|
238
|
+
},
|
|
239
|
+
// NOTE: no `capabilities.tools` — declared function tools are INERT on the
|
|
240
|
+
// one-shot path (only the streaming/conversational runtime executes them).
|
|
241
|
+
// A one-shot agent receives everything it needs in `input`.
|
|
242
|
+
createdAt: '2026-08-01T00:00:00.000Z',
|
|
243
|
+
};
|
|
244
|
+
|
|
245
|
+
/**
|
|
246
|
+
* 3. REGISTER IT on the backend module's `flowsActors` contribution, so the
|
|
247
|
+
* registry can resolve `agentRef` at invocation time. Assembled into the
|
|
248
|
+
* module in `backend-api/src/modules/<module>/index.ts`.
|
|
249
|
+
*/
|
|
250
|
+
export const moduleBackend_FlowsActorsRegistry: { agents: FlowsActors_Agent[] } = {
|
|
251
|
+
agents: [ticketTriageAgent],
|
|
252
|
+
};
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* 4. INVOKE IT from your own backend code — a service, a custom resource
|
|
256
|
+
* operation, a batch job. The engine owns provider resolution, rate
|
|
257
|
+
* limiting, retries, usage accounting, and tracing.
|
|
258
|
+
*/
|
|
259
|
+
@injectable()
|
|
260
|
+
export class TicketTriageBackendService {
|
|
261
|
+
constructor(
|
|
262
|
+
@inject(SAAS_SERVICE_TYPES.AgentsBackendService) private readonly agentsService: AgentsBackendService,
|
|
263
|
+
) {}
|
|
264
|
+
|
|
265
|
+
public async triageTicket(ticketBody: string): Promise<z.infer<typeof TicketTriageSchema>> {
|
|
266
|
+
const invocation: FlowsActors_Agent_Invocation<
|
|
267
|
+
typeof LLMProvider_GenerateStructuredInputSchema,
|
|
268
|
+
typeof LLMProvider_GenerateStructuredOutputSchema,
|
|
269
|
+
typeof LLMProvider_OperationContext_BaseSchema
|
|
270
|
+
> = {
|
|
271
|
+
agentRef: TICKET_TRIAGE_AGENT_REF,
|
|
272
|
+
initiator: {},
|
|
273
|
+
invocationContext: [],
|
|
274
|
+
// The per-call task. `schema` is REQUIRED for GENERATE_STRUCTURED —
|
|
275
|
+
// omitting it is a validation error, not a fallback to text.
|
|
276
|
+
input: {
|
|
277
|
+
prompt: `Triage this support ticket:\n\n${ticketBody}`,
|
|
278
|
+
schema: TicketTriageSchema,
|
|
279
|
+
},
|
|
280
|
+
// An empty seed of the expected output shape; the returned envelope
|
|
281
|
+
// replaces it. `{ text: '' }` for GENERATE_TEXT.
|
|
282
|
+
output: { object: {} },
|
|
283
|
+
executionContext: { callTimestamp: new Date().toISOString() },
|
|
284
|
+
artifactBindings: [],
|
|
285
|
+
};
|
|
286
|
+
|
|
287
|
+
const result = await this.agentsService.invokeAgent(invocation);
|
|
288
|
+
|
|
289
|
+
// Output is WRAPPED by operation: `{ object }` here, `{ text }` for
|
|
290
|
+
// GENERATE_TEXT, `{ message }` for CHAT_COMPLETION. Re-parse with your own
|
|
291
|
+
// schema — the provider is the one thing you do not control.
|
|
292
|
+
return TicketTriageSchema.parse((result.output as { object: unknown }).object);
|
|
293
|
+
}
|
|
294
|
+
}
|
|
295
|
+
```
|
|
296
|
+
|
|
297
|
+
## References
|
|
298
|
+
|
|
299
|
+
- `references/operation-key-selection.md` — which operation key, the input/output
|
|
300
|
+
map, and the provider-enablement checklist.
|
|
301
|
+
- `references/framework-llm-operation-and-model-api.md` — source contracts for the
|
|
302
|
+
operation vocabulary, the provider/model/sampling configuration, the
|
|
303
|
+
`reasoningEffort` support matrix, and the registration-time validator.
|
|
304
|
+
- `references/framework-llm-agent-definition-api.md` — source contracts for the
|
|
305
|
+
agent definition, its lifecycle status, and the modality-discriminated config union.
|
|
306
|
+
- `references/framework-llm-agent-prompt-spec-api.md` — source contract for the
|
|
307
|
+
structured prompt specification and the skill-type vocabulary.
|
|
308
|
+
- `references/framework-llm-agent-invocation-api.md` — source contracts for the
|
|
309
|
+
invocation envelope and the `invokeAgent` seam.
|
|
310
|
+
|
|
311
|
+
## Verification
|
|
312
|
+
|
|
313
|
+
- [ ] `config.operationKey` and `operationDefinition.operationKey` are the same key.
|
|
314
|
+
- [ ] `config.providerRef` and `operationDefinition.providerRef` name the same,
|
|
315
|
+
`AI_LLM`-enabled provider.
|
|
316
|
+
- [ ] Agent `status` is `ACTIVE` (nothing else is invocable).
|
|
317
|
+
- [ ] The agent appears in the module's `flowsActors.agents` array.
|
|
318
|
+
- [ ] `GENERATE_STRUCTURED` invocations pass `input.schema`.
|
|
319
|
+
- [ ] The result is read at the operation's wrapped key (`object` / `text` /
|
|
320
|
+
`message`), not as a bare value.
|
|
321
|
+
- [ ] `reasoningEffort`, if set, is supported by the configured model family.
|
|
322
|
+
- [ ] No `capabilities.tools.functionRefs` on a one-shot agent (inert there).
|
|
323
|
+
|
|
324
|
+
### Grep invariants
|
|
325
|
+
|
|
326
|
+
Run from the app root, substituting `<module>`:
|
|
327
|
+
|
|
328
|
+
| Check | Command |
|
|
329
|
+
|---|---|
|
|
330
|
+
| Agent is registered, not just declared | `rg -n "agents:\s*\[" backend-api/src/modules/<module>/addons/flows-actors` |
|
|
331
|
+
| Operation key agrees across config + operationDefinition | `rg -n "operationKey:" backend-api/src/modules/<module>/addons/flows-actors` |
|
|
332
|
+
| Every structured agent's callers pass a schema | `rg -n -U "GENERATE_STRUCTURED[\s\S]{0,400}schema:" backend-api/src` |
|
|
333
|
+
| Output is unwrapped, not used bare | `rg -n "invokeAgent\(" -A 4 backend-api/src \| rg "\.output"` |
|
|
334
|
+
| **No tools on a one-shot agent** (should be empty) | `rg -n -U "GENERATE_(TEXT\|STRUCTURED)[\s\S]{0,600}functionRefs" backend-api/src` |
|
|
335
|
+
| **No hand-rolled provider SDK call** (should be empty) | `rg -n "@ai-sdk/\|new Anthropic\(\|new OpenAI\(" backend-api/src` |
|
|
336
|
+
| **No API key read in app code** (should be empty) | `rg -n "ANTHROPIC_API_KEY\|OPENAI_API_KEY" backend-api/src` |
|
|
337
|
+
|
|
338
|
+
## Common Rationalizations
|
|
339
|
+
|
|
340
|
+
| Rationalization | Reality |
|
|
341
|
+
|---|---|
|
|
342
|
+
| "I'll just call the provider SDK directly — it's one HTTP call." | Then you own the API key, the rate limiter, the retry policy, usage accounting, and the LLM-observability trace — all of which the engine already does, per provider. You also lose the ability to switch provider from config. Author an agent. |
|
|
343
|
+
| "I'll give the agent a tool so it can fetch what it needs." | Declared `functionRefs` are **inert** on the one-shot path — only the streaming/conversational runtime executes tools. It fails silently, not loudly. Fetch the data yourself and put it in `input`. |
|
|
344
|
+
| "I'll put the text to summarize in the agent's `promptSpec`." | The prompt spec is the agent's durable identity, compiled once per call for every caller. Per-call material goes in `invocation.input.prompt`, or you get one agent per input. |
|
|
345
|
+
| "`temperature: 0` makes it deterministic — always set it." | The Claude 5 family REJECTS an explicit `temperature` outright. Sampling values are forwarded verbatim; an unsupported one is a provider 400. Omit and take model defaults unless you have a measured reason. |
|
|
346
|
+
| "`reasoningEffort: NONE` is the cheap option for simple tasks." | Not portable. It turns reasoning off on GPT-5.6 but hard-errors on Claude 5, which cannot disable thinking. Use `LOW`, or omit the field. |
|
|
347
|
+
| "The model returned my schema, so I can use the object directly." | Structured output is schema-*guided*, not schema-*guaranteed*, and it arrives wrapped in `{ object }`. Unwrap, then re-parse with your own schema before acting on the values. |
|
|
348
|
+
| "I'll add the agent file and it will be picked up." | Agents are registered explicitly through the module's `flowsActors.agents` array — there is no filesystem scan. An unregistered `agentRef` throws at invocation. |
|
|
349
|
+
|
|
350
|
+
## Red Flags
|
|
351
|
+
|
|
352
|
+
- A provider SDK imported, or an `*_API_KEY` read, anywhere in `backend-api`
|
|
353
|
+
(catch with the **no hand-rolled provider SDK call** / **no API key read** greps).
|
|
354
|
+
- `capabilities.tools.functionRefs` on a `GENERATE_TEXT` / `GENERATE_STRUCTURED`
|
|
355
|
+
agent — silently does nothing (catch with the **no tools on a one-shot agent** grep).
|
|
356
|
+
- `result.output` passed straight into business logic without unwrapping
|
|
357
|
+
`object` / `text` / `message` (catch with the **output is unwrapped** grep).
|
|
358
|
+
- A `GENERATE_STRUCTURED` agent whose callers never pass `input.schema` — a
|
|
359
|
+
validation error at call time, not a text fallback (catch with the **every
|
|
360
|
+
structured agent's callers pass a schema** grep).
|
|
361
|
+
- `config.operationKey` and `operationDefinition.operationKey` drifting apart
|
|
362
|
+
(catch with the **operation key agrees** grep).
|
|
363
|
+
- An agent defined but missing from `flowsActors.agents` — resolves to a throw
|
|
364
|
+
the first time it is invoked (catch with the **agent is registered** grep).
|
|
365
|
+
- Per-call text baked into `promptSpec.role` / `instructions` — a sign the
|
|
366
|
+
invocation/definition split was collapsed.
|
|
367
|
+
|
|
368
|
+
## Related Skills
|
|
369
|
+
|
|
370
|
+
- `flows-actors-chat-assistant` — the conversational sibling: multi-turn, streamed,
|
|
371
|
+
tool-grounded, surfaced as a view. Function tools work there.
|
|
372
|
+
- `flows-actors-a2a-exposure` — exposing an agentic actor system to external agents.
|
|
373
|
+
- `backend-addon-wiring` — assembling the module's `flowsActors` contribution and
|
|
374
|
+
DI-binding the service that calls the agent.
|
|
375
|
+
- `backend-custom-operation` — invoking an agent from a resource-operation hook.
|
|
376
|
+
- `config-saas` — enabling the provider that fulfills the `AI_LLM` capability.
|
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
# Agent definition — source contracts
|
|
2
|
+
|
|
3
|
+
Read this at Step 3 (author the agent). It surfaces:
|
|
4
|
+
|
|
5
|
+
- `FlowsActors_Agent` — the whole authoring surface for "give my app an LLM
|
|
6
|
+
capability". Identity (`ref`, `displayName`, `status`), execution (`config`,
|
|
7
|
+
`operationDefinition`), prompt (`promptSpec`), and optional `capabilities`.
|
|
8
|
+
`ref` is what callers name in an invocation; `operationDefinition` restates the
|
|
9
|
+
operation's I/O schemas and must agree with `config.operationKey`.
|
|
10
|
+
- `FlowsActors_Agent_Status` — only `ACTIVE` agents are invocable. This is the
|
|
11
|
+
switch for retiring an agent without deleting the definition or breaking the
|
|
12
|
+
refs that still name it.
|
|
13
|
+
- `FlowsActors_Agent_Configuration` — the config union, discriminated by
|
|
14
|
+
`operationKey` along the artifact MODALITY axis (LLM/text vs image). The LLM arm
|
|
15
|
+
adds `operationKey` + optional `seed` on top of the provider/model
|
|
16
|
+
configuration; the image arm carries image parameters instead and has no
|
|
17
|
+
reasoning axis at all. Narrow with `isImageAgentConfiguration` before reading
|
|
18
|
+
arm-specific fields.
|
|
19
|
+
- `accessControl` + `riskLevel` are required on the config (inherited from the
|
|
20
|
+
shared leaf-element configuration) — they declare the scope the agent runs
|
|
21
|
+
under and its risk classification, not a per-call permission check.
|
|
22
|
+
|
|
23
|
+
All import from `@wildo-ai/saas-models`.
|
|
24
|
+
|
|
25
|
+
## Import Origins
|
|
26
|
+
|
|
27
|
+
- `@wildo-ai/saas-models`
|
|
28
|
+
|
|
29
|
+
## Source Excerpts
|
|
30
|
+
|
|
31
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
32
|
+
|
|
33
|
+
```typescript
|
|
34
|
+
*
|
|
35
|
+
* Agent lifecycle status. Only `ACTIVE` agents are invocable — invoking an
|
|
36
|
+
* `INACTIVE` / `DEPRECATED` agent is refused at the call, not at registration,
|
|
37
|
+
* so this is the switch for retiring an agent without deleting its definition
|
|
38
|
+
* (and without breaking the refs that still name it).
|
|
39
|
+
*/
|
|
40
|
+
export enum FlowsActors_Agent_Status {
|
|
41
|
+
ACTIVE = "active",
|
|
42
|
+
INACTIVE = "inactive",
|
|
43
|
+
DEPRECATED = "deprecated",
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
48
|
+
|
|
49
|
+
```typescript
|
|
50
|
+
*
|
|
51
|
+
* A callable AI unit. This is the whole authoring surface for "give my app an
|
|
52
|
+
* LLM capability": author one of these, register it on your backend module's
|
|
53
|
+
* `flowsActors.agents`, then invoke it by `ref`.
|
|
54
|
+
*
|
|
55
|
+
* The definition is DECLARATIVE and durable — provider, model, operation, and
|
|
56
|
+
* prompt live here; the per-call task lives in the invocation. Nothing about
|
|
57
|
+
* transport, retries, rate limiting, usage accounting, or tracing is yours to
|
|
58
|
+
* write: the engine owns all of it once the agent is registered.
|
|
59
|
+
*
|
|
60
|
+
* Import path: `@wildo-ai/saas-models`.
|
|
61
|
+
*/
|
|
62
|
+
export type FlowsActors_Agent = {
|
|
63
|
+
//====================
|
|
64
|
+
// IDENTITY
|
|
65
|
+
//====================
|
|
66
|
+
|
|
67
|
+
/** Unique agent reference for flow/actor calls */
|
|
68
|
+
ref: string,
|
|
69
|
+
|
|
70
|
+
/** Human-readable display name */
|
|
71
|
+
displayName: string,
|
|
72
|
+
|
|
73
|
+
/** Agent lifecycle status */
|
|
74
|
+
status: FlowsActors_Agent_Status,
|
|
75
|
+
|
|
76
|
+
//====================
|
|
77
|
+
// EXECUTION CONFIGURATION (modality-discriminated)
|
|
78
|
+
//====================
|
|
79
|
+
|
|
80
|
+
/** Provider/model config, discriminated by modality (LLM/text | image | coding). */
|
|
81
|
+
config: FlowsActors_Agent_Configuration,
|
|
82
|
+
|
|
83
|
+
/** Operation definition (input/output schemas, etc.), per transport family. */
|
|
84
|
+
operationDefinition: LLMProvider_OperationDefinitionBase | ImageProvider_OperationDefinitionBase | CodingAgent_OperationDefinitionBase,
|
|
85
|
+
|
|
86
|
+
//====================
|
|
87
|
+
// ARTIFACT MODALITY (optional — explicit override; else derived from config)
|
|
88
|
+
//====================
|
|
89
|
+
|
|
90
|
+
/**
|
|
91
|
+
* The modality this agent PRODUCES. Optional: when omitted the executor
|
|
92
|
+
* derives it from `config` (LLM keys → TEXT/STRUCTURED, image key → IMAGE).
|
|
93
|
+
* Set explicitly to make a multimodal agent's output self-describing.
|
|
94
|
+
*/
|
|
95
|
+
outputModality?: FlowsActors_IO_PartKind,
|
|
96
|
+
|
|
97
|
+
/** The modalities this agent CONSUMES (e.g. `[TEXT]` for text-to-image). */
|
|
98
|
+
inputModalities?: FlowsActors_IO_PartKind[],
|
|
99
|
+
|
|
100
|
+
//====================
|
|
101
|
+
// PROMPT SPECIFICATION (required)
|
|
102
|
+
//====================
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* Complete prompt specification
|
|
106
|
+
* Defines role, persona, constraints, instructions, output format, etc.
|
|
107
|
+
*/
|
|
108
|
+
promptSpec: FlowsActors_Agent_PromptSpec,
|
|
109
|
+
|
|
110
|
+
//====================
|
|
111
|
+
// CAPABILITIES
|
|
112
|
+
//====================
|
|
113
|
+
|
|
114
|
+
/** Agent capabilities (tools, etc.) */
|
|
115
|
+
capabilities?: {
|
|
116
|
+
tools?: {
|
|
117
|
+
/** References to callable functions */
|
|
118
|
+
functionRefs: string[],
|
|
119
|
+
/** References to MCP servers */
|
|
120
|
+
mcpRefs: string[],
|
|
121
|
+
},
|
|
122
|
+
},
|
|
123
|
+
|
|
124
|
+
//====================
|
|
125
|
+
// VERSIONING
|
|
126
|
+
//====================
|
|
127
|
+
|
|
128
|
+
/** Agent definition version */
|
|
129
|
+
version?: string,
|
|
130
|
+
|
|
131
|
+
/** Creation timestamp (ISO 8601) */
|
|
132
|
+
createdAt: string,
|
|
133
|
+
|
|
134
|
+
/** Last update timestamp (ISO 8601) */
|
|
135
|
+
updatedAt?: string,
|
|
136
|
+
};
|
|
137
|
+
```
|
|
138
|
+
## Import Origins
|
|
139
|
+
|
|
140
|
+
- `@wildo-ai/saas-models`
|
|
141
|
+
|
|
142
|
+
## Source Excerpts
|
|
143
|
+
|
|
144
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
145
|
+
|
|
146
|
+
```typescript
|
|
147
|
+
*
|
|
148
|
+
* Agent execution settings that stay stable across transport changes.
|
|
149
|
+
*
|
|
150
|
+
* `providerRef` and `model` still come from the semantic LLM configuration,
|
|
151
|
+
* while `executionProfileRef` selects one transport/runtime profile under the
|
|
152
|
+
* provider's `AGENT_CLIENT_PROTOCOL` transport when execution should not use the default
|
|
153
|
+
* API-backed path.
|
|
154
|
+
*/
|
|
155
|
+
export type FlowsActors_Agent_ExecutionConfiguration = LLMProvider_OperationModelConfiguration & {
|
|
156
|
+
executionProfileRef?: string;
|
|
157
|
+
/** Refuse provider fan-out when one budget reservation authorizes exactly one physical model call. */
|
|
158
|
+
structuredGenerationExecutionMode?: StructuredGenerationExecutionMode;
|
|
159
|
+
/**
|
|
160
|
+
* Immutable schema-shape ceiling used by both pre-admission planning and the physical structured-output executor.
|
|
161
|
+
* SINGLE_CALL_REQUIRED agents must declare this value so a provider configuration override cannot silently change
|
|
162
|
+
* the number of calls after one budget reservation has been admitted.
|
|
163
|
+
*/
|
|
164
|
+
maximumStructuredOutputLeafFields?: number;
|
|
165
|
+
};
|
|
166
|
+
|
|
167
|
+
export enum StructuredGenerationExecutionMode {
|
|
168
|
+
CHUNKING_ALLOWED = 'CHUNKING_ALLOWED',
|
|
169
|
+
SINGLE_CALL_REQUIRED = 'SINGLE_CALL_REQUIRED',
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* The LLM/text execution arm of an agent config — the original shape,
|
|
174
|
+
* unchanged. Its `operationKey` is an `LLMProvider_OperationKey`, which is
|
|
175
|
+
* what discriminates this arm from the image arm below (the two operation-key
|
|
176
|
+
* enums are disjoint, so TypeScript narrows the union by `operationKey`).
|
|
177
|
+
* Produces the TEXT / STRUCTURED modality; the executor routes it to
|
|
178
|
+
* `LLM_PROVIDER`.
|
|
179
|
+
*/
|
|
180
|
+
export type FlowsActors_Agent_LLMConfiguration = FlowsActors_LeafElements_Configuration & FlowsActors_Agent_ExecutionConfiguration & {
|
|
181
|
+
operationKey: LLMProvider_OperationKey,
|
|
182
|
+
seed?: number, // Random seed for deterministic output
|
|
183
|
+
};
|
|
184
|
+
|
|
185
|
+
/**
|
|
186
|
+
* The IMAGE execution arm of an agent config. Carries image-generation
|
|
187
|
+
* parameters (`size` / `quality` / `background` / …) instead of LLM sampling,
|
|
188
|
+
* and an `ImageProvider_OperationKey`. Produces the IMAGE modality; the
|
|
189
|
+
* executor routes it to `IMAGE_PROVIDER`. (AUDIO / VIDEO arms are reserved —
|
|
190
|
+
* their config types land when those transports are wired.)
|
|
191
|
+
*/
|
|
192
|
+
export type FlowsActors_Agent_ImageConfiguration = FlowsActors_LeafElements_Configuration & ImageProvider_OperationModelConfiguration & {
|
|
193
|
+
operationKey: ImageProvider_OperationKey,
|
|
194
|
+
executionProfileRef?: string,
|
|
195
|
+
};
|
|
196
|
+
|
|
197
|
+
/**
|
|
198
|
+
* The CODING execution arm of an agent config. Carries a workspace-mutating
|
|
199
|
+
* agent reached over the Agent Client Protocol, and a `CodingAgent_OperationKey`.
|
|
200
|
+
* Produces no artifact modality at all — its product is a CHANGED WORKSPACE,
|
|
201
|
+
* which is why it sits on this axis rather than beside TEXT and IMAGE as
|
|
202
|
+
* another thing to generate.
|
|
203
|
+
*
|
|
204
|
+
* `executionProfileRef` is REQUIRED here, unlike every other arm. A coding
|
|
205
|
+
* agent cannot fall back to a default API-backed path: there is no such path,
|
|
206
|
+
* and the profile is where the environment gate, the permission ceiling and the
|
|
207
|
+
* host-configuration posture live. An agent that could omit it would be an
|
|
208
|
+
* agent whose authority was unstated.
|
|
209
|
+
*/
|
|
210
|
+
export type FlowsActors_Agent_CodingConfiguration = FlowsActors_LeafElements_Configuration & CodingAgent_OperationModelConfiguration & {
|
|
211
|
+
operationKey: CodingAgent_OperationKey,
|
|
212
|
+
executionProfileRef: string,
|
|
213
|
+
};
|
|
214
|
+
|
|
215
|
+
/**
|
|
216
|
+
* Agent execution config, discriminated by `operationKey` along the artifact
|
|
217
|
+
* MODALITY axis. One agent concept; the arm selects the transport family.
|
|
218
|
+
* Narrow with {@link isImageAgentConfiguration} or
|
|
219
|
+
* {@link isCodingAgentConfiguration} before reading arm-specific fields.
|
|
220
|
+
*/
|
|
221
|
+
export type FlowsActors_Agent_Configuration =
|
|
222
|
+
| FlowsActors_Agent_LLMConfiguration
|
|
223
|
+
| FlowsActors_Agent_ImageConfiguration
|
|
224
|
+
| FlowsActors_Agent_CodingConfiguration;
|
|
225
|
+
|
|
226
|
+
/**
|
|
227
|
+
* Narrows an agent config to its IMAGE arm. The two `operationKey` enums are
|
|
228
|
+
* disjoint, so membership in `ImageProvider_OperationKey` is a sound
|
|
229
|
+
* discriminant.
|
|
230
|
+
*/
|
|
231
|
+
export function isImageAgentConfiguration(
|
|
232
|
+
config: FlowsActors_Agent_Configuration,
|
|
233
|
+
): config is FlowsActors_Agent_ImageConfiguration {
|
|
234
|
+
return Object.values(ImageProvider_OperationKey).includes(config.operationKey as ImageProvider_OperationKey);
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
/**
|
|
238
|
+
* Narrows an agent config to its LLM/text arm.
|
|
239
|
+
*
|
|
240
|
+
* Exists so consumers can narrow POSITIVELY. Writing `!isImageAgentConfiguration(config)`
|
|
241
|
+
* to mean "this is the LLM arm" was correct only while the union had exactly two
|
|
242
|
+
* members: the moment a third arm landed, that negation silently widened to
|
|
243
|
+
* include it and the compiler reported a missing property somewhere else
|
|
244
|
+
* entirely. A positive guard cannot absorb a future arm by accident.
|
|
245
|
+
*/
|
|
246
|
+
export function isLLMAgentConfiguration(
|
|
247
|
+
config: FlowsActors_Agent_Configuration,
|
|
248
|
+
): config is FlowsActors_Agent_LLMConfiguration {
|
|
249
|
+
return Object.values(LLMProvider_OperationKey).includes(config.operationKey as LLMProvider_OperationKey);
|
|
250
|
+
}
|
|
251
|
+
|
|
252
|
+
/**
|
|
253
|
+
* Narrows an agent config to its CODING arm. The operation-key enums are
|
|
254
|
+
* pairwise disjoint, so membership in `CodingAgent_OperationKey` is a sound
|
|
255
|
+
* discriminant — the same argument the image guard rests on.
|
|
256
|
+
*/
|
|
257
|
+
export function isCodingAgentConfiguration(
|
|
258
|
+
config: FlowsActors_Agent_Configuration,
|
|
259
|
+
): config is FlowsActors_Agent_CodingConfiguration {
|
|
260
|
+
return Object.values(CodingAgent_OperationKey).includes(config.operationKey as CodingAgent_OperationKey);
|
|
261
|
+
}
|
|
262
|
+
```
|