@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +321 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5957 -1729
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -74,7 +74,7 @@ export enum MarketMessageRequiredInput {
|
|
|
74
74
|
|
|
75
75
|
export const MarketMessageTemplateConfigSchema = z.object({
|
|
76
76
|
/** Stable kebab-case ref (e.g. `'tmpl-landing-icp-hero'`). */
|
|
77
|
-
ref:
|
|
77
|
+
ref: MarketEntryRefSchema,
|
|
78
78
|
name: NonEmptyStringSchema,
|
|
79
79
|
description: NonEmptyStringSchema,
|
|
80
80
|
outputKind: z.enum(MarketMessageOutputKind).systemEnum('MarketMessageOutputKind'),
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: market-persona
|
|
3
3
|
description: Author MarketPersonas — the human roles connected to an ICP, including buying-group members with dmuRole and individual self/influencer personas. Covers inheritFrom() persona inheritance via JS object spread. Use when the user says "add a persona", "model the buying committee", "the PMO Lead persona", "personas inherit pains from the ICP", "use inheritFrom", or "split the indie maker as their own persona".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Author MarketPersona
|
|
@@ -128,7 +129,7 @@ dangling refs. See the worked example below for the full pattern.
|
|
|
128
129
|
*/
|
|
129
130
|
export const MarketPersonaConfigSchema = z.object({
|
|
130
131
|
/** Stable kebab-case ref (e.g. `'persona-pmo-lead'`). */
|
|
131
|
-
ref:
|
|
132
|
+
ref: MarketEntryRefSchema,
|
|
132
133
|
/** Display name for authoring tools and prompt blocks. */
|
|
133
134
|
name: NonEmptyStringSchema,
|
|
134
135
|
personaScope: z.enum(PersonaScope).systemEnum('PersonaScope'),
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: market-positioning-authoring
|
|
3
3
|
description: Author MarketPositioning entries — the per-ICP marketing-truth promise (Geoffrey-Moore one-sentence + elevator pitch + value pillars backed by FeatureBenefit refs). One entry per CORE/EXPANSION ICP. Use when the user says "write our positioning for X", "we need a one-liner for the small-team ICP", "value pillars for the indie maker", "Moore positioning template", "landing-page hero per ICP", "elevator pitch for our enterprise segment", or "back this pillar with our benefit X".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Author MarketPositioning (Phase 2)
|
|
@@ -195,7 +196,7 @@ export type PositioningAlternativeContrast = z.infer<typeof PositioningAlternati
|
|
|
195
196
|
|
|
196
197
|
export const MarketPositioningConfigSchema = z.object({
|
|
197
198
|
/** Stable kebab-case ref (e.g. `'positioning-icp-small-team-pmo'`). */
|
|
198
|
-
ref:
|
|
199
|
+
ref: MarketEntryRefSchema,
|
|
199
200
|
/**
|
|
200
201
|
* Target ICP. The validator checks the back-link
|
|
201
202
|
* (`MISSING_POSITIONING_FOR_ICP`) for `CORE`/`EXPANSION` ICPs.
|
package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md
CHANGED
|
@@ -73,7 +73,7 @@ export type PositioningAlternativeContrast = z.infer<typeof PositioningAlternati
|
|
|
73
73
|
|
|
74
74
|
export const MarketPositioningConfigSchema = z.object({
|
|
75
75
|
/** Stable kebab-case ref (e.g. `'positioning-icp-small-team-pmo'`). */
|
|
76
|
-
ref:
|
|
76
|
+
ref: MarketEntryRefSchema,
|
|
77
77
|
/**
|
|
78
78
|
* Target ICP. The validator checks the back-link
|
|
79
79
|
* (`MISSING_POSITIONING_FOR_ICP`) for `CORE`/`EXPANSION` ICPs.
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: market-proof-and-objection
|
|
3
3
|
description: Author MarketProof entries (testimonials, metrics, case studies, third-party validation) and MarketObjection entries (the canonical concerns ICPs raise + the canonical responses, with proof refs). Covers ProofKind, ObjectionKind, attribution shapes, supportsBenefitRefs/supportsIcpRefs wiring, response prose, and the PROOF_WITHOUT_SUPPORT, PROOF_KIND_PAYLOAD_MISMATCH, and OBJECTION_PROOF_BENEFIT_MISMATCH validator warnings. Use when the user says "add a proof for X", "we have a customer quote for that", "the metric proof we cite is …", "model the security objection", "the pricing objection always comes up", "the trust objection's response", or "wire proof refs to objections".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Author MarketProof + MarketObjection (Phase 3)
|
|
@@ -237,7 +238,7 @@ Same provenance pattern; drives `STALE_AUTHORED` warnings.
|
|
|
237
238
|
*/
|
|
238
239
|
export const MarketProofConfigSchema = z.object({
|
|
239
240
|
/** Stable kebab-case ref (e.g. `'proof-acme-cut-meetings-80pct'`). */
|
|
240
|
-
ref:
|
|
241
|
+
ref: MarketEntryRefSchema,
|
|
241
242
|
proofKind: z.enum(ProofKind).systemEnum('ProofKind'),
|
|
242
243
|
/** The proof statement as it would appear in copy. */
|
|
243
244
|
statement: NonEmptyStringSchema,
|
|
@@ -329,7 +330,7 @@ export enum ProofKind {
|
|
|
329
330
|
*/
|
|
330
331
|
export const MarketObjectionConfigSchema = z.object({
|
|
331
332
|
/** Stable kebab-case ref (e.g. `'objection-pricing-too-high'`). */
|
|
332
|
-
ref:
|
|
333
|
+
ref: MarketEntryRefSchema,
|
|
333
334
|
objectionKind: z.enum(ObjectionKind).systemEnum('ObjectionKind'),
|
|
334
335
|
/** The objection as the buyer raises it. */
|
|
335
336
|
statement: NonEmptyStringSchema,
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: market-scoring-interpretation
|
|
3
3
|
description: Interpret and consume the deterministic FIT scorer (computeFeatureFitScoreForICP) — the snapshot-pure 0-100 "how well does this feature serve this ICP" signal. Covers the locked vocabulary (FIT vs prioritization), the two zero-score reasons, the anti-target exclusion option, and the runtime composition with isBenefitAvailable. Use when the user says "score features per ICP", "compute the FIT for this feature", "why does this score 0", "include anti-target ICPs in scoring", "show fit dashboard", "is this a no-go", or "compose scoring with runtime availability".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Interpret FIT Scoring (Phase 2)
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: market-snapshot-validation
|
|
3
3
|
description: Run validateMarketSnapshot at app boot to enforce authoring-consistency invariants across the assembled MarketSnapshot. Covers the 18 locked issue kinds (ORPHAN_REF, MULTIPLE_THRESHOLDS_PER_ICP_JOB, THRESHOLD_BENEFIT_WITHOUT_JOB, EMPTY_BENEFIT_DELIVERED_BY, ICP_WITHOUT_PERSONA, INFLUENCE_CYCLE, MISSING_POSITIONING_FOR_ICP, STALE_AUTHORED, DUPLICATE_EDGE_PER_ENTITY, INVALID_ANTI_TARGET_PURPOSE_MIX, BUYING_GROUP_PERSONA_MISSING_DMU_ROLE, BUYING_GROUP_BACKLINK_MISSING, PROOF_WITHOUT_SUPPORT, PROOF_KIND_PAYLOAD_MISMATCH, DUPLICATE_JOURNEY_STAGE, DUPLICATE_BUYING_JOURNEY_FOR_ICP, OBJECTION_PROOF_BENEFIT_MISMATCH, MESSAGE_TEMPLATE_PLACEHOLDER_MISMATCH) with ERROR/WARN severities — see the SKILL body for the per-kind reference table. Use when the user says "validate the market snapshot", "why is my snapshot rejected", "what does ORPHAN_REF mean", "wire validation into bootstrap", or "what is MESSAGE_TEMPLATE_PLACEHOLDER_MISMATCH".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Validate the Market Snapshot at Boot (Phases 2–3)
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: market-tone-of-voice
|
|
3
3
|
description: Author named brand voices (ToneOfVoiceConfig) using the Nielsen Norman 4-axis model — formality, seriousness, respectfulness, enthusiasm — plus illustrative examples that get injected into AI prompts. Use when the user says "define our tone of voice", "the trusted-engineer voice", "we want a candid friend tone", "Nielsen Norman tone axes", "wire the brand voice into AI prompts", or "tone for the indie-maker ICP".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Author ToneOfVoice
|
|
@@ -144,7 +145,7 @@ const AxisSchema = z
|
|
|
144
145
|
|
|
145
146
|
export const ToneOfVoiceConfigSchema = z.object({
|
|
146
147
|
/** Stable kebab-case ref (e.g. `'voice-trusted-engineer'`). */
|
|
147
|
-
ref:
|
|
148
|
+
ref: MarketEntryRefSchema,
|
|
148
149
|
/** Display name used by authoring tools and prompt blocks. */
|
|
149
150
|
name: NonEmptyStringSchema,
|
|
150
151
|
/** One-sentence explanation of when/why to pick this voice. */
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: market-triggers-and-journey
|
|
3
3
|
description: Author MarketTrigger entries (events that create buying intent — growth milestones, regulatory shifts, personnel changes) and the per-ICP MarketBuyingJourney (stages from AWARENESS through ADVOCACY with descriptions, key questions, suggested content, blockers). Covers TriggerKind, BuyingJourneyStage, ICP→journey wiring, and the DUPLICATE_JOURNEY_STAGE validator. Use when the user says "add a buying trigger", "model the moment they start looking", "the journey for the small-team ICP", "what questions does the buyer ask at consideration", "model the awareness-to-decision flow", or "wire triggers to channels".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Author MarketTrigger + MarketBuyingJourney (Phase 3)
|
|
@@ -189,7 +190,7 @@ Same provenance pattern.
|
|
|
189
190
|
*/
|
|
190
191
|
export const MarketTriggerConfigSchema = z.object({
|
|
191
192
|
/** Stable kebab-case ref (e.g. `'trigger-team-grew-past-10'`). */
|
|
192
|
-
ref:
|
|
193
|
+
ref: MarketEntryRefSchema,
|
|
193
194
|
/** Display name (one short noun phrase). */
|
|
194
195
|
name: NonEmptyStringSchema,
|
|
195
196
|
/** One-sentence explanation of the buying-intent shift this triggers. */
|
|
@@ -273,7 +274,7 @@ export enum TriggerKind {
|
|
|
273
274
|
*/
|
|
274
275
|
export const MarketBuyingJourneyConfigSchema = z.object({
|
|
275
276
|
/** Stable kebab-case ref (e.g. `'journey-small-product-team'`). */
|
|
276
|
-
ref:
|
|
277
|
+
ref: MarketEntryRefSchema,
|
|
277
278
|
/** ICP this journey describes. Resolved against `snapshot.icps[]`. */
|
|
278
279
|
icpRef: NonEmptyStringSchema,
|
|
279
280
|
/**
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: milestones-and-celebrations
|
|
3
3
|
description: Declare the milestones your application recognises, choose how each one celebrates, show people their progress, and replace the celebration's look with your own. Use when the user says "add a milestone", "celebrate when someone creates their first X", "the celebration is too loud / blocks the user", "use confetti instead of the popup", "show progress on the dashboard", "the milestone card shows too much", "brand the celebration", or "play a different animation per milestone".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Milestones and celebrations
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: minion-authoring
|
|
3
3
|
description: Author a cron minion — a scheduled background unit that wakes on its own and works through a contained system-access whitelist. Use when the user says "run this nightly", "add a cron job", "this should happen on a schedule", "sweep the stale rows", or when a task's target is a MINION. Covers the package the add-minion scenario composes, the onTick handler, and the three-part containment chain a minion needs before it can touch any resource.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Minion Authoring
|
|
@@ -73,7 +74,10 @@ containment chain that lets that tick touch anything at all.
|
|
|
73
74
|
- `platformAccess: { scopes: ['own_cron_records'] }` on the minion's entry, if and only if the
|
|
74
75
|
tick reads `ownSchedule.read()`.
|
|
75
76
|
4. **Use `systemAccess`, never a direct database client.** The proxy is what the whitelist contains;
|
|
76
|
-
a direct client is uncontained by construction.
|
|
77
|
+
a direct client is uncontained by construction. The platform also confines the minion's own
|
|
78
|
+
database credential to what `resourceAccess` declares (plus the job-execution records every
|
|
79
|
+
minion needs), on a self-hosted MongoDB, on MongoDB Atlas and on PostgreSQL alike — the minion
|
|
80
|
+
never receives the application's database user.
|
|
77
81
|
5. **Log the tick's OUTCOME, not its occurrence.** "Tick handled" tells an operator nothing; how many
|
|
78
82
|
rows it swept, and what it skipped, tells them whether it is working.
|
|
79
83
|
|
|
@@ -0,0 +1,143 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: model-cost-attribution
|
|
3
|
+
description: Know what each case costs in model calls. Declare the resource whose rows are the application's cases (`workUnit`), register the prices the application pays per model (`modelCostAccounting`), pass the case to agent turns, and read cost per case, per organization, per agent or per model from `POST /model-cost/summary`. Use when the user says "how much does each ticket cost us in AI", "cost per case", "track LLM spend per customer", "what is our margin per matter", "register model prices", or "why are these calls unattributed".
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Model Cost Attribution
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
Every model call the engine makes (an agent turn, a one-shot agent, an embedding batch, a document
|
|
24
|
+
extraction) is recorded with its usage. This skill makes that record answer a business question: what did
|
|
25
|
+
working on THIS case cost? The engine attributes each call to the case, the organization and the run it
|
|
26
|
+
served, prices it from the prices the application registered, and sums it exactly, rounding once per group.
|
|
27
|
+
|
|
28
|
+
Three things are the application's to author: which resource is the case, what the application pays, and
|
|
29
|
+
which case a turn is about when the engine cannot see it. Everything else (the frames around operations,
|
|
30
|
+
jobs and runs, the monthly close into aggregates, the deletion rules) is the engine's.
|
|
31
|
+
|
|
32
|
+
This is the application's own margin data. It is not customer billing (`configure-billing`), and it never
|
|
33
|
+
feeds usage-based charges.
|
|
34
|
+
|
|
35
|
+
## App Paths
|
|
36
|
+
|
|
37
|
+
| Surface | Glob (relative to the application root) |
|
|
38
|
+
|---|---|
|
|
39
|
+
| Case declaration | `shared-lib/src/modules/*/resources/*/*.resources-config.ts` (`workUnit: true`) |
|
|
40
|
+
| Prices and month close | `backend-api/src/saas-config.backend.ts` (`modelCostAccounting`) |
|
|
41
|
+
| Detail-row retention | `wildo.saas.config.ts` (`dataRetention` → `OPERATIONAL_LOGS`) |
|
|
42
|
+
| Chat / A2A / actor callers passing a case | `frontend/src/**`, and the A2A client's message `metadata` |
|
|
43
|
+
| Resource specification | `specifications/src/modules/*/resources/*.resource.specification.ts` |
|
|
44
|
+
|
|
45
|
+
## When to Use
|
|
46
|
+
|
|
47
|
+
- The application sells an outcome per case (a ticket, a matter, a claim, a todo) and wants its cost.
|
|
48
|
+
- A report must show model spend per organization, per agent or per model.
|
|
49
|
+
- A summary reports calls as unattributed or unpriced and you need to close the gap.
|
|
50
|
+
|
|
51
|
+
## When NOT to Use
|
|
52
|
+
|
|
53
|
+
- Charging customers for usage → `configure-billing`.
|
|
54
|
+
- Choosing which model an agent uses → `flows-actors-llm-agent-invocation` or `flows-actors-chat-assistant`.
|
|
55
|
+
- How long rows are kept in general → `resource-retention-binding`.
|
|
56
|
+
|
|
57
|
+
## Workflow
|
|
58
|
+
|
|
59
|
+
1. **Declare the case.** Add `workUnit: true` to the resource whose rows are the unit of work
|
|
60
|
+
(`references/framework-work-unit-api.md`). Several resources may be cases. Say so in the resource
|
|
61
|
+
specification's `businessRole`. The engine then opens the case frame by itself around every single-row
|
|
62
|
+
operation on that resource, including after-create hooks and the jobs they enqueue.
|
|
63
|
+
2. **Pass the case where the engine cannot see it.** A turn that is not an operation on the case row names it
|
|
64
|
+
as `caseRef: { resourceType, resourceId }`: on a chat start (`useFlowsActors().startExecution(systemRef, input,
|
|
65
|
+
undefined, undefined, { caseRef })`), an actor run, an autonomous turn, or an A2A message's `metadata.caseRef`. The engine refuses a ref to a resource that is not a work unit or to a row the
|
|
66
|
+
caller cannot read, and always takes the organization from the row. A resume keeps the case of its turn.
|
|
67
|
+
3. **Register the prices.** Add `modelCostAccounting.providerUsagePricingAuthorities` to the backend
|
|
68
|
+
configuration, one entry per provider and model the application calls, keyed on the model id exactly as
|
|
69
|
+
calls record it (`references/framework-model-cost-pricing-api.md`). Without a matching entry a call is
|
|
70
|
+
counted as unpriced, never priced at zero.
|
|
71
|
+
4. **Keep the detail rows long enough.** The monthly close reads a month's detail rows after the month ends plus
|
|
72
|
+
`periodCloseGraceDays`. Set `OPERATIONAL_LOGS` to at least 31 days plus that grace plus one day for the daily close, then run
|
|
73
|
+
`wildo config data-retention`. Startup refuses a shorter period once `modelCostAccounting` is declared.
|
|
74
|
+
5. **Read the cost.** `POST /api/v1/model-cost/summary` with a window and `groupBy`
|
|
75
|
+
(`references/framework-model-cost-summary-api.md`). Only an application super-administrator or billing
|
|
76
|
+
manager may call it. Show `unattributedCallCount` and `unpricedCallCount` beside every total.
|
|
77
|
+
6. **Link invoices, if the application invoices.** After a month closes, its `modelCostPeriodAggregates` row can
|
|
78
|
+
be linked once to the organization's invoice with the `link_invoice` operation. A linked aggregate survives
|
|
79
|
+
the organization's deletion; an unlinked one is deleted with it.
|
|
80
|
+
7. **Stop** when a summary grouped by `CASE` returns your case with a non-zero total and no unexpected
|
|
81
|
+
unattributed or unpriced calls.
|
|
82
|
+
|
|
83
|
+
## Worked Example
|
|
84
|
+
|
|
85
|
+
A todo is the unit of work of a task-tracking application: its assistant and its agents spend model calls on
|
|
86
|
+
todos. One line in the resource configuration makes every call made while working on a todo land on it:
|
|
87
|
+
|
|
88
|
+
|
|
89
|
+
## Usage Example
|
|
90
|
+
|
|
91
|
+
```typescript
|
|
92
|
+
/**
|
|
93
|
+
* A todo is Your Application' CASE (#1598): the unit of work its assistant and its autonomous agents spend model calls
|
|
94
|
+
* on. Every model call made while working on a todo — an operation on it, a turn opened on it, a job enqueued from
|
|
95
|
+
* it — is attributed to the todo and to its organization, so the application can summarize its cost per todo.
|
|
96
|
+
*/
|
|
97
|
+
workUnit: true,
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
## References
|
|
101
|
+
|
|
102
|
+
- `references/framework-work-unit-api.md` — source-backed `WorkUnitRef` and the `workUnit` declaration.
|
|
103
|
+
- `references/framework-work-attribution-api.md` — source-backed attribution vocabulary: run kinds, sources, shares, pricing states.
|
|
104
|
+
- `references/framework-model-cost-pricing-api.md` — source-backed pricing authority, `modelCostAccounting` and an example price.
|
|
105
|
+
- `references/framework-model-cost-summary-api.md` — source-backed summary request and answer.
|
|
106
|
+
|
|
107
|
+
## Verification
|
|
108
|
+
|
|
109
|
+
- [ ] The case resource declares `workUnit: true`, and its specification says it is the case.
|
|
110
|
+
- [ ] Every provider and model the application calls has a pricing authority whose `model` equals the recorded model id.
|
|
111
|
+
- [ ] `OPERATIONAL_LOGS` is at least 32 days plus `periodCloseGraceDays`, and the generated schedule is regenerated.
|
|
112
|
+
- [ ] A turn not started from an operation on the case passes `caseRef`.
|
|
113
|
+
- [ ] A `CASE` summary over a window with known calls reports them, and `unattributedCallCount` is explained.
|
|
114
|
+
|
|
115
|
+
Grep invariants: `rg -n "workUnit: true" shared-lib/src` lists every case resource;
|
|
116
|
+
`rg -n "modelCostAccounting" backend-api/src/saas-config.backend.ts` finds the registered prices;
|
|
117
|
+
`rg -n "caseRef" frontend/src` lists the callers that name a case.
|
|
118
|
+
|
|
119
|
+
## Common Rationalizations
|
|
120
|
+
|
|
121
|
+
| Rationalization | Reality |
|
|
122
|
+
|---|---|
|
|
123
|
+
| "An unpriced call costs nothing, so leave it out." | It is counted apart as unpriced. A total that dropped it would look complete and be low. |
|
|
124
|
+
| "The frontend knows the organization, pass that." | The engine takes the organization from the case row and ignores the caller's. A case of another tenant is refused. |
|
|
125
|
+
| "Round each call to cents, then add." | Many tiny calls each rounded up overstate cost. The engine sums exact fractions and rounds once. |
|
|
126
|
+
| "Thirty days of detail rows is plenty." | The close runs after the month plus the grace; rows deleted before it are missing from the aggregate. Startup refuses it. |
|
|
127
|
+
| "Reasoning tokens are zero, the provider sent none." | Unreported reasoning is recorded as unreported, not zero, and priced as the provider bills it. |
|
|
128
|
+
|
|
129
|
+
## Red Flags
|
|
130
|
+
|
|
131
|
+
- A case resource with no `workUnit: true` (catch with the `workUnit` grep above).
|
|
132
|
+
- A pricing authority whose `model` is a label rather than the recorded model id (every call shows as unpriced in a summary).
|
|
133
|
+
- `OPERATIONAL_LOGS` under 32 days plus the grace (startup refuses it; check `dataRetention`).
|
|
134
|
+
- A chat or A2A caller working on a case with no `caseRef` (catch with the `caseRef` grep above).
|
|
135
|
+
- A report showing a total without the unattributed and unpriced counts.
|
|
136
|
+
|
|
137
|
+
## Related Skills
|
|
138
|
+
|
|
139
|
+
- `flows-actors-chat-assistant` — starting chat turns, where `caseRef` is passed.
|
|
140
|
+
- `flows-actors-a2a-exposure` — A2A messages, where `metadata.caseRef` names the case.
|
|
141
|
+
- `flows-actors-autonomous-agents` — agent turns with nobody signed in.
|
|
142
|
+
- `resource-retention-binding` — the retention schedule the detail rows follow.
|
|
143
|
+
- `configure-billing` — charging customers, which this skill never feeds.
|
package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md
ADDED
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
# Pricing authorities and cost accounting config (source-backed)
|
|
2
|
+
|
|
3
|
+
How the application registers the prices it pays per model (`modelCostAccounting` in the backend
|
|
4
|
+
configuration), and the grace and schedule the monthly close runs on.
|
|
5
|
+
|
|
6
|
+
Read this when:
|
|
7
|
+
- registering or changing a model's price;
|
|
8
|
+
- a summary counts calls as unpriced;
|
|
9
|
+
- setting the month-close grace, or startup refuses the `OPERATIONAL_LOGS` period.
|
|
10
|
+
|
|
11
|
+
## Import Origins
|
|
12
|
+
|
|
13
|
+
- `@wildo-ai/saas-models`
|
|
14
|
+
|
|
15
|
+
## Source Excerpts
|
|
16
|
+
|
|
17
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
*
|
|
21
|
+
* Billable provider-usage dimensions. These are ACQUISITION-cost categories (what the application pays a
|
|
22
|
+
* model provider), not customer billing units.
|
|
23
|
+
*/
|
|
24
|
+
export enum ProviderUsagePricingCategory {
|
|
25
|
+
/** Input tokens read without a prompt cache (or every input token, when the provider reported no split). */
|
|
26
|
+
INPUT_TOKEN = 'INPUT_TOKEN',
|
|
27
|
+
/** Input tokens served from a prompt cache. Priced at `INPUT_TOKEN` when the authority declares no rate. */
|
|
28
|
+
CACHED_INPUT_TOKEN = 'CACHED_INPUT_TOKEN',
|
|
29
|
+
/** Input tokens written into a prompt cache. Priced at `INPUT_TOKEN` when the authority declares no rate. */
|
|
30
|
+
CACHE_WRITE_INPUT_TOKEN = 'CACHE_WRITE_INPUT_TOKEN',
|
|
31
|
+
/** Output tokens. Includes reasoning unless the authority declares a `REASONING_TOKEN` rate. */
|
|
32
|
+
OUTPUT_TOKEN = 'OUTPUT_TOKEN',
|
|
33
|
+
/**
|
|
34
|
+
* Reasoning tokens, when the authority prices them apart. They are then SUBTRACTED from the output
|
|
35
|
+
* quantity: every provider already counts reasoning inside its output total, so reasoning is never
|
|
36
|
+
* billed twice.
|
|
37
|
+
*/
|
|
38
|
+
REASONING_TOKEN = 'REASONING_TOKEN',
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
export const PROVIDER_USAGE_PRICING_CATEGORY_ORDER: readonly ProviderUsagePricingCategory[] = Object.freeze([
|
|
42
|
+
ProviderUsagePricingCategory.INPUT_TOKEN,
|
|
43
|
+
ProviderUsagePricingCategory.CACHED_INPUT_TOKEN,
|
|
44
|
+
ProviderUsagePricingCategory.CACHE_WRITE_INPUT_TOKEN,
|
|
45
|
+
ProviderUsagePricingCategory.OUTPUT_TOKEN,
|
|
46
|
+
ProviderUsagePricingCategory.REASONING_TOKEN,
|
|
47
|
+
]);
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* How a TOTAL is rounded to a whole minor currency unit. There is one mode: exact per-call costs are summed
|
|
51
|
+
* first and the sum is rounded up once, per reported total (#1598 review F11). Rounding each call up would
|
|
52
|
+
* overstate an embedding-heavy case by up to one minor unit per call.
|
|
53
|
+
*/
|
|
54
|
+
export enum ProviderUsagePricingRoundingMode {
|
|
55
|
+
CEILING_AGGREGATE_TO_MINOR_UNIT = 'CEILING_AGGREGATE_TO_MINOR_UNIT',
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/** Closed trigger vocabulary for provider pricing tiers. */
|
|
59
|
+
export enum ProviderUsagePricingTierRuleKind {
|
|
60
|
+
/** The whole request is priced at the tier when its INPUT quantity (all prompt tokens) exceeds the threshold. */
|
|
61
|
+
INPUT_TOKEN_QUANTITY_ABOVE = 'INPUT_TOKEN_QUANTITY_ABOVE',
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** A rate multiplier is written in basis points: 10 000 = ×1. */
|
|
65
|
+
export const PROVIDER_USAGE_RATE_MULTIPLIER_BASIS_POINTS = 10_000;
|
|
66
|
+
|
|
67
|
+
export const ProviderUsagePricingTierRuleSchema = z.strictObject({
|
|
68
|
+
kind: z.literal(ProviderUsagePricingTierRuleKind.INPUT_TOKEN_QUANTITY_ABOVE),
|
|
69
|
+
inputTokenThresholdExclusive: nonnegativeSafeIntegerSchema,
|
|
70
|
+
/** Multiplier on the three input categories, in basis points (≥ 10 000: a tier never discounts). */
|
|
71
|
+
inputRateMultiplierBasisPoints: positiveSafeIntegerSchema,
|
|
72
|
+
/** Multiplier on output and reasoning, in basis points (≥ 10 000). */
|
|
73
|
+
outputRateMultiplierBasisPoints: positiveSafeIntegerSchema,
|
|
74
|
+
});
|
|
75
|
+
export type ProviderUsagePricingTierRule = z.infer<typeof ProviderUsagePricingTierRuleSchema>;
|
|
76
|
+
|
|
77
|
+
export const ProviderUsagePricingRateSchema = z.strictObject({
|
|
78
|
+
category: z.enum(ProviderUsagePricingCategory),
|
|
79
|
+
/** Minor-currency units charged per `unitsDenominator` billable units. */
|
|
80
|
+
amountMinorNumerator: nonnegativeSafeIntegerSchema,
|
|
81
|
+
});
|
|
82
|
+
export type ProviderUsagePricingRate = z.infer<typeof ProviderUsagePricingRateSchema>;
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* One provider/model acquisition-cost price, REGISTERED BY THE APPLICATION in
|
|
86
|
+
* `modelCostAccounting.providerUsagePricingAuthorities` (#1598), because rates are negotiated: a list price
|
|
87
|
+
* shipped by the engine would be wrong for every firm with a contract, and would go stale.
|
|
88
|
+
*
|
|
89
|
+
* A price is identified by `pricingAuthorityRef@pricingAuthorityVersion`; the registry refuses a duplicate
|
|
90
|
+
* pair at startup. A call is priced by the authority whose `providerRef` and `model` equal the call's
|
|
91
|
+
* recorded provider and model, choosing the highest version whose `effectiveFrom` is not after the call.
|
|
92
|
+
* No match leaves the call `UNPRICED`, never priced at zero.
|
|
93
|
+
*
|
|
94
|
+
* Deliberately separate from billing's `PriceSchema`, which is what the application CHARGES its customers.
|
|
95
|
+
*
|
|
96
|
+
* History: an earlier revision carried `implementationDigest` and `pricingDigest` and a "sealed basis" type
|
|
97
|
+
* saying an application could "neither choose rates" nor mint the digest. Both were remnants of the retired
|
|
98
|
+
* digest era (one-source-of-truth Rule 0) and contradicted the decision that the application registers its
|
|
99
|
+
* rates. `modelRef` / `modelVersion` were replaced by `model`, the one id a call actually records.
|
|
100
|
+
*/
|
|
101
|
+
export const ProviderUsagePricingAuthoritySchema = z.strictObject({
|
|
102
|
+
schemaVersion: z.literal(1),
|
|
103
|
+
/** Stable name of this price list entry, for example `pricing:openai/gpt-5.6-terra`. */
|
|
104
|
+
pricingAuthorityRef: z.string().min(1).max(200),
|
|
105
|
+
/** Version of that entry. A rate change is a new version with a later `effectiveFrom`, never an edit. */
|
|
106
|
+
pricingAuthorityVersion: positiveSafeIntegerSchema,
|
|
107
|
+
/** The provider the call went to, exactly as the call records it (`openai`, `anthropic`, ...). */
|
|
108
|
+
providerRef: z.string().min(1),
|
|
109
|
+
/** The resolved model id, exactly as the call records it (`gpt-5.6-terra`, `claude-opus-4-8`, ...). */
|
|
110
|
+
model: z.string().min(1),
|
|
111
|
+
/** ISO 4217 code. Currencies are never converted: every total is per currency. */
|
|
112
|
+
currency: z.string().regex(/^[A-Z]{3}$/),
|
|
113
|
+
/** The number of billable units each rate's `amountMinorNumerator` is charged per (1 000 000 for "per million tokens"). */
|
|
114
|
+
unitsDenominator: positiveSafeIntegerSchema,
|
|
115
|
+
roundingMode: z.literal(ProviderUsagePricingRoundingMode.CEILING_AGGREGATE_TO_MINOR_UNIT),
|
|
116
|
+
rates: z.array(ProviderUsagePricingRateSchema).min(1),
|
|
117
|
+
/** Ordered full-request price tiers; the highest matching input threshold wins. */
|
|
118
|
+
usageTierRules: z.array(ProviderUsagePricingTierRuleSchema),
|
|
119
|
+
/** From when this version applies to a call (inclusive). */
|
|
120
|
+
effectiveFrom: isoDateTimeSchema,
|
|
121
|
+
/** Where the rates come from: a public price page, a contract reference. Provenance only. */
|
|
122
|
+
sourceRef: z.string().min(1),
|
|
123
|
+
sourceVersion: z.string().min(1),
|
|
124
|
+
}).superRefine((authority, context) => {
|
|
125
|
+
const categories = authority.rates.map((rate) => rate.category);
|
|
126
|
+
if (new Set(categories).size !== categories.length) {
|
|
127
|
+
context.addIssue({ code: 'custom', message: 'pricing categories must be unique', path: ['rates'] });
|
|
128
|
+
}
|
|
129
|
+
const order = new Map(PROVIDER_USAGE_PRICING_CATEGORY_ORDER.map((category, index) => [category, index]));
|
|
130
|
+
if (!categories.every((category, index) => index === 0 || order.get(categories[index - 1]!)! < order.get(category)!)) {
|
|
131
|
+
context.addIssue({ code: 'custom', message: 'pricing categories must use canonical order', path: ['rates'] });
|
|
132
|
+
}
|
|
133
|
+
for (const required of [ProviderUsagePricingCategory.INPUT_TOKEN, ProviderUsagePricingCategory.OUTPUT_TOKEN]) {
|
|
134
|
+
if (!categories.includes(required)) context.addIssue({ code: 'custom', message: `${required} pricing is required`, path: ['rates'] });
|
|
135
|
+
}
|
|
136
|
+
if (!authority.usageTierRules.every((rule, index) => index === 0 || authority.usageTierRules[index - 1]!.inputTokenThresholdExclusive < rule.inputTokenThresholdExclusive)) {
|
|
137
|
+
context.addIssue({ code: 'custom', message: 'usage pricing tiers must use unique ascending thresholds', path: ['usageTierRules'] });
|
|
138
|
+
}
|
|
139
|
+
for (const [index, rule] of authority.usageTierRules.entries()) {
|
|
140
|
+
if (rule.inputRateMultiplierBasisPoints < PROVIDER_USAGE_RATE_MULTIPLIER_BASIS_POINTS || rule.outputRateMultiplierBasisPoints < PROVIDER_USAGE_RATE_MULTIPLIER_BASIS_POINTS) {
|
|
141
|
+
context.addIssue({ code: 'custom', message: 'usage pricing tier multipliers cannot discount the registered base rate', path: ['usageTierRules', index] });
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
});
|
|
145
|
+
export type ProviderUsagePricingAuthority = z.infer<typeof ProviderUsagePricingAuthoritySchema>;
|
|
146
|
+
export type ProviderUsagePricingAuthorityInput = z.input<typeof ProviderUsagePricingAuthoritySchema>;
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
## Import Origins
|
|
150
|
+
|
|
151
|
+
- `@wildo-ai/saas-models`
|
|
152
|
+
|
|
153
|
+
## Source Excerpts
|
|
154
|
+
|
|
155
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
156
|
+
|
|
157
|
+
```typescript
|
|
158
|
+
export const ModelCostAccountingConfigSchema = z.object({
|
|
159
|
+
/** The application's registered model prices. Absent or empty: every call is recorded UNPRICED. */
|
|
160
|
+
providerUsagePricingAuthorities: z.array(ProviderUsagePricingAuthoritySchema).default([]),
|
|
161
|
+
/** Days after a calendar month (UTC) ends before its cost aggregates are written. 0–27. */
|
|
162
|
+
periodCloseGraceDays: z.number().int().min(0).max(27).default(MODEL_COST_PERIOD_CLOSE_DEFAULT_GRACE_DAYS),
|
|
163
|
+
/** Cron schedule of the period-close batch. */
|
|
164
|
+
periodCloseCronSchedule: z.string().min(1).default(MODEL_COST_PERIOD_CLOSE_DEFAULT_CRON),
|
|
165
|
+
}).superRefine((config, context) => {
|
|
166
|
+
try {
|
|
167
|
+
assertUniqueProviderUsagePricingAuthorities(config.providerUsagePricingAuthorities);
|
|
168
|
+
} catch (error) {
|
|
169
|
+
context.addIssue({ code: 'custom', path: ['providerUsagePricingAuthorities'], message: error instanceof Error ? error.message : String(error) });
|
|
170
|
+
}
|
|
171
|
+
});
|
|
172
|
+
export type ModelCostAccountingConfig = z.infer<typeof ModelCostAccountingConfigSchema>;
|
|
173
|
+
export type ModelCostAccountingConfigInput = z.input<typeof ModelCostAccountingConfigSchema>;
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
A minimal registration:
|
|
177
|
+
|
|
178
|
+
|
|
179
|
+
## Usage Example
|
|
180
|
+
|
|
181
|
+
```typescript
|
|
182
|
+
export const exampleProviderUsagePricingAuthority: ProviderUsagePricingAuthorityInput = {
|
|
183
|
+
schemaVersion: 1,
|
|
184
|
+
pricingAuthorityRef: 'pricing:openai/gpt-5.6-terra',
|
|
185
|
+
pricingAuthorityVersion: 1,
|
|
186
|
+
providerRef: 'openai',
|
|
187
|
+
// The resolved model id exactly as the call records it (the agent's configured model).
|
|
188
|
+
model: 'gpt-5.6-terra',
|
|
189
|
+
currency: 'USD',
|
|
190
|
+
// Rates below are minor units (cents) per million tokens.
|
|
191
|
+
unitsDenominator: 1_000_000,
|
|
192
|
+
roundingMode: ProviderUsagePricingRoundingMode.CEILING_AGGREGATE_TO_MINOR_UNIT,
|
|
193
|
+
rates: [
|
|
194
|
+
{ category: ProviderUsagePricingCategory.INPUT_TOKEN, amountMinorNumerator: 200 },
|
|
195
|
+
{ category: ProviderUsagePricingCategory.CACHED_INPUT_TOKEN, amountMinorNumerator: 20 },
|
|
196
|
+
{ category: ProviderUsagePricingCategory.CACHE_WRITE_INPUT_TOKEN, amountMinorNumerator: 250 },
|
|
197
|
+
// No REASONING_TOKEN rate: reasoning is priced as output, which is how this provider bills it.
|
|
198
|
+
{ category: ProviderUsagePricingCategory.OUTPUT_TOKEN, amountMinorNumerator: 1_200 },
|
|
199
|
+
],
|
|
200
|
+
// Requests over 272k input tokens are priced at 2x input and 1.5x output.
|
|
201
|
+
usageTierRules: [{
|
|
202
|
+
kind: ProviderUsagePricingTierRuleKind.INPUT_TOKEN_QUANTITY_ABOVE,
|
|
203
|
+
inputTokenThresholdExclusive: 272_000,
|
|
204
|
+
inputRateMultiplierBasisPoints: 20_000,
|
|
205
|
+
outputRateMultiplierBasisPoints: 15_000,
|
|
206
|
+
}],
|
|
207
|
+
effectiveFrom: '2026-08-13T00:00:00.000Z',
|
|
208
|
+
sourceRef: 'https://developers.openai.com/api/docs/models/gpt-5.6-terra',
|
|
209
|
+
sourceVersion: 'observed:2026-08-13',
|
|
210
|
+
};
|
|
211
|
+
```
|
package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md
ADDED
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
# Model-cost summary API (source-backed)
|
|
2
|
+
|
|
3
|
+
The request and answer of `POST /api/v1/model-cost/summary`: cost per case, per organization, per agent or
|
|
4
|
+
per model over a window, rounded once per group and currency.
|
|
5
|
+
|
|
6
|
+
Read this when:
|
|
7
|
+
- building a margin or cost-per-case report;
|
|
8
|
+
- reading the `unattributedCallCount` / `unpricedCallCount` counts;
|
|
9
|
+
- reading `expertTime` on a `CASE` summary.
|
|
10
|
+
|
|
11
|
+
## Import Origins
|
|
12
|
+
|
|
13
|
+
- `@wildo-ai/saas-models`
|
|
14
|
+
|
|
15
|
+
## Source Excerpts
|
|
16
|
+
|
|
17
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
/** The most case references one summary request may name. */
|
|
21
|
+
export const MODEL_COST_SUMMARY_MAX_CASE_REFS = 200;
|
|
22
|
+
/**
|
|
23
|
+
* The longest window one summary may cover (review F11): a summary reads every detail row in its window, so an
|
|
24
|
+
* unbounded window is an unbounded read. A year covers every business question these rows can answer (they are kept
|
|
25
|
+
* for the OPERATIONAL_LOGS period, weeks in practice); older cost lives in the monthly aggregates.
|
|
26
|
+
*/
|
|
27
|
+
export const MODEL_COST_SUMMARY_MAX_WINDOW_DAYS = 366;
|
|
28
|
+
|
|
29
|
+
export const ModelCostSummaryRequestSchema = z.strictObject({
|
|
30
|
+
/** Window start, inclusive, as an ISO instant. Cut on the call's `calledAt`. */
|
|
31
|
+
from: z.iso.datetime({ offset: true }),
|
|
32
|
+
/** Window end, exclusive, as an ISO instant. */
|
|
33
|
+
to: z.iso.datetime({ offset: true }),
|
|
34
|
+
groupBy: z.enum(ModelCostGroupBy).systemEnum('ModelCostGroupBy'),
|
|
35
|
+
/** Narrow the summary to these cases. */
|
|
36
|
+
caseRefs: z.array(WorkUnitRefSchema).max(MODEL_COST_SUMMARY_MAX_CASE_REFS).optional(),
|
|
37
|
+
}).refine((request) => Date.parse(request.from) < Date.parse(request.to), { message: 'from must precede to', path: ['to'] })
|
|
38
|
+
.refine((request) => Date.parse(request.to) - Date.parse(request.from) <= MODEL_COST_SUMMARY_MAX_WINDOW_DAYS * 24 * 60 * 60_000, {
|
|
39
|
+
message: `a summary window is at most ${MODEL_COST_SUMMARY_MAX_WINDOW_DAYS} days`, path: ['to'],
|
|
40
|
+
});
|
|
41
|
+
export type ModelCostSummaryRequest = z.infer<typeof ModelCostSummaryRequestSchema>;
|
|
42
|
+
|
|
43
|
+
/** One currency's totals inside a group. `XXX` holds the calls no registered authority priced. */
|
|
44
|
+
export const ModelCostCurrencyTotalSchema = z.object({
|
|
45
|
+
currency: z.string().regex(/^[A-Z]{3}$/),
|
|
46
|
+
/** The exact sum of the group's call costs in this currency, each row's share applied, rounded up once. */
|
|
47
|
+
costMinor: z.number().int().min(0),
|
|
48
|
+
callCount: z.number().int().min(0),
|
|
49
|
+
promptTokens: z.number().int().min(0),
|
|
50
|
+
completionTokens: z.number().int().min(0),
|
|
51
|
+
totalTokens: z.number().int().min(0),
|
|
52
|
+
cacheReadTokens: z.number().int().min(0),
|
|
53
|
+
cacheWriteTokens: z.number().int().min(0),
|
|
54
|
+
reasoningTokens: z.number().int().min(0),
|
|
55
|
+
});
|
|
56
|
+
export type ModelCostCurrencyTotal = z.infer<typeof ModelCostCurrencyTotalSchema>;
|
|
57
|
+
|
|
58
|
+
/** Expert review time joined on the case (only on a `CASE` summary). */
|
|
59
|
+
export const ModelCostExpertTimeSchema = z.object({
|
|
60
|
+
availability: z.enum(ExpertTimeAvailability).systemEnum('ExpertTimeAvailability'),
|
|
61
|
+
/** Decisions on agent proposals recorded for the case. Present when `JOINED`. */
|
|
62
|
+
decisionCount: z.number().int().min(0).optional(),
|
|
63
|
+
/** Sum of `decidedAt − presentedAt` over those decisions, in ms: a PROXY for review effort, not a timesheet. */
|
|
64
|
+
reviewDurationMs: z.number().int().min(0).optional(),
|
|
65
|
+
});
|
|
66
|
+
export type ModelCostExpertTime = z.infer<typeof ModelCostExpertTimeSchema>;
|
|
67
|
+
|
|
68
|
+
export const ModelCostSummaryGroupSchema = z.object({
|
|
69
|
+
/** The group's key: the one member the summary groups by is set; an unattributed group has none. */
|
|
70
|
+
key: z.object({
|
|
71
|
+
caseRef: WorkUnitRefSchema.optional(),
|
|
72
|
+
organizationId: z.string().optional(),
|
|
73
|
+
agentRef: z.string().optional(),
|
|
74
|
+
provider: z.string().optional(),
|
|
75
|
+
model: z.string().optional(),
|
|
76
|
+
}),
|
|
77
|
+
/** Distinct provider calls in the group. */
|
|
78
|
+
callCount: z.number().int().min(0),
|
|
79
|
+
unpricedCallCount: z.number().int().min(0),
|
|
80
|
+
totals: z.array(ModelCostCurrencyTotalSchema),
|
|
81
|
+
expertTime: ModelCostExpertTimeSchema.optional(),
|
|
82
|
+
});
|
|
83
|
+
export type ModelCostSummaryGroup = z.infer<typeof ModelCostSummaryGroupSchema>;
|
|
84
|
+
|
|
85
|
+
export const ModelCostSummarySchema = z.object({
|
|
86
|
+
window: z.object({ from: z.string(), to: z.string() }),
|
|
87
|
+
groupBy: z.enum(ModelCostGroupBy),
|
|
88
|
+
groups: z.array(ModelCostSummaryGroupSchema),
|
|
89
|
+
/** Distinct provider calls in the window recorded `UNATTRIBUTED` (made outside any work frame). */
|
|
90
|
+
unattributedCallCount: z.number().int().min(0),
|
|
91
|
+
/** Distinct provider calls in the window no registered authority priced. */
|
|
92
|
+
unpricedCallCount: z.number().int().min(0),
|
|
93
|
+
});
|
|
94
|
+
export type ModelCostSummary = z.infer<typeof ModelCostSummarySchema>;
|
|
95
|
+
```
|