@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,368 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: flows-actors-chat-assistant
|
|
3
|
+
description: Add a conversational AI assistant to your app that answers questions grounded in your users' own resource data. Use when the user says "add a chat assistant", "add an AI assistant grounded on <resource>", "let users chat with / ask questions about their <resource>", "wire a resourceReadTool", "add a flows-actors chat agent", or "expose an actor system as a chat view" — i.e. when the intent is a conversational, tool-grounded assistant surfaced as a standalone view, NOT a one-shot generation agent or a background flow.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Flows-Actors Chat Assistant — Workflow
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
A chat assistant is authored as three small pieces on top of the engine's
|
|
23
|
+
flows-actors runtime (which owns the WebSocket channel, token streaming, tool
|
|
24
|
+
execution, persisted history, and the view host — you author none of that):
|
|
25
|
+
|
|
26
|
+
1. a **CHAT agent** (`FlowsActors_Agent`) — the LLM persona;
|
|
27
|
+
2. an **ActorSystem** (`kind: ACTOR`, `visibility: FRONTEND`) whose agentic actor
|
|
28
|
+
binds that agent; and
|
|
29
|
+
3. **grounding tools** — one `resourceReadTool(resourceType)` per resource the
|
|
30
|
+
agent may read, registered on the module's `flowsActors.functionTools`.
|
|
31
|
+
|
|
32
|
+
Then a **frontend view** (`flowsActorsViews`) + a **launcher** expose it at
|
|
33
|
+
`/flows-actors/:ref`. The engine reads the resource **as the user** (the agent
|
|
34
|
+
never sees or supplies identity), streams the answer token-by-token, and persists
|
|
35
|
+
the conversation.
|
|
36
|
+
|
|
37
|
+
## App Paths
|
|
38
|
+
|
|
39
|
+
| Surface | Glob (relative to app root) |
|
|
40
|
+
|---|---|
|
|
41
|
+
| Flows-actors backend contribution (agent + system + tools) | `backend-api/src/modules/<module>/addons/flows-actors/*.ts` |
|
|
42
|
+
| Backend module assembly (`flowsActors: …`) | `backend-api/src/modules/<module>/index.ts` |
|
|
43
|
+
| Resource type enum (for `resourceReadTool`) | `shared-lib/src/modules/<module>/resources/*.resources-types.ts` |
|
|
44
|
+
| Frontend view definition (`flowsActorsViews`) | `frontend/src/modules/<module>/app-level-views/*.definitions.module.frontend.ts` |
|
|
45
|
+
| Sidebar / command launcher | `frontend/src/modules/<module>/app-shell.module.frontend.ts` |
|
|
46
|
+
|
|
47
|
+
## When to Use
|
|
48
|
+
|
|
49
|
+
- The user wants an in-app assistant that **answers about their own data**
|
|
50
|
+
(todos, orders, tickets…), grounded via tool lookups, surfaced as a chat page.
|
|
51
|
+
|
|
52
|
+
## When NOT to Use
|
|
53
|
+
|
|
54
|
+
- **One-shot text/structured generation** (no back-and-forth, no view) → use
|
|
55
|
+
`flows-actors-llm-agent-invocation`: a plain `FlowsActors_Agent` invoked by your
|
|
56
|
+
own service, not an ActorSystem. (Function tools do not execute on that path.)
|
|
57
|
+
- **A triggered multi-step pipeline** (trigger → steps → finish) → that is a
|
|
58
|
+
FlowSystem, not a conversational ActorSystem (a near-term capability).
|
|
59
|
+
- **Embedding an execution surface for a resource operation** → use
|
|
60
|
+
`views-execution-authoring`.
|
|
61
|
+
|
|
62
|
+
## Workflow
|
|
63
|
+
|
|
64
|
+
### Step 1: Author the CHAT agent
|
|
65
|
+
File: `backend-api/src/modules/<module>/addons/flows-actors/index.ts`.
|
|
66
|
+
Author a `FlowsActors_Agent` with `config.operationKey: LLMProvider_OperationKey.CHAT_COMPLETION`,
|
|
67
|
+
a registered `providerRef` + `model` (e.g. anthropic + `LLM_Model.CLAUDE_SONNET_4_5`),
|
|
68
|
+
`promptSpec.skillType: FlowsActors_Agent_Skill_Type.CHAT`, and
|
|
69
|
+
`capabilities.tools.functionRefs` listing the tool ids it may call (see Step 3 —
|
|
70
|
+
the ref is `resource.<resourceType>.read`). `mcpRefs: []` is required alongside.
|
|
71
|
+
|
|
72
|
+
### Step 2: Author the ActorSystem
|
|
73
|
+
Same file. Author an `ActorSystem` (`kind: FlowActorSystem_Kind.ACTOR`,
|
|
74
|
+
`status: ACTIVE`, **`visibility: FlowActorSystem_Visibility.FRONTEND`** so the view
|
|
75
|
+
can list it) with one `actor` (`executionMode: Actor_ExecutionMode.AGENTIC`,
|
|
76
|
+
`agentRef: <your agent ref>`). Its minimal `config` needs only `accessControl[]`
|
|
77
|
+
+ `riskLevel`. Register it under `flowActorSystemsFactoryMap[<systemRef>] = () => system`.
|
|
78
|
+
|
|
79
|
+
### Step 3: Instantiate the grounding tools
|
|
80
|
+
Same file. For each resource the agent should read, add
|
|
81
|
+
`resourceReadTool(<ResourceType>)` to `flowsActors.functionTools`. Its
|
|
82
|
+
`functionRef` is `resource.<resourceType>.read` — it **must equal** an entry in
|
|
83
|
+
the agent's `capabilities.tools.functionRefs` (Step 1). The tool reads scoped to
|
|
84
|
+
the user with the user's own visibility; you write no query logic. See
|
|
85
|
+
`references/framework-flows-actors-tool-api.md`.
|
|
86
|
+
|
|
87
|
+
To let the assistant also **act** (create / update a record on the user's behalf,
|
|
88
|
+
not just answer questions), add a `resourceWriteTool(<ResourceType>, op, { inputSchema })`
|
|
89
|
+
alongside the read tools (`op` = `CoreResourceOperation.CREATE` | `.UPDATE`;
|
|
90
|
+
`functionRef` = `resource.<resourceType>.<op>`, mirror it into `functionRefs`).
|
|
91
|
+
Supply the model-facing `inputSchema` (the fields the model may set — never owner
|
|
92
|
+
FKs or server-set fields; include `id` for updates). Writes run as the user under
|
|
93
|
+
the resource's own create/update ACL (fail-closed), same as reads. Keep write tools
|
|
94
|
+
grounded and non-destructive in the prompt (no silent bulk mutations). Same
|
|
95
|
+
reference file.
|
|
96
|
+
|
|
97
|
+
### Step 4: Register the frontend view + launcher
|
|
98
|
+
Add a `FlowsActorsViewDefinition` to the module's `flowsActorsViews` with
|
|
99
|
+
`isAddressable: true`, `systemRefs: ['<systemRef>']`, and a `layoutPreset`
|
|
100
|
+
(`'graph-primary'` | `'chat-primary'` | `'Default'`). Add a
|
|
101
|
+
`LauncherItemTargetKind.VIEW` sidebar item with `viewRef: '<view ref>'`. See
|
|
102
|
+
`references/framework-flows-actors-view-api.md`.
|
|
103
|
+
|
|
104
|
+
### Step 5: Verify the wiring
|
|
105
|
+
Run the Grep invariants below. Keep the three registry truths aligned: the
|
|
106
|
+
resource type lives in `shared-lib`, the agent/system/tools in `backend-api`, the
|
|
107
|
+
view/launcher in `app`.
|
|
108
|
+
|
|
109
|
+
## Worked Example
|
|
110
|
+
|
|
111
|
+
The complete backend authoring (agent + FRONTEND-visible actor system + two
|
|
112
|
+
`resourceReadTool` instances, all registered on the module's `flowsActors`
|
|
113
|
+
contribution) — note how the agent's `functionRefs` mirror the tool
|
|
114
|
+
`functionRef`s exactly:
|
|
115
|
+
|
|
116
|
+
|
|
117
|
+
## Usage Example
|
|
118
|
+
|
|
119
|
+
```typescript
|
|
120
|
+
const TODO_ASSISTANT_CHAT_AGENT_REF = 'todo-assistant.chat.agent' as const;
|
|
121
|
+
const TODO_ASSISTANT_SYSTEM_REF = 'todo-assistant' as const;
|
|
122
|
+
|
|
123
|
+
/** Function refs the assistant may call (must match the registered `functionTools`). */
|
|
124
|
+
const TODOS_READ_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.read`;
|
|
125
|
+
const TODO_LISTS_READ_TOOL_REF = `resource.${TasksManager_ResourceType.TODO_LISTS}.read`;
|
|
126
|
+
// The WRITE ref — built the same way the `resourceWriteTool` factory derives its
|
|
127
|
+
// default functionRef (`resource.<type>.<op>`), so the agent's declared ref and the
|
|
128
|
+
// tool's ref cannot drift. Resolves to `resource.todos.create`.
|
|
129
|
+
const TODOS_CREATE_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.${CoreResourceOperation.CREATE}`;
|
|
130
|
+
/**
|
|
131
|
+
* The APPROVAL-GATED write ref. UPDATE is gated where CREATE is not, and the asymmetry is the
|
|
132
|
+
* point: creating a todo is additive and trivially undone, whereas editing one MUTATES something
|
|
133
|
+
* the user already relies on — overwriting a title or status is the change they would want to be
|
|
134
|
+
* asked about. Gating every write instead would train the user to approve reflexively, which is
|
|
135
|
+
* how an approval prompt stops being read at all.
|
|
136
|
+
*/
|
|
137
|
+
const TODOS_UPDATE_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.${CoreResourceOperation.UPDATE}`;
|
|
138
|
+
|
|
139
|
+
/** The conversational chat agent behind the assistant actor. */
|
|
140
|
+
const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
141
|
+
ref: TODO_ASSISTANT_CHAT_AGENT_REF,
|
|
142
|
+
displayName: 'Todo Assistant',
|
|
143
|
+
status: FlowsActors_Agent_Status.ACTIVE,
|
|
144
|
+
config: {
|
|
145
|
+
providerRef: 'anthropic',
|
|
146
|
+
model: LLM_Model.CLAUDE_SONNET_5,
|
|
147
|
+
operationKey: LLMProvider_OperationKey.CHAT_COMPLETION,
|
|
148
|
+
// No sampling params: the whole Claude 5 family (sonnet-5 AND fable-5)
|
|
149
|
+
// REJECTS explicit `temperature` ("deprecated for this model", verified
|
|
150
|
+
// live 2026-07-16) — model defaults rule.
|
|
151
|
+
accessControl: [{
|
|
152
|
+
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
153
|
+
requiresApproval: false,
|
|
154
|
+
}],
|
|
155
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
156
|
+
},
|
|
157
|
+
operationDefinition: {
|
|
158
|
+
operationKey: LLMProvider_OperationKey.CHAT_COMPLETION,
|
|
159
|
+
providerRef: 'anthropic',
|
|
160
|
+
inputSchema: LLMProvider_ChatCompletionInputSchema,
|
|
161
|
+
outputSchema: LLMProvider_ChatCompletionOutputSchema,
|
|
162
|
+
operationContextSchema: LLMProvider_OperationContext_BaseSchema,
|
|
163
|
+
} satisfies LLMProvider_OperationDefinitionBase,
|
|
164
|
+
promptSpec: {
|
|
165
|
+
role: 'You are the Todo Assistant for a personal task-management app. You answer the '
|
|
166
|
+
+ 'user\'s questions about their own todos and todo lists — what is due, what is '
|
|
167
|
+
+ 'outstanding, how work is grouped, and simple summaries or counts — and you CREATE '
|
|
168
|
+
+ 'a new todo for the user when they explicitly ask you to.',
|
|
169
|
+
persona: 'You are concise, practical, and grounded. You NEVER invent todos: when a question '
|
|
170
|
+
+ 'needs the user\'s data, call the read tools to look it up, then answer from what you '
|
|
171
|
+
+ 'find. If the tools return nothing relevant, say so plainly rather than guessing. You '
|
|
172
|
+
+ 'only ever discuss the current user\'s own items. You create a todo ONLY when the user '
|
|
173
|
+
+ 'explicitly asks — never speculatively and never in bulk — and you confirm the created '
|
|
174
|
+
+ 'todo\'s title back to them.',
|
|
175
|
+
skillType: FlowsActors_Agent_Skill_Type.CHAT,
|
|
176
|
+
instructions: [
|
|
177
|
+
'Answer ONLY the user\'s current question, concisely. Do NOT restate or re-list information you already gave earlier in the conversation.',
|
|
178
|
+
'Call tools SILENTLY: never narrate your process (no "Let me check…", no announcing that you are using a tool). Return only the final answer.',
|
|
179
|
+
'When the user asks about ONE specific item, answer about that item only — do not re-list every todo.',
|
|
180
|
+
'Use resource.todos.read to look up the user\'s todos (pass a searchQuery when a topic is named); use resource.todoLists.read for lists/grouping. Reference concrete item titles.',
|
|
181
|
+
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first, then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
182
|
+
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted. If it returns no sources, say the knowledge base has nothing on it rather than answering from general knowledge.',
|
|
183
|
+
'To CREATE a todo (only when explicitly asked), you MUST supply a todoListId: if the user names a list, resolve its id with resource.todoLists.read first; if they name none and have exactly one list, use it; if they have several and none is specified, ask which one. Then call resource.todos.create with the title (plus any description/priority/status/dueDate the user gave) and confirm the created title.',
|
|
184
|
+
],
|
|
185
|
+
},
|
|
186
|
+
capabilities: {
|
|
187
|
+
tools: {
|
|
188
|
+
functionRefs: [
|
|
189
|
+
TODOS_READ_TOOL_REF,
|
|
190
|
+
TODO_LISTS_READ_TOOL_REF,
|
|
191
|
+
TODOS_CREATE_TOOL_REF,
|
|
192
|
+
TODOS_UPDATE_TOOL_REF,
|
|
193
|
+
// RETRIEVAL grounding — a different KIND of source from the three above. Those return ROWS
|
|
194
|
+
// matched by a column; this returns PASSAGES matched by wording (and, with an embeddings
|
|
195
|
+
// provider, by meaning) out of the organization's reference documents, including the text of
|
|
196
|
+
// uploaded files that no row query can reach.
|
|
197
|
+
KNOWLEDGE_BASE_ASK_TOOL_REF,
|
|
198
|
+
],
|
|
199
|
+
mcpRefs: [],
|
|
200
|
+
},
|
|
201
|
+
},
|
|
202
|
+
createdAt: '2026-07-12T00:00:00.000Z',
|
|
203
|
+
};
|
|
204
|
+
|
|
205
|
+
/** The "Todo Assistant" actor system exposed to the frontend flows-actors view. */
|
|
206
|
+
const todoAssistantActorSystem: ActorSystem = {
|
|
207
|
+
ref: TODO_ASSISTANT_SYSTEM_REF,
|
|
208
|
+
displayName: 'Todo Assistant',
|
|
209
|
+
description: 'Ask questions about your todos and lists — grounded in your own data.',
|
|
210
|
+
kind: FlowActorSystem_Kind.ACTOR,
|
|
211
|
+
status: FlowActorSystem_Status.ACTIVE,
|
|
212
|
+
// FRONTEND so the flows-actors view can list + start conversations with it.
|
|
213
|
+
visibility: FlowActorSystem_Visibility.FRONTEND,
|
|
214
|
+
config: {
|
|
215
|
+
timeout: 60000,
|
|
216
|
+
accessControl: [{
|
|
217
|
+
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
218
|
+
requiresApproval: false,
|
|
219
|
+
}],
|
|
220
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
221
|
+
},
|
|
222
|
+
actors: [{
|
|
223
|
+
ref: 'assistant',
|
|
224
|
+
displayName: 'Assistant',
|
|
225
|
+
roleCategory: Actor_Role_Category.OPERATOR,
|
|
226
|
+
executionMode: Actor_ExecutionMode.AGENTIC,
|
|
227
|
+
agentRef: TODO_ASSISTANT_CHAT_AGENT_REF,
|
|
228
|
+
}],
|
|
229
|
+
createdAt: '2026-07-12T00:00:00.000Z',
|
|
230
|
+
};
|
|
231
|
+
|
|
232
|
+
// Export with consistent naming convention matching resources registry pattern
|
|
233
|
+
export const moduleBackend_FlowsActorsRegistry: {
|
|
234
|
+
flowActorSystemsFactoryMap: FlowActorSystem_InitializationFactoryMap;
|
|
235
|
+
agents: FlowsActors_Agent[];
|
|
236
|
+
functionTools?: FunctionTool[];
|
|
237
|
+
} = {
|
|
238
|
+
flowActorSystemsFactoryMap: {
|
|
239
|
+
[TODO_ASSISTANT_SYSTEM_REF]: () => todoAssistantActorSystem,
|
|
240
|
+
},
|
|
241
|
+
agents: [todoAssistantChatAgent],
|
|
242
|
+
// Generic engine factories instantiated per resource — every tool runs AS THE
|
|
243
|
+
// CALLER (the engine rebuilds a scoped ExecutionContext from the caller's verified
|
|
244
|
+
// auth; identity is never LLM-supplied) and each op's own ACL is enforced by the
|
|
245
|
+
// service tier, so there is no privilege escalation through a tool.
|
|
246
|
+
functionTools: [
|
|
247
|
+
// READS — functionRef `resource.<type>.read`, matching the declared functionRefs above.
|
|
248
|
+
resourceReadTool(TasksManager_ResourceType.TODOS),
|
|
249
|
+
resourceReadTool(TasksManager_ResourceType.TODO_LISTS),
|
|
250
|
+
// WRITE — CREATE a todo as the caller (functionRef `resource.todos.create`). The todos
|
|
251
|
+
// CREATE ACL is ORG_MEMBER-gated, so a caller without the role is refused. The model-facing
|
|
252
|
+
// inputSchema is app-owned (design axis A): it exposes only the fields the model may set —
|
|
253
|
+
// owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
|
|
254
|
+
// DTO coerces the ISO `dueDate` string to a Date at the service boundary.
|
|
255
|
+
//
|
|
256
|
+
// `recurringType` IS supplied (pinned to ONE_TIME): todos is a discriminated-union inheritance
|
|
257
|
+
// resource (one-time / recurring), so its CREATE DTO REQUIRES the `recurringType` discriminator
|
|
258
|
+
// to select a variant — omitting it fails with "no matching discriminator". The assistant only
|
|
259
|
+
// creates NON-recurring todos, so we default it to ONE_TIME (the model need not supply it) and
|
|
260
|
+
// use a literal so the model cannot select the recurring variant, whose extra fields
|
|
261
|
+
// (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
|
|
262
|
+
// defaulted (not merely optional) so they are always present for the discriminated base branch.
|
|
263
|
+
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
|
|
264
|
+
inputSchema: z.object({
|
|
265
|
+
title: z.string().min(1).max(200)
|
|
266
|
+
.describe('Short title of the todo. Required.'),
|
|
267
|
+
todoListId: z.string().min(1)
|
|
268
|
+
.describe('Id of the todo list the todo belongs to. Required — resolve it with the todoLists read tool when the user names a list.'),
|
|
269
|
+
description: z.string().max(1000).optional()
|
|
270
|
+
.describe('Optional longer description / notes.'),
|
|
271
|
+
status: z.enum(Todos_Status).default(Todos_Status.PENDING)
|
|
272
|
+
.describe('Initial status. Defaults to "pending".'),
|
|
273
|
+
priority: z.enum(Todos_Priority).default(Todos_Priority.MEDIUM)
|
|
274
|
+
.describe('Priority. Defaults to "medium".'),
|
|
275
|
+
recurringType: z.literal(Todos_RecurrenceType.ONE_TIME).default(Todos_RecurrenceType.ONE_TIME)
|
|
276
|
+
.describe('Always "one_time"; the assistant creates non-recurring todos.'),
|
|
277
|
+
dueDate: z.string().optional()
|
|
278
|
+
.describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
|
|
279
|
+
}),
|
|
280
|
+
}),
|
|
281
|
+
// WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
|
|
282
|
+
// `requiresHumanApproval` suspends the turn at this tool and emits an approval request carrying
|
|
283
|
+
// the arguments; the turn resumes only on a decision, and a DENIAL resumes it too so the agent
|
|
284
|
+
// can explain rather than leaving a dead thread. The approval is an ADDITIONAL gate: the todos
|
|
285
|
+
// UPDATE ACL still applies, so approving something the caller may not do changes nothing.
|
|
286
|
+
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.UPDATE, {
|
|
287
|
+
requiresHumanApproval: true,
|
|
288
|
+
inputSchema: z.object({
|
|
289
|
+
id: z.string().min(1)
|
|
290
|
+
.describe('Id of the todo to update. Required — resolve it with the todos read tool.'),
|
|
291
|
+
title: z.string().min(1).max(200).optional()
|
|
292
|
+
.describe('New title, if the user asked to rename it.'),
|
|
293
|
+
description: z.string().max(1000).optional()
|
|
294
|
+
.describe('New description / notes.'),
|
|
295
|
+
status: z.enum(Todos_Status).optional()
|
|
296
|
+
.describe('New status.'),
|
|
297
|
+
priority: z.enum(Todos_Priority).optional()
|
|
298
|
+
.describe('New priority.'),
|
|
299
|
+
}),
|
|
300
|
+
}),
|
|
301
|
+
// RETRIEVAL — a hand-written tool rather than a factory instance, because its result is not a
|
|
302
|
+
// record set. It calls the app's own `knowledgeDocuments.ask` operation through the full
|
|
303
|
+
// pipeline (request parse → role gate → custom impl → response projection) on a context rebuilt
|
|
304
|
+
// from the caller's verified socket auth, so the agent reaches the corpus through exactly the
|
|
305
|
+
// feature an HTTP client reaches, with exactly the same roles. See `./knowledge-base-tool.ts`.
|
|
306
|
+
knowledgeBaseAskTool,
|
|
307
|
+
],
|
|
308
|
+
};
|
|
309
|
+
```
|
|
310
|
+
|
|
311
|
+
## References
|
|
312
|
+
|
|
313
|
+
- `references/framework-flows-actors-tool-api.md` — source contracts for
|
|
314
|
+
`resourceReadTool(...)`, `resourceWriteTool(...)`, and the `FunctionTool` shape
|
|
315
|
+
(grounding + action tools).
|
|
316
|
+
- `references/framework-flows-actors-view-api.md` — the `FlowsActorsViewDefinition`
|
|
317
|
+
authoring shape + the `flowsActors.functionTools` module-contribution field.
|
|
318
|
+
|
|
319
|
+
## Verification
|
|
320
|
+
|
|
321
|
+
- [ ] Every id in the agent's `capabilities.tools.functionRefs` has a matching
|
|
322
|
+
registered `functionTool` (a `resourceReadTool` produces `resource.<type>.read`).
|
|
323
|
+
- [ ] The ActorSystem sets `visibility: FRONTEND` (else the view can't list it).
|
|
324
|
+
- [ ] The actor's `agentRef` matches the authored agent's `ref`.
|
|
325
|
+
- [ ] The view's `systemRefs` includes the ActorSystem `ref`; the launcher's
|
|
326
|
+
`viewRef` matches the view `ref`.
|
|
327
|
+
- [ ] Agent `operationKey` is `CHAT_COMPLETION` and its `providerRef` is a
|
|
328
|
+
registered provider.
|
|
329
|
+
|
|
330
|
+
### Grep invariants
|
|
331
|
+
|
|
332
|
+
| Check | Command |
|
|
333
|
+
|---|---|
|
|
334
|
+
| functionRefs ↔ functionTools | `rg "functionRefs|resourceReadTool|functionRef:" backend-api/src/modules/*/addons/flows-actors` |
|
|
335
|
+
| system is frontend-visible | `rg "visibility:\s*FlowActorSystem_Visibility.FRONTEND" backend-api/src/modules` |
|
|
336
|
+
| view ↔ system ↔ launcher refs align | `rg "systemRefs|viewRef:|ref:\s*'" frontend/src/modules/*/app-level-views frontend/src/modules/*/app-shell.module.frontend.ts` |
|
|
337
|
+
|
|
338
|
+
## Common Rationalizations
|
|
339
|
+
|
|
340
|
+
| Rationalization | Reality |
|
|
341
|
+
|---|---|
|
|
342
|
+
| "I'll write a custom tool that queries the DB directly." | Use `resourceReadTool(resourceType)` — it reads *as the user* with the framework's own ACL/scope. A hand-rolled query risks leaking other users' data. |
|
|
343
|
+
| "The agent can take the userId as a tool argument." | Never. Identity comes from the authenticated socket, never the model. The tool only accepts `searchQuery`/`limit`. |
|
|
344
|
+
| "`visibility` defaults are fine." | The default is `BACKEND_ONLY`; the frontend view lists only `FRONTEND` systems. Omit it and your assistant never appears. |
|
|
345
|
+
| "I'll reference the tool ref loosely." | `capabilities.tools.functionRefs` must match a registered `functionTool.functionRef` string exactly (`resource.<type>.read`), or the model can't call it. |
|
|
346
|
+
| "Streaming/persistence/history is my job." | No — the engine owns the WS channel, token streaming, persisted conversation history, and the `FlowsActorsView` host. You author only the agent + system + tools + view. |
|
|
347
|
+
|
|
348
|
+
## Red Flags
|
|
349
|
+
|
|
350
|
+
- A tool's `execute` reads a repository directly or trusts an id from `args` →
|
|
351
|
+
use `resourceReadTool` (catch with the functionRefs grep).
|
|
352
|
+
- ActorSystem without `visibility: FRONTEND` → the view can't surface it (catch
|
|
353
|
+
with the visibility grep).
|
|
354
|
+
- An agent `functionRef` with no registered `functionTool` (or vice-versa) →
|
|
355
|
+
dangling tool (catch with the functionRefs ↔ functionTools grep).
|
|
356
|
+
- A launcher `viewRef` or view `systemRefs` that names a non-existent view/system
|
|
357
|
+
→ dead navigation (catch with the ref-alignment grep).
|
|
358
|
+
|
|
359
|
+
## Related Skills
|
|
360
|
+
|
|
361
|
+
- `flows-actors-llm-agent-invocation` — the one-shot sibling: author an agent and
|
|
362
|
+
call it yourself for text / structured output, with no conversation or view.
|
|
363
|
+
- `backend-addon-wiring` — how a module's `flowsActors` contribution is assembled
|
|
364
|
+
into the backend module.
|
|
365
|
+
- `views-execution-authoring` — embedding a resource-operation execution surface
|
|
366
|
+
(a different view family).
|
|
367
|
+
- `resource-add-field` — the resource whose data the assistant reads is authored
|
|
368
|
+
there.
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
# Worked example — the "Todo Assistant"
|
|
2
|
+
|
|
3
|
+
A complete conversational assistant that answers questions about a user's own
|
|
4
|
+
todos and lists. This is the **backend** authoring in one module addon
|
|
5
|
+
(`backend-api/src/modules/tasks-manager/addons/flows-actors/index.ts`): the CHAT
|
|
6
|
+
agent, the FRONTEND-visible ActorSystem, and two `resourceReadTool` instances —
|
|
7
|
+
all registered on the module's `flowsActors` contribution.
|
|
8
|
+
|
|
9
|
+
> The code block below is not a literal to copy verbatim — it is a real
|
|
10
|
+
> working application example, reproduced here from its live source.
|
|
11
|
+
> Read it for the shape and wiring, then author your own equivalent.
|
|
12
|
+
|
|
13
|
+
Things to notice as you read:
|
|
14
|
+
|
|
15
|
+
- The agent's `capabilities.tools.functionRefs` (`'resource.todos.read'`,
|
|
16
|
+
`'resource.todoLists.read'`) are **exactly** the `functionRef`s produced by the
|
|
17
|
+
`resourceReadTool(...)` instances below — that string match is what lets the
|
|
18
|
+
model call them.
|
|
19
|
+
- The ActorSystem sets `visibility: FRONTEND` (so the frontend view can list it)
|
|
20
|
+
and its single actor is `AGENTIC` with `agentRef` pointing at the chat agent.
|
|
21
|
+
- `functionTools` uses the generic engine factory — no query logic is authored;
|
|
22
|
+
the engine reads each resource as the user, with the user's own visibility.
|
|
23
|
+
- The agent's `operationKey` is `CHAT_COMPLETION` and its provider (`anthropic`)
|
|
24
|
+
is registered in the app's provider contributions.
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
## Usage Example
|
|
28
|
+
|
|
29
|
+
```typescript
|
|
30
|
+
const TODO_ASSISTANT_CHAT_AGENT_REF = 'todo-assistant.chat.agent' as const;
|
|
31
|
+
const TODO_ASSISTANT_SYSTEM_REF = 'todo-assistant' as const;
|
|
32
|
+
|
|
33
|
+
/** Function refs the assistant may call (must match the registered `functionTools`). */
|
|
34
|
+
const TODOS_READ_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.read`;
|
|
35
|
+
const TODO_LISTS_READ_TOOL_REF = `resource.${TasksManager_ResourceType.TODO_LISTS}.read`;
|
|
36
|
+
// The WRITE ref — built the same way the `resourceWriteTool` factory derives its
|
|
37
|
+
// default functionRef (`resource.<type>.<op>`), so the agent's declared ref and the
|
|
38
|
+
// tool's ref cannot drift. Resolves to `resource.todos.create`.
|
|
39
|
+
const TODOS_CREATE_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.${CoreResourceOperation.CREATE}`;
|
|
40
|
+
/**
|
|
41
|
+
* The APPROVAL-GATED write ref. UPDATE is gated where CREATE is not, and the asymmetry is the
|
|
42
|
+
* point: creating a todo is additive and trivially undone, whereas editing one MUTATES something
|
|
43
|
+
* the user already relies on — overwriting a title or status is the change they would want to be
|
|
44
|
+
* asked about. Gating every write instead would train the user to approve reflexively, which is
|
|
45
|
+
* how an approval prompt stops being read at all.
|
|
46
|
+
*/
|
|
47
|
+
const TODOS_UPDATE_TOOL_REF = `resource.${TasksManager_ResourceType.TODOS}.${CoreResourceOperation.UPDATE}`;
|
|
48
|
+
|
|
49
|
+
/** The conversational chat agent behind the assistant actor. */
|
|
50
|
+
const todoAssistantChatAgent: FlowsActors_Agent = {
|
|
51
|
+
ref: TODO_ASSISTANT_CHAT_AGENT_REF,
|
|
52
|
+
displayName: 'Todo Assistant',
|
|
53
|
+
status: FlowsActors_Agent_Status.ACTIVE,
|
|
54
|
+
config: {
|
|
55
|
+
providerRef: 'anthropic',
|
|
56
|
+
model: LLM_Model.CLAUDE_SONNET_5,
|
|
57
|
+
operationKey: LLMProvider_OperationKey.CHAT_COMPLETION,
|
|
58
|
+
// No sampling params: the whole Claude 5 family (sonnet-5 AND fable-5)
|
|
59
|
+
// REJECTS explicit `temperature` ("deprecated for this model", verified
|
|
60
|
+
// live 2026-07-16) — model defaults rule.
|
|
61
|
+
accessControl: [{
|
|
62
|
+
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
63
|
+
requiresApproval: false,
|
|
64
|
+
}],
|
|
65
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
66
|
+
},
|
|
67
|
+
operationDefinition: {
|
|
68
|
+
operationKey: LLMProvider_OperationKey.CHAT_COMPLETION,
|
|
69
|
+
providerRef: 'anthropic',
|
|
70
|
+
inputSchema: LLMProvider_ChatCompletionInputSchema,
|
|
71
|
+
outputSchema: LLMProvider_ChatCompletionOutputSchema,
|
|
72
|
+
operationContextSchema: LLMProvider_OperationContext_BaseSchema,
|
|
73
|
+
} satisfies LLMProvider_OperationDefinitionBase,
|
|
74
|
+
promptSpec: {
|
|
75
|
+
role: 'You are the Todo Assistant for a personal task-management app. You answer the '
|
|
76
|
+
+ 'user\'s questions about their own todos and todo lists — what is due, what is '
|
|
77
|
+
+ 'outstanding, how work is grouped, and simple summaries or counts — and you CREATE '
|
|
78
|
+
+ 'a new todo for the user when they explicitly ask you to.',
|
|
79
|
+
persona: 'You are concise, practical, and grounded. You NEVER invent todos: when a question '
|
|
80
|
+
+ 'needs the user\'s data, call the read tools to look it up, then answer from what you '
|
|
81
|
+
+ 'find. If the tools return nothing relevant, say so plainly rather than guessing. You '
|
|
82
|
+
+ 'only ever discuss the current user\'s own items. You create a todo ONLY when the user '
|
|
83
|
+
+ 'explicitly asks — never speculatively and never in bulk — and you confirm the created '
|
|
84
|
+
+ 'todo\'s title back to them.',
|
|
85
|
+
skillType: FlowsActors_Agent_Skill_Type.CHAT,
|
|
86
|
+
instructions: [
|
|
87
|
+
'Answer ONLY the user\'s current question, concisely. Do NOT restate or re-list information you already gave earlier in the conversation.',
|
|
88
|
+
'Call tools SILENTLY: never narrate your process (no "Let me check…", no announcing that you are using a tool). Return only the final answer.',
|
|
89
|
+
'When the user asks about ONE specific item, answer about that item only — do not re-list every todo.',
|
|
90
|
+
'Use resource.todos.read to look up the user\'s todos (pass a searchQuery when a topic is named); use resource.todoLists.read for lists/grouping. Reference concrete item titles.',
|
|
91
|
+
'To UPDATE an existing todo (only when explicitly asked), resolve its id with resource.todos.read first, then call resource.todos.update with that id and only the fields to change. This tool requires the user to approve the change before it is applied — call it and report what you are waiting on; do not ask for confirmation in prose first, the approval is the confirmation.',
|
|
92
|
+
'For questions about POLICY, PROCEDURE or REFERENCE MATERIAL ("what does our policy say about…", "how are we supposed to…"), call resource.knowledgeDocuments.ask — it searches the organization\'s reference documents and their uploaded files and returns quotable passages. Answer from those passages and name the document you quoted. If it returns no sources, say the knowledge base has nothing on it rather than answering from general knowledge.',
|
|
93
|
+
'To CREATE a todo (only when explicitly asked), you MUST supply a todoListId: if the user names a list, resolve its id with resource.todoLists.read first; if they name none and have exactly one list, use it; if they have several and none is specified, ask which one. Then call resource.todos.create with the title (plus any description/priority/status/dueDate the user gave) and confirm the created title.',
|
|
94
|
+
],
|
|
95
|
+
},
|
|
96
|
+
capabilities: {
|
|
97
|
+
tools: {
|
|
98
|
+
functionRefs: [
|
|
99
|
+
TODOS_READ_TOOL_REF,
|
|
100
|
+
TODO_LISTS_READ_TOOL_REF,
|
|
101
|
+
TODOS_CREATE_TOOL_REF,
|
|
102
|
+
TODOS_UPDATE_TOOL_REF,
|
|
103
|
+
// RETRIEVAL grounding — a different KIND of source from the three above. Those return ROWS
|
|
104
|
+
// matched by a column; this returns PASSAGES matched by wording (and, with an embeddings
|
|
105
|
+
// provider, by meaning) out of the organization's reference documents, including the text of
|
|
106
|
+
// uploaded files that no row query can reach.
|
|
107
|
+
KNOWLEDGE_BASE_ASK_TOOL_REF,
|
|
108
|
+
],
|
|
109
|
+
mcpRefs: [],
|
|
110
|
+
},
|
|
111
|
+
},
|
|
112
|
+
createdAt: '2026-07-12T00:00:00.000Z',
|
|
113
|
+
};
|
|
114
|
+
|
|
115
|
+
/** The "Todo Assistant" actor system exposed to the frontend flows-actors view. */
|
|
116
|
+
const todoAssistantActorSystem: ActorSystem = {
|
|
117
|
+
ref: TODO_ASSISTANT_SYSTEM_REF,
|
|
118
|
+
displayName: 'Todo Assistant',
|
|
119
|
+
description: 'Ask questions about your todos and lists — grounded in your own data.',
|
|
120
|
+
kind: FlowActorSystem_Kind.ACTOR,
|
|
121
|
+
status: FlowActorSystem_Status.ACTIVE,
|
|
122
|
+
// FRONTEND so the flows-actors view can list + start conversations with it.
|
|
123
|
+
visibility: FlowActorSystem_Visibility.FRONTEND,
|
|
124
|
+
config: {
|
|
125
|
+
timeout: 60000,
|
|
126
|
+
accessControl: [{
|
|
127
|
+
primaryScope: ResourcePrimaryScope.APPLICATION,
|
|
128
|
+
requiresApproval: false,
|
|
129
|
+
}],
|
|
130
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
131
|
+
},
|
|
132
|
+
actors: [{
|
|
133
|
+
ref: 'assistant',
|
|
134
|
+
displayName: 'Assistant',
|
|
135
|
+
roleCategory: Actor_Role_Category.OPERATOR,
|
|
136
|
+
executionMode: Actor_ExecutionMode.AGENTIC,
|
|
137
|
+
agentRef: TODO_ASSISTANT_CHAT_AGENT_REF,
|
|
138
|
+
}],
|
|
139
|
+
createdAt: '2026-07-12T00:00:00.000Z',
|
|
140
|
+
};
|
|
141
|
+
|
|
142
|
+
// Export with consistent naming convention matching resources registry pattern
|
|
143
|
+
export const moduleBackend_FlowsActorsRegistry: {
|
|
144
|
+
flowActorSystemsFactoryMap: FlowActorSystem_InitializationFactoryMap;
|
|
145
|
+
agents: FlowsActors_Agent[];
|
|
146
|
+
functionTools?: FunctionTool[];
|
|
147
|
+
} = {
|
|
148
|
+
flowActorSystemsFactoryMap: {
|
|
149
|
+
[TODO_ASSISTANT_SYSTEM_REF]: () => todoAssistantActorSystem,
|
|
150
|
+
},
|
|
151
|
+
agents: [todoAssistantChatAgent],
|
|
152
|
+
// Generic engine factories instantiated per resource — every tool runs AS THE
|
|
153
|
+
// CALLER (the engine rebuilds a scoped ExecutionContext from the caller's verified
|
|
154
|
+
// auth; identity is never LLM-supplied) and each op's own ACL is enforced by the
|
|
155
|
+
// service tier, so there is no privilege escalation through a tool.
|
|
156
|
+
functionTools: [
|
|
157
|
+
// READS — functionRef `resource.<type>.read`, matching the declared functionRefs above.
|
|
158
|
+
resourceReadTool(TasksManager_ResourceType.TODOS),
|
|
159
|
+
resourceReadTool(TasksManager_ResourceType.TODO_LISTS),
|
|
160
|
+
// WRITE — CREATE a todo as the caller (functionRef `resource.todos.create`). The todos
|
|
161
|
+
// CREATE ACL is ORG_MEMBER-gated, so a caller without the role is refused. The model-facing
|
|
162
|
+
// inputSchema is app-owned (design axis A): it exposes only the fields the model may set —
|
|
163
|
+
// owner FKs (organizationId / createdByUserId) are EC-injected / excludeFromCreate. The create
|
|
164
|
+
// DTO coerces the ISO `dueDate` string to a Date at the service boundary.
|
|
165
|
+
//
|
|
166
|
+
// `recurringType` IS supplied (pinned to ONE_TIME): todos is a discriminated-union inheritance
|
|
167
|
+
// resource (one-time / recurring), so its CREATE DTO REQUIRES the `recurringType` discriminator
|
|
168
|
+
// to select a variant — omitting it fails with "no matching discriminator". The assistant only
|
|
169
|
+
// creates NON-recurring todos, so we default it to ONE_TIME (the model need not supply it) and
|
|
170
|
+
// use a literal so the model cannot select the recurring variant, whose extra fields
|
|
171
|
+
// (recurrence/startDate/endsDate) are intentionally not exposed here. `status`/`priority` are
|
|
172
|
+
// defaulted (not merely optional) so they are always present for the discriminated base branch.
|
|
173
|
+
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.CREATE, {
|
|
174
|
+
inputSchema: z.object({
|
|
175
|
+
title: z.string().min(1).max(200)
|
|
176
|
+
.describe('Short title of the todo. Required.'),
|
|
177
|
+
todoListId: z.string().min(1)
|
|
178
|
+
.describe('Id of the todo list the todo belongs to. Required — resolve it with the todoLists read tool when the user names a list.'),
|
|
179
|
+
description: z.string().max(1000).optional()
|
|
180
|
+
.describe('Optional longer description / notes.'),
|
|
181
|
+
status: z.enum(Todos_Status).default(Todos_Status.PENDING)
|
|
182
|
+
.describe('Initial status. Defaults to "pending".'),
|
|
183
|
+
priority: z.enum(Todos_Priority).default(Todos_Priority.MEDIUM)
|
|
184
|
+
.describe('Priority. Defaults to "medium".'),
|
|
185
|
+
recurringType: z.literal(Todos_RecurrenceType.ONE_TIME).default(Todos_RecurrenceType.ONE_TIME)
|
|
186
|
+
.describe('Always "one_time"; the assistant creates non-recurring todos.'),
|
|
187
|
+
dueDate: z.string().optional()
|
|
188
|
+
.describe('Optional due date as an ISO 8601 datetime string, e.g. "2026-08-01T09:00:00Z".'),
|
|
189
|
+
}),
|
|
190
|
+
}),
|
|
191
|
+
// WRITE (APPROVAL-GATED) — UPDATE a todo, but only once a human has approved the specific call.
|
|
192
|
+
// `requiresHumanApproval` suspends the turn at this tool and emits an approval request carrying
|
|
193
|
+
// the arguments; the turn resumes only on a decision, and a DENIAL resumes it too so the agent
|
|
194
|
+
// can explain rather than leaving a dead thread. The approval is an ADDITIONAL gate: the todos
|
|
195
|
+
// UPDATE ACL still applies, so approving something the caller may not do changes nothing.
|
|
196
|
+
resourceWriteTool(TasksManager_ResourceType.TODOS, CoreResourceOperation.UPDATE, {
|
|
197
|
+
requiresHumanApproval: true,
|
|
198
|
+
inputSchema: z.object({
|
|
199
|
+
id: z.string().min(1)
|
|
200
|
+
.describe('Id of the todo to update. Required — resolve it with the todos read tool.'),
|
|
201
|
+
title: z.string().min(1).max(200).optional()
|
|
202
|
+
.describe('New title, if the user asked to rename it.'),
|
|
203
|
+
description: z.string().max(1000).optional()
|
|
204
|
+
.describe('New description / notes.'),
|
|
205
|
+
status: z.enum(Todos_Status).optional()
|
|
206
|
+
.describe('New status.'),
|
|
207
|
+
priority: z.enum(Todos_Priority).optional()
|
|
208
|
+
.describe('New priority.'),
|
|
209
|
+
}),
|
|
210
|
+
}),
|
|
211
|
+
// RETRIEVAL — a hand-written tool rather than a factory instance, because its result is not a
|
|
212
|
+
// record set. It calls the app's own `knowledgeDocuments.ask` operation through the full
|
|
213
|
+
// pipeline (request parse → role gate → custom impl → response projection) on a context rebuilt
|
|
214
|
+
// from the caller's verified socket auth, so the agent reaches the corpus through exactly the
|
|
215
|
+
// feature an HTTP client reaches, with exactly the same roles. See `./knowledge-base-tool.ts`.
|
|
216
|
+
knowledgeBaseAskTool,
|
|
217
|
+
],
|
|
218
|
+
};
|
|
219
|
+
```
|
|
220
|
+
|
|
221
|
+
The matching **frontend** side (authored in the app module's
|
|
222
|
+
`app-level-views` + `app-shell.module.frontend.ts`) adds one
|
|
223
|
+
`FlowsActorsViewDefinition` — `{ ref: 'todo-assistant-view', isAddressable: true,
|
|
224
|
+
systemRefs: ['todo-assistant'], layoutPreset: 'Default', … }` — and a
|
|
225
|
+
`LauncherItemTargetKind.VIEW` sidebar item with `viewRef: 'todo-assistant-view'`.
|
|
226
|
+
That surfaces the assistant at `/flows-actors/todo-assistant-view`.
|