@wildo-ai/saas-specifications 1.1.3 → 1.1.4
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/esm/_catalogs/index.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/aggregate-rating.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/article.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/blog-posting.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/breadcrumb-list.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/faq-page.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/index.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/offer.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/organization.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/product.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/review.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/website.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-behaviors.schemas.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-asset.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-asset.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-generation.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-logo-direction.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-name.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-visual-tone.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/pricing-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-semantics.specifications.schemas.d.ts.map +1 -1
- package/dist/esm/_core/chart-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-completeness-statement.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts +118 -0
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js +65 -3
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +498 -7
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +472 -19
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +2 -0
- package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.schemas.js +2 -0
- package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/required-document-set.schemas.d.ts.map +1 -1
- package/dist/esm/_core/composite-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/cross-registry-assertions.d.ts.map +1 -1
- package/dist/esm/_core/data-seed-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/definition-specification-validators.d.ts.map +1 -1
- package/dist/esm/_core/definition-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/error-message-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/execution-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-validation.js.map +1 -1
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.js.map +1 -1
- package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -1
- package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
- package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
- package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +9 -9
- package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/capability-map-output-set-validation.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-validation.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/frontend-component-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/full-custom-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/guidance-flow-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/index.d.ts.map +1 -1
- package/dist/esm/_core/index.js.map +1 -1
- package/dist/esm/_core/market/feature-benefit.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/inherit-from.d.ts.map +1 -1
- package/dist/esm/_core/market/is-benefit-available.d.ts.map +1 -1
- package/dist/esm/_core/market/market-alternative.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-buying-journey.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-category.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-channel.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-context-block.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-gain.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-icp.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-job.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-message-template.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-objection.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-pain.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-persona.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-positioning.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-proof.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-scoring.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +18 -18
- package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-tone-of-voice.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-trigger.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/milestone-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/onboarding-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts +22 -16
- package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-validation.js +17 -11
- package/dist/esm/_core/placement-plan/placement-plan-validation.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +12 -8
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js +12 -8
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
- package/dist/esm/_core/product-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/provider-specification.schemas.d.ts +16 -0
- package/dist/esm/_core/provider-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/provider-specification.schemas.js +0 -20
- package/dist/esm/_core/provider-specification.schemas.js.map +1 -1
- package/dist/esm/_core/required-features-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/non-functional-requirement.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/resource-specification-registry-alignment.d.ts.map +1 -1
- package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/resource-type-member-name.types.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-phase.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/role-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/sidebar-section-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/system-email-template-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/translation-slot-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/utils/extract-field-specs.d.ts.map +1 -1
- package/dist/esm/_core/utils/family-ref-stamping.d.ts.map +1 -1
- package/dist/esm/_core/utils/family-ref-stamping.js.map +1 -1
- package/dist/esm/_core/utils/retention-marker-field-specs.d.ts.map +1 -1
- package/dist/esm/_core/utils/validate-field-shapes.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-constraint.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-idea.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-mission.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-problem.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-success-criterion.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision.family-aspects.d.ts.map +1 -1
- package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/document-facts.family-aspects.d.ts.map +1 -1
- package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts.map +1 -1
- package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.d.ts.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +8 -0
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js +8 -0
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/specification-content-validation-state.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation-playbook-runtime.exports.d.ts.map +1 -1
- package/dist/esm/application-creation.exports.d.ts.map +1 -1
- package/dist/esm/assurance/application-document-publication.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/application-document-publication.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +11 -0
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.js +37 -4
- package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +2 -2
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts +30 -0
- package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-blueprint-selection.js +40 -0
- package/dist/esm/assurance/assurance-document-blueprint-selection.js.map +1 -1
- package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts +22 -9
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +2002 -29
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-external-framework-mapping.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +30 -0
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js +40 -0
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-program.family-aspects.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.d.ts +30 -14
- package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.js +14 -6
- package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +29 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -1
- package/dist/esm/assurance/document-publication.family-aspects.d.ts.map +1 -1
- package/dist/esm/assurance.exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.js.map +1 -1
- package/dist/esm/engine/_bootstrap.d.ts.map +1 -1
- package/dist/esm/engine/_bootstrap.js.map +1 -1
- package/dist/esm/engine/applications/index.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/auth/index.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts +47 -0
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +355 -0
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -0
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/index.d.ts +1 -0
- package/dist/esm/engine/auth/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/index.js +1 -0
- package/dist/esm/engine/auth/resources/index.js.map +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +9 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +2 -0
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/index.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/billing-api-reference-examples.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/index.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +69 -0
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +316 -0
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -0
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/resources/index.d.ts +1 -0
- package/dist/esm/engine/compliance/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/index.js +1 -0
- package/dist/esm/engine/compliance/resources/index.js.map +1 -1
- package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-specifications.registry.js +4 -0
- package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.js +19 -0
- package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
- package/dist/esm/engine/errors/index.d.ts.map +1 -1
- package/dist/esm/engine/features/_engine-feature-shared.d.ts.map +1 -1
- package/dist/esm/engine/features/advanced-analytics.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/audit-logs.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/audit-logs.feature.specification.js.map +1 -1
- package/dist/esm/engine/features/core-limits.feature.specifications.d.ts.map +1 -1
- package/dist/esm/engine/features/core-limits.feature.specifications.js.map +1 -1
- package/dist/esm/engine/features/custom-branding.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/directory-provisioning.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/index.d.ts.map +1 -1
- package/dist/esm/engine/features/m2m-webhook-delivery.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/security-event-export.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/single-sign-on.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/files/index.d.ts.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.js +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
- package/dist/esm/engine/files/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/action-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button-group-separator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button-group-text.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-artifact-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-artifact.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-code-block.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-image.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-web-preview.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-message.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-sources.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-suggestion.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-suggestions.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-decision-request.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-human-input-request.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-confirmation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-queue.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-task.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-tool.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-connection.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-controls.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-edge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-panel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-toolbar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-capabilities.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-prompt-spec.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-context.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-model-selector.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-open-in-chat.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/shared/ai-loader.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/shared/ai-shimmer.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-chain-of-thought.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-checkpoint.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-inline-citation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-plan.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-reasoning.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-error-boundary.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-home.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-main-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-router-error-boundary.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-settings-hub.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layouts-test-component.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/lifecycle-home-activation-progress.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/lifecycle-home-dashboard.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/lifecycle-home-welcome-back.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-static-content-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-terms.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-auth-callback.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-enrollment-required.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-magic-link-verify.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-mfa-challenge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-oauth-consent.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-oauth-logged-out.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-oauth-logout-confirm.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-one-off-session.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-auth.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-confirm-email.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-invitation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-password-lost.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-register.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-invoice-history.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-portal-link.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-subscription-status.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-usage-dashboard.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/avatar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/description-details.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/description-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/description-term.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/_display-field-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-boolean.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-code.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-duration.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-enum.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-audio.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-document.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-gallery.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-image.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-video.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-foreign-key.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-money.extra-props.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-phone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/notification-indicator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/celebration-overlay.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/danger-zone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/empty-state.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/error-display.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-limit-indicator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-lock-badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-unavailable-dialog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-unavailable-prompt.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/loading-overlay.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/loading-spinner.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/operations-confirm-critical.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/progress.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/skeleton.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/toast.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-actor.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-agent-config.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-artifact-browser.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-plan.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-stream.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-execution.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-node.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-system-catalog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-task-detail.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-task-memory.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/_framework-layout-form-field-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/_low-level-preset-wrapper-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/autosave-indicator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-content.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-description.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-error.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-label.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-separator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-title.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-control.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-description.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-field.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-item.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-label.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-message.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-root.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/combobox-multiple.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/combobox.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/checkbox.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/switch.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/toggle-group-boolean.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/toggle.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/calendar-day-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/calendar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/date-range-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/datepicker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-range-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/time-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/time-range-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/radio-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/radio-item.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/select-multiple.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/select.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/toggle-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/file/file-upload.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/file/image-crop.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-addon.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-text.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-textarea.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/number/range-slider.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/number/slider.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/color-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/input-otp.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/markdown-editor.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/password-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/textarea.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-boolean.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-code.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-duration.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-enum.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-file.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-phone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/form-field-foreign-key.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-announcement.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-banner.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-checklist-item.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-checklist.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-modal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-onboarding-view.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-survey.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-tooltip.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-tour.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/chart-echarts.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/chart-widget.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-chart.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-composite.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-execution.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-full-custom.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-not-found.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/index.js.map +1 -1
- package/dist/esm/engine/frontend-components/internal/_tier2-virtual-slot-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/aspect-ratio.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/carousel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/divider.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/resizable-panel-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/scroll-area.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/separator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-legend.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-overlay-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/activity-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/command-menu.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/control-panel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/menubar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/navigation-back.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/notification-center.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/quick-action-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/quick-switcher.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/sidebar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/status-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/toolbar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/utility-panel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/breadcrumb.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/command.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/menu-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/navbar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/sidebar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/alert-dialog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/alert.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/dialog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/drawer.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/sheet.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/context-menu.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/dropdown-menu.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/hover-card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/popover.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/tooltip.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/progression/progression-achievement-badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/progression/progression-milestone-tracker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/_framework-layout-resource-layout-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-action.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-breadcrumb.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-container-dialogs.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-container-nested.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-create.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-danger-zone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-filters.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-header.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-list-table.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-operation-bulk.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-operations-items.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-pagination.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read-expandable.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read-summary-table-row.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read-summary.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-search-table.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-search.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-update.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit-search.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/accordion.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/collapsible.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/pagination.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/stacked-layout.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/table.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/tabs.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/code.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/heading.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/label.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/link.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/strong.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/subheading.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/text-link.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/full-custom-views/index.d.ts.map +1 -1
- package/dist/esm/engine/guidance/index.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/index.d.ts.map +1 -1
- package/dist/esm/engine/index.js.map +1 -1
- package/dist/esm/engine/infrastructure/index.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/system-emails/authentication.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/security.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/index.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
- package/dist/esm/engine/providers/_engine-provider-shared.d.ts.map +1 -1
- package/dist/esm/engine/providers/_engine-provider-shared.js.map +1 -1
- package/dist/esm/engine/providers/anthropic.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/anthropic.provider.specification.js +10 -1
- package/dist/esm/engine/providers/anthropic.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/apple.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/apple.provider.specification.js +10 -1
- package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/email-preview.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/email-preview.provider.specification.js +9 -1
- package/dist/esm/engine/providers/email-preview.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/github.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/github.provider.specification.js +10 -1
- package/dist/esm/engine/providers/github.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/google.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/google.provider.specification.js +10 -1
- package/dist/esm/engine/providers/google.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/grok.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/grok.provider.specification.js +10 -1
- package/dist/esm/engine/providers/grok.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/index.d.ts.map +1 -1
- package/dist/esm/engine/providers/index.js.map +1 -1
- package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/microsoft.provider.specification.js +10 -1
- package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/mistral.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/mistral.provider.specification.js +10 -1
- package/dist/esm/engine/providers/mistral.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/openai.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/openai.provider.specification.js +10 -1
- package/dist/esm/engine/providers/openai.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/opencode.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/opencode.provider.specification.js +9 -1
- package/dist/esm/engine/providers/opencode.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/perplexity.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/perplexity.provider.specification.js +10 -1
- package/dist/esm/engine/providers/perplexity.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/resend.provider.specification.js +10 -1
- package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/stripe.provider.specification.js +10 -1
- package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -1
- package/dist/esm/engine/providers/twilio.provider.specification.d.ts.map +1 -1
- package/dist/esm/engine/providers/twilio.provider.specification.js +10 -1
- package/dist/esm/engine/providers/twilio.provider.specification.js.map +1 -1
- package/dist/esm/engine/roles/_engine-role-shared.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-billing-manager.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-marketing-editor.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-super-admin.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-viewer.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-anonymous.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-public.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-user.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/index.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-admin.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-guest.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-manager.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-member.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-owner.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/index.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.js +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/users-api-reference.examples.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-api-reference-targets.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-assets.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-capture.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-common.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-environment-identity.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-evidence.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-lifecycle.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-publication.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
- package/dist/esm/technical-documentation.exports.d.ts.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +8 -8
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts +0 -0
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts.map +0 -0
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js +0 -0
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js.map +0 -0
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts +0 -0
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts.map +0 -0
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js +0 -0
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js.map +0 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"files.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `files` — Wildo SaaS engine specification (backend-only).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/files/files.shared.schemas.ts → `FileSchema`\n * - Factory: engine/saas-models/src/files/files.shared.resources-config.schemas.ts\n * → `filesResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none\n */\n\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n FileDisplayNature,\n FileStorageAccepted,\n FileUploaderEntityType,\n} from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n FileSchema,\n FileStatus,\n filesResourceConfiguration_InitializationFactory,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nexport const filesResourceSpecification = resourceSpecification(\n filesResourceConfiguration_InitializationFactory,\n FileSchema,\n ({ schemaShape }) => ({\n purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',\n businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',\n lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',\n audience: LabelAudience.END_USER,\n subDomain: EngineResourceSubDomain.FILES,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'filesResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'FILES',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Repository-only resource: all operations are `REPOSITORY_ONLY` — `FilesBackendService` is the intended entry point, not public CRUD controllers.',\n 'Per-record `primaryScope` + scope id fields can represent APPLICATION, ORGANIZATIONS, or USER_SELF rows; the resource-level `resourcePrimaryScope` declared here is the registry default for the FILES type, not every row’s dynamic scope.',\n ],\n },\n\n fields: {\n fileId: schemaShape.fileId.stringSpec({\n meaning: 'Stable public identifier for this file metadata document, embedded in storage keys and download URLs. It is a virtual projection of the document’s underlying Mongo `_id` (`fileId === String(_id)`), so the file has a single stored identity and there is no separate persisted `fileId` field.',\n whyItMatters: 'This is the identifier other resources store in `z_file()` fields and that presigned URL flows reference. Because it projects `_id`, the value is allocated by the database at insert time rather than minted before the row exists, so creation is insert-first.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n filename: schemaShape.filename.stringSpec({\n meaning: 'Sanitized filename used in UI and download headers.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'label',\n }),\n\n originalFilename: schemaShape.originalFilename.stringSpec({\n meaning: 'Original client-provided filename before sanitization for audit/support.',\n semanticRole: 'label',\n }),\n\n mimeType: schemaShape.mimeType.stringSpec({\n meaning: 'IANA-style MIME classification for validation, AV routing, and viewer choice.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n size: schemaShape.size.numberSpec({\n meaning: 'Byte length of the stored object after upload completes.',\n unit: 'bytes',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n extension: schemaShape.extension.stringSpec({\n meaning: 'Filename extension snapshot (without dot) for quick filtering when MIME is generic.',\n semanticRole: 'code',\n }),\n\n checksum: schemaShape.checksum.stringSpec({\n meaning: 'Optional content hash for deduplication and integrity checks after upload.',\n semanticRole: 'code',\n }),\n\n storageProvider: schemaShape.storageProvider.enumSpec({\n meaning: 'Which registered storage backend (S3-compatible, local, …) holds the bytes.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileStorageAccepted',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStorageAccepted.WILDO_MANAGED]: { meaning: 'Managed object storage (S3-compatible) selected by the platform default configuration.' },\n [FileStorageAccepted.LOCAL_DIRECTORY]: { meaning: 'Local filesystem directory for development or air-gapped single-node installs.' },\n [FileStorageAccepted.ONEDRIVE]: { meaning: 'Optional Microsoft OneDrive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.GOOGLE_DRIVE]: { meaning: 'Optional Google Drive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.DROPBOX]: { meaning: 'Optional Dropbox-backed storage when an app enables the connector.' },\n },\n }),\n\n storageRef: schemaShape.storageRef.stringSpec({\n meaning: 'Opaque handle the active storage adapter uses to retrieve bytes (bucket/key tuple is adapter-specific).',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'identifier',\n }),\n\n storageKey: schemaShape.storageKey.stringSpec({\n meaning: 'Derived, human-debuggable key encoding the scope path (`app/...`, `org/...`, `user/...`) and `fileId`, used in logs and migrations. Because it depends on the database-assigned `fileId`, it is populated immediately after insert and is optional at rest until then.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n url: schemaShape.url.stringSpec({\n meaning: 'Cached HTTP(S) URL when a long-lived public or CDN URL is available (may be presigned elsewhere).',\n semanticRole: 'uri',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk records.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata record exists, bytes not ready yet.' },\n [FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },\n [FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },\n [FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },\n [FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },\n [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this record.' },\n [FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },\n [FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },\n [FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },\n [FileStatus.QUARANTINED]: { meaning: 'Isolated for operator review; download blocked by policy.' },\n },\n }),\n\n nature: schemaShape.nature.enumSpec({\n meaning: 'Resolved high-level file kind (image / video / document) used for template selection, not raw MIME subtypes alone.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileDisplayNature',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileDisplayNature.IMAGE]: { meaning: 'Raster/vector still asset suitable for lightbox and thumbnail UIs.' },\n [FileDisplayNature.VIDEO]: { meaning: 'Time-based media; shows duration and streaming-friendly player chrome.' },\n [FileDisplayNature.AUDIO]: { meaning: 'Sound-only media with duration metadata.' },\n [FileDisplayNature.DOCUMENT]: { meaning: 'Text-first assets such as office/PDF/structured docs.' },\n [FileDisplayNature.GENERIC]: { meaning: 'Fallback bucket when a generic download affordance is enough.' },\n },\n }),\n\n width: schemaShape.width.numberSpec({ meaning: 'Image/video width in pixels when known.' }),\n height: schemaShape.height.numberSpec({ meaning: 'Image/video height in pixels when known.' }),\n duration: schemaShape.duration.numberSpec({ meaning: 'Audio/video length in seconds when analyzers provide it.' }),\n pageCount: schemaShape.pageCount.numberSpec({ meaning: 'Page count for paginated document previews when the analyzer could infer it.' }),\n\n thumbnailUrl: schemaShape.thumbnailUrl.stringSpec({\n meaning: 'Optional derived thumbnail or poster frame URL for list/grid UIs.',\n semanticRole: 'uri',\n }),\n\n linkedResourceType: schemaShape.linkedResourceType.stringSpec({\n meaning: 'When linked, the `CoreResourceType` (string form) of the parent record carrying the `z_file()` field.',\n semanticRole: 'code',\n }),\n\n linkedResourceId: schemaShape.linkedResourceId.stringSpec({\n meaning: 'Primary id of the parent resource using this file, when linked.',\n semanticRole: 'identifier',\n }),\n\n linkedFieldName: schemaShape.linkedFieldName.stringSpec({\n meaning: 'Field name on the parent schema (e.g. `avatarId`) to support multi-file parents.',\n semanticRole: 'code',\n }),\n\n primaryScope: schemaShape.primaryScope.enumSpec({\n meaning: 'Which isolation bucket this record participates in: app-wide, org-wide, or user-private (within an org).',\n whyItMatters:\n 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ResourcePrimaryScope',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ResourcePrimaryScope.APPLICATION]: { meaning: 'App-wide marketing/branding or singleton assets (uses `applicationId` only).' },\n [ResourcePrimaryScope.ORGANIZATIONS]: { meaning: 'Shared within a tenant; uses `organizationId` only.' },\n [ResourcePrimaryScope.USER_SELF]: { meaning: 'Private to a user, but still in org context; requires `organizationId` + `userId` per file scope rules.' },\n },\n }),\n\n applicationId: schemaShape.applicationId.stringSpec({\n meaning: 'Parent application id when `primaryScope` is `APPLICATION`.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.stringSpec({\n meaning: 'Org id for org-scoped files and as local context for user-private files.',\n semanticRole: 'identifier',\n }),\n\n userId: schemaShape.userId.stringSpec({\n meaning: 'User id for `USER_SELF` scoped file records, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',\n semanticRole: 'identifier',\n }),\n\n uploadedBy: schemaShape.uploadedBy.stringSpec({\n meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` record (service principal, system job, …).',\n semanticRole: 'identifier',\n }),\n\n uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({\n meaning: 'What kind of principal `uploadedBy` references so hydration code can disambiguate cross-entity uploaders.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileUploaderEntityType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileUploaderEntityType.USER]: { meaning: 'Uploader is a people identity from the `users` table.' },\n [FileUploaderEntityType.ANONYMOUS_USER]: { meaning: 'Uploader is an anonymous marketing-site session before account creation.' },\n [FileUploaderEntityType.ORGANIZATION_MACHINE]: { meaning: 'Uploader is an org-scoped MACHINE principal (M2M automation) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n [FileUploaderEntityType.APPLICATION_MACHINE]: { meaning: 'Uploader is an app-scoped MACHINE principal (integration jobs) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n },\n }),\n\n uploadedAt: schemaShape.uploadedAt.dateSpec({\n meaning: 'When the file bytes finished uploading to storage.',\n temporalRole: 'occurred',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'Last time metadata or link state on this document changed (excluding every storage adapter retry).',\n temporalRole: 'modified',\n }),\n\n deletedAt: schemaShape.deletedAt.dateSpec({\n meaning: 'When the file entered a soft-deleted / tombstone state for background purge.',\n temporalRole: 'occurred',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Resolve a single `File` row, usually when issuing download authorization or parent hydration.',\n outcome: 'Callers can trust storage pointers, status, and linkage fields before streaming bytes to the client.',\n whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata record for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized for the row’s scope — download authorization must still re-check the parent `z_file()` ACL; this row alone is not a permission boundary (see `businessConstraints`).' },\n ],\n idempotent: true,\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate file rows filtered by uploader, parent linkage, or scope in repository queries.',\n outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',\n whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata records matching the uploader / linkage / scope filters under org/app isolation.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },\n ],\n idempotent: true,\n },\n\n [Op.CREATE]: {\n purpose: 'Materialize a new metadata document for an upload flow; the database assigns the row’s identity (`_id`, projected as `fileId`) at insert, so the row — and its `fileId` — can be created before or after the bytes exist.',\n outcome: 'The system gets a first-class file row that can track upload progress, checksums, and eventual linking.',\n whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata record was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to upload into the requested scope (org/app/user-self isolation bucket).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a file row on upload start',\n request: {\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n organizationId: 'org_01HX2…',\n },\n response: {\n fileId: 'file_01HX2…',\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n status: FileStatus.PENDING,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n rateLimitNote: 'Upload materialization is the hot path for client file submissions; throttle per uploader/scope to bound abusive bulk-upload bursts against object storage.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Patch metadata (status, linkage, size, storage pointers, media analytics) as upload/analyze/link/cleanup events occur.',\n outcome: 'The row stays synchronized with object storage, AV/extraction, and the parent business record that references the file.',\n whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated record is returned. Internal/service write path owned by workers and trusted services.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails validation (e.g. an illegal `status` transition or a `linkedResource*` triple that breaks scope consistency).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A consumer caller attempts to mutate the row ad hoc — only workers and trusted services patch file metadata.' },\n ],\n idempotent: true,\n },\n\n [Op.DELETE]: {\n purpose: 'Mark or remove file metadata in coordination with object-storage deletion jobs.',\n outcome: 'The platform can enforce retention, GDPR erasure, and org teardown without orphan metadata references.',\n whenToUse: 'Use in compliance purges, org deletion, or when a business record severs a file attachment permanently.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The file metadata was soft-deleted / removed in coordination with object-storage cleanup; no body is returned. Internal/service path used in retention, GDPR erasure, and org teardown.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (or it was already deleted).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to delete files in the row’s scope.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'FILES declares NO `persistenceAdapter` — it follows the application default, so a file-metadata row and the resource row that owns it share one store and one native transaction (the pin that used to force MongoDB here was removed by the persistence-adapter parity work). This resource is precisely the case that must NOT declare one: it is written inside cross-resource atomic boundaries by design, so it could never make the `persistenceAdapterIsolation` claim that admits a divergent adapter.',\n 'Download authorization must still re-check the parent `z_file()` access policy: this row alone is not a permission boundary; `linkedResource*` fields and scope ids must be evaluated together with resource ACLs.',\n ],\n }),\n // Scope mirrors the registry-derived value: the `APPLICATION → FILES`\n // relationship in `resources-registry.shared.core.definitions.ts` carries\n // `isPrimaryScope: true` (applicationId is propagated to every file record\n // from the execution context), so the factory derives APPLICATION. Per-org /\n // per-user containment is enforced through the `linkedResource*` fields and\n // the parent `z_file()` access policy, not through the primary scope anchor.\n // Was ORGANIZATIONS until the companion alignment guard started pairing\n // engine specs with materialized core configs (2026-07-02) and flagged the\n // drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
|
|
1
|
+
{"version":3,"file":"files.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,UAAU,EACV,UAAU,EACV,gDAAgD,EAChD,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,CAC7D,gDAAgD,EAChD,UAAU,EACV,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE,2HAA2H;IACpI,YAAY,EAAE,+HAA+H;IAC7I,aAAa,EAAE,4JAA4J;IAC3K,QAAQ,EAAE,aAAa,CAAC,QAAQ;IAChC,SAAS,EAAE,uBAAuB,CAAC,KAAK;IACxC,YAAY,EAAE;QACZ,UAAU,EAAE;YACV,WAAW,EAAE,uBAAuB;YACpC,UAAU,EAAE,YAAY;YACxB,UAAU,EAAE,cAAc,CAAC,MAAM;YACjC,eAAe,EAAE,mBAAmB,CAAC,UAAU;SAChD;QACD,eAAe,EAAE;YACf,WAAW,EAAE,uBAAuB;YACpC,UAAU,EAAE,kDAAkD;YAC9D,UAAU,EAAE,cAAc,CAAC,OAAO;YAClC,eAAe,EAAE,mBAAmB,CAAC,QAAQ;SAC9C;QACD,YAAY,EAAE;YACZ,eAAe,EAAE;gBACf,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,kBAAkB;gBAC9B,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,UAAU,EAAE,OAAO;SACpB;QACD,mBAAmB,EAAE;YACnB,QAAQ,EAAE;gBACR,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,uBAAuB;gBACnC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;SACF;QACD,KAAK,EAAE;YACL,kJAAkJ;YAClJ,6OAA6O;SAC9O;KACF;IAED,MAAM,EAAE;QACN,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;YACpC,OAAO,EAAE,mSAAmS;YAC5S,YAAY,EAAE,mQAAmQ;YACjR,YAAY,EAAE,YAAY;YAC1B,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QAEF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,OAAO,EAAE,qDAAqD;YAC9D,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,OAAO;SACtB,CAAC;QAEF,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC;YACxD,OAAO,EAAE,0EAA0E;YACnF,YAAY,EAAE,OAAO;SACtB,CAAC;QAEF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,OAAO,EAAE,+EAA+E;YACxF,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC;YAChC,OAAO,EAAE,0DAA0D;YACnE,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QAEF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC;YAC1C,OAAO,EAAE,qFAAqF;YAC9F,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,OAAO,EAAE,4EAA4E;YACrF,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC;YACpD,OAAO,EAAE,6EAA6E;YACtF,eAAe,EAAE;gBACf,WAAW,EAAE,0BAA0B;gBACvC,UAAU,EAAE,qBAAqB;gBACjC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,wFAAwF,EAAE;gBAC1I,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,gFAAgF,EAAE;gBACpI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,+EAA+E,EAAE;gBAC5H,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,kSAAkS,EAAE;gBACnV,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,oEAAoE,EAAE;aACjH;SACF,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,yGAAyG;YAClH,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,wQAAwQ;YACjR,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;YAC9B,OAAO,EAAE,mGAAmG;YAC5G,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClC,OAAO,EAAE,kJAAkJ;YAC3J,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,eAAe,EAAE;gBACf,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,YAAY;gBACxB,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,oEAAoE,EAAE;gBACvG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,4DAA4D,EAAE;gBAChG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,0FAA0F,EAAE;gBAC5H,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,4DAA4D,EAAE;gBAC/F,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE;gBAC5G,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,4DAA4D,EAAE;gBAC9F,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE;gBAC5G,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE;gBACxE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,mDAAmD,EAAE;gBACvF,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,2DAA2D,EAAE;aACnG;SACF,CAAC;QAEF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClC,OAAO,EAAE,oHAAoH;YAC7H,eAAe,EAAE;gBACf,WAAW,EAAE,0BAA0B;gBACvC,UAAU,EAAE,mBAAmB;gBAC/B,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,oEAAoE,EAAE;gBAC5G,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE;gBAChH,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE;gBAClF,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE;gBAClG,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,+DAA+D,EAAE;aAC1G;SACF,CAAC;QAEF,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC3F,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;QAC9F,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,0DAA0D,EAAE,CAAC;QAClH,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,8EAA8E,EAAE,CAAC;QAExI,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC;YAChD,OAAO,EAAE,mEAAmE;YAC5E,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,kBAAkB,EAAE,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC;YAC5D,OAAO,EAAE,uGAAuG;YAChH,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC;YACxD,OAAO,EAAE,iEAAiE;YAC1E,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC;YACtD,OAAO,EAAE,kFAAkF;YAC3F,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,0GAA0G;YACnH,YAAY,EACV,4JAA4J;YAC9J,eAAe,EAAE;gBACf,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,sBAAsB;gBAClC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,8EAA8E,EAAE;gBAC/H,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,qDAAqD,EAAE;gBACxG,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,yGAAyG,EAAE;aACzJ;SACF,CAAC;QAEF,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC;YAClD,OAAO,EAAE,6DAA6D;YACtE,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC;YACpD,OAAO,EAAE,0EAA0E;YACnF,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;YACpC,OAAO,EAAE,0HAA0H;YACnI,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,iHAAiH;YAC1H,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,CAAC,QAAQ,CAAC;YAC9D,OAAO,EAAE,2GAA2G;YACpH,eAAe,EAAE;gBACf,WAAW,EAAE,0BAA0B;gBACvC,UAAU,EAAE,wBAAwB;gBACpC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE;gBACnG,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,0EAA0E,EAAE;gBAChI,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,0KAA0K,EAAE;gBACtO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,4KAA4K,EAAE;aACxO;SACF,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1C,OAAO,EAAE,oDAAoD;YAC7D,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QAEF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC;YACxC,OAAO,EAAE,oGAAoG;YAC7G,YAAY,EAAE,UAAU;SACzB,CAAC;QAEF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC;YACxC,OAAO,EAAE,8EAA8E;YACvF,YAAY,EAAE,UAAU;SACzB,CAAC;KACH;IAED,UAAU,EAAE;QACV,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;YACT,OAAO,EAAE,+FAA+F;YACxG,OAAO,EAAE,sGAAsG;YAC/G,SAAS,EAAE,sGAAsG;YACjH,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,uJAAuJ,EAAE;aAC1M;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,0HAA0H,EAAE;gBAChL,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,mMAAmM,EAAE;aAC1P;YACD,UAAU,EAAE,IAAI;SACjB;QAED,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;YACT,OAAO,EAAE,2FAA2F;YACpG,OAAO,EAAE,4FAA4F;YACrG,SAAS,EAAE,qFAAqF;YAChG,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,2HAA2H,EAAE;aAC9K;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,wFAAwF,EAAE;aAC/I;YACD,UAAU,EAAE,IAAI;SACjB;QAED,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACX,OAAO,EAAE,2NAA2N;YACpO,OAAO,EAAE,yGAAyG;YAClH,SAAS,EAAE,iGAAiG;YAC5G,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,WAAW,EAAE,OAAO,EAAE,qOAAqO,EAAE;aAC7R;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,eAAe,EAAE,IAAI,EAAE,mQAAmQ,EAAE,SAAS,EAAE,mBAAmB,EAAE;gBAC3V,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,uGAAuG,EAAE;aAC9J;YACD,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE;gBACR;oBACE,KAAK,EAAE,wCAAwC;oBAC/C,OAAO,EAAE;wBACP,QAAQ,EAAE,mBAAmB;wBAC7B,QAAQ,EAAE,iBAAiB;wBAC3B,IAAI,EAAE,MAAM;wBACZ,YAAY,EAAE,oBAAoB,CAAC,aAAa;wBAChD,cAAc,EAAE,YAAY;qBAC7B;oBACD,QAAQ,EAAE;wBACR,MAAM,EAAE,aAAa;wBACrB,QAAQ,EAAE,mBAAmB;wBAC7B,QAAQ,EAAE,iBAAiB;wBAC3B,IAAI,EAAE,MAAM;wBACZ,MAAM,EAAE,UAAU,CAAC,OAAO;wBAC1B,YAAY,EAAE,oBAAoB,CAAC,aAAa;qBACjD;oBACD,SAAS,EAAE,sBAAsB,CAAC,WAAW;iBAC9C;aACF;YACD,aAAa,EAAE,6JAA6J;SAC7K;QAED,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACX,OAAO,EAAE,wHAAwH;YACjI,OAAO,EAAE,yHAAyH;YAClI,SAAS,EAAE,2FAA2F;YACtG,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,6NAA6N,EAAE;aAChR;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,iEAAiE,EAAE;gBACvH,EAAE,IAAI,EAAE,sBAAsB,CAAC,eAAe,EAAE,IAAI,EAAE,+HAA+H,EAAE,SAAS,EAAE,mBAAmB,EAAE;gBACvN,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,8GAA8G,EAAE;aACrK;YACD,UAAU,EAAE,IAAI;SACjB;QAED,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACX,OAAO,EAAE,iFAAiF;YAC1F,OAAO,EAAE,wGAAwG;YACjH,SAAS,EAAE,yGAAyG;YACpH,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,cAAc,EAAE,OAAO,EAAE,yLAAyL,EAAE;aACpP;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,oFAAoF,EAAE;gBAC1I,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,kEAAkE,EAAE;aACzH;YACD,UAAU,EAAE,IAAI;SACjB;KACF;IAED,mBAAmB,EAAE;QACnB,gfAAgf;QAChf,oNAAoN;KACrN;CACF,CAAC;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,2EAA2E;AAC3E,SAAS;AACT,EAAE,oBAAoB,EAAE,oBAAoB,CAAC,WAAW,EAAE,CAC3D,CAAC","sourcesContent":["/**\n * Resource: `files` — Wildo SaaS engine specification (backend-only).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/files/files.shared.schemas.ts → `FileSchema`\n * - Factory: engine/saas-models/src/files/files.shared.resources-config.schemas.ts\n * → `filesResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none\n */\n\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n FileDisplayNature,\n FileStorageAccepted,\n FileUploaderEntityType,\n} from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n FileSchema,\n FileStatus,\n filesResourceConfiguration_InitializationFactory,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nexport const filesResourceSpecification = resourceSpecification(\n filesResourceConfiguration_InitializationFactory,\n FileSchema,\n ({ schemaShape }) => ({\n purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',\n businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',\n lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',\n audience: LabelAudience.END_USER,\n subDomain: EngineResourceSubDomain.FILES,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'filesResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'FILES',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Repository-only resource: all operations are `REPOSITORY_ONLY` — `FilesBackendService` is the intended entry point, not public CRUD controllers.',\n 'Per-record `primaryScope` + scope id fields can represent APPLICATION, ORGANIZATIONS, or USER_SELF rows; the resource-level `resourcePrimaryScope` declared here is the registry default for the FILES type, not every row’s dynamic scope.',\n ],\n },\n\n fields: {\n fileId: schemaShape.fileId.stringSpec({\n meaning: 'Stable public identifier for this file metadata document, embedded in storage keys and download URLs. It is a virtual projection of the document’s underlying Mongo `_id` (`fileId === String(_id)`), so the file has a single stored identity and there is no separate persisted `fileId` field.',\n whyItMatters: 'This is the identifier other resources store in `z_file()` fields and that presigned URL flows reference. Because it projects `_id`, the value is allocated by the database at insert time rather than minted before the row exists, so creation is insert-first.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n filename: schemaShape.filename.stringSpec({\n meaning: 'Sanitized filename used in UI and download headers.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'label',\n }),\n\n originalFilename: schemaShape.originalFilename.stringSpec({\n meaning: 'Original client-provided filename before sanitization for audit/support.',\n semanticRole: 'label',\n }),\n\n mimeType: schemaShape.mimeType.stringSpec({\n meaning: 'IANA-style MIME classification for validation, AV routing, and viewer choice.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n size: schemaShape.size.numberSpec({\n meaning: 'Byte length of the stored object after upload completes.',\n unit: 'bytes',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n extension: schemaShape.extension.stringSpec({\n meaning: 'Filename extension snapshot (without dot) for quick filtering when MIME is generic.',\n semanticRole: 'code',\n }),\n\n checksum: schemaShape.checksum.stringSpec({\n meaning: 'Optional content hash for deduplication and integrity checks after upload.',\n semanticRole: 'code',\n }),\n\n storageProvider: schemaShape.storageProvider.enumSpec({\n meaning: 'Which registered storage backend (S3-compatible, local, …) holds the bytes.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileStorageAccepted',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStorageAccepted.WILDO_MANAGED]: { meaning: 'Managed object storage (S3-compatible) selected by the platform default configuration.' },\n [FileStorageAccepted.LOCAL_DIRECTORY]: { meaning: 'Local filesystem directory for development or air-gapped single-node installs.' },\n [FileStorageAccepted.ONEDRIVE]: { meaning: 'Optional Microsoft OneDrive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.GOOGLE_DRIVE]: { meaning: 'Google Drive-backed storage: the bytes stay in the Drive of the person who linked (via the Drive picker) or uploaded the file, and are read through that person\\'s delegated grant — never an application credential. Deleting the row forgets the reference and leaves the file in their Drive.' },\n [FileStorageAccepted.DROPBOX]: { meaning: 'Optional Dropbox-backed storage when an app enables the connector.' },\n },\n }),\n\n storageRef: schemaShape.storageRef.stringSpec({\n meaning: 'Opaque handle the active storage adapter uses to retrieve bytes (bucket/key tuple is adapter-specific).',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'identifier',\n }),\n\n storageKey: schemaShape.storageKey.stringSpec({\n meaning: 'Derived, human-debuggable key encoding the scope path (`app/...`, `org/...`, `user/...`) and `fileId`, used in logs and migrations. Because it depends on the database-assigned `fileId`, it is populated immediately after insert and is optional at rest until then.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n url: schemaShape.url.stringSpec({\n meaning: 'Cached HTTP(S) URL when a long-lived public or CDN URL is available (may be presigned elsewhere).',\n semanticRole: 'uri',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk records.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata record exists, bytes not ready yet.' },\n [FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },\n [FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },\n [FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },\n [FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },\n [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this record.' },\n [FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },\n [FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },\n [FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },\n [FileStatus.QUARANTINED]: { meaning: 'Isolated for operator review; download blocked by policy.' },\n },\n }),\n\n nature: schemaShape.nature.enumSpec({\n meaning: 'Resolved high-level file kind (image / video / document) used for template selection, not raw MIME subtypes alone.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileDisplayNature',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileDisplayNature.IMAGE]: { meaning: 'Raster/vector still asset suitable for lightbox and thumbnail UIs.' },\n [FileDisplayNature.VIDEO]: { meaning: 'Time-based media; shows duration and streaming-friendly player chrome.' },\n [FileDisplayNature.AUDIO]: { meaning: 'Sound-only media with duration metadata.' },\n [FileDisplayNature.DOCUMENT]: { meaning: 'Text-first assets such as office/PDF/structured docs.' },\n [FileDisplayNature.GENERIC]: { meaning: 'Fallback bucket when a generic download affordance is enough.' },\n },\n }),\n\n width: schemaShape.width.numberSpec({ meaning: 'Image/video width in pixels when known.' }),\n height: schemaShape.height.numberSpec({ meaning: 'Image/video height in pixels when known.' }),\n duration: schemaShape.duration.numberSpec({ meaning: 'Audio/video length in seconds when analyzers provide it.' }),\n pageCount: schemaShape.pageCount.numberSpec({ meaning: 'Page count for paginated document previews when the analyzer could infer it.' }),\n\n thumbnailUrl: schemaShape.thumbnailUrl.stringSpec({\n meaning: 'Optional derived thumbnail or poster frame URL for list/grid UIs.',\n semanticRole: 'uri',\n }),\n\n linkedResourceType: schemaShape.linkedResourceType.stringSpec({\n meaning: 'When linked, the `CoreResourceType` (string form) of the parent record carrying the `z_file()` field.',\n semanticRole: 'code',\n }),\n\n linkedResourceId: schemaShape.linkedResourceId.stringSpec({\n meaning: 'Primary id of the parent resource using this file, when linked.',\n semanticRole: 'identifier',\n }),\n\n linkedFieldName: schemaShape.linkedFieldName.stringSpec({\n meaning: 'Field name on the parent schema (e.g. `avatarId`) to support multi-file parents.',\n semanticRole: 'code',\n }),\n\n primaryScope: schemaShape.primaryScope.enumSpec({\n meaning: 'Which isolation bucket this record participates in: app-wide, org-wide, or user-private (within an org).',\n whyItMatters:\n 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ResourcePrimaryScope',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ResourcePrimaryScope.APPLICATION]: { meaning: 'App-wide marketing/branding or singleton assets (uses `applicationId` only).' },\n [ResourcePrimaryScope.ORGANIZATIONS]: { meaning: 'Shared within a tenant; uses `organizationId` only.' },\n [ResourcePrimaryScope.USER_SELF]: { meaning: 'Private to a user, but still in org context; requires `organizationId` + `userId` per file scope rules.' },\n },\n }),\n\n applicationId: schemaShape.applicationId.stringSpec({\n meaning: 'Parent application id when `primaryScope` is `APPLICATION`.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.stringSpec({\n meaning: 'Org id for org-scoped files and as local context for user-private files.',\n semanticRole: 'identifier',\n }),\n\n userId: schemaShape.userId.stringSpec({\n meaning: 'User id for `USER_SELF` scoped file records, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',\n semanticRole: 'identifier',\n }),\n\n uploadedBy: schemaShape.uploadedBy.stringSpec({\n meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` record (service principal, system job, …).',\n semanticRole: 'identifier',\n }),\n\n uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({\n meaning: 'What kind of principal `uploadedBy` references so hydration code can disambiguate cross-entity uploaders.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileUploaderEntityType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileUploaderEntityType.USER]: { meaning: 'Uploader is a people identity from the `users` table.' },\n [FileUploaderEntityType.ANONYMOUS_USER]: { meaning: 'Uploader is an anonymous marketing-site session before account creation.' },\n [FileUploaderEntityType.ORGANIZATION_MACHINE]: { meaning: 'Uploader is an org-scoped MACHINE principal (M2M automation) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n [FileUploaderEntityType.APPLICATION_MACHINE]: { meaning: 'Uploader is an app-scoped MACHINE principal (integration jobs) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n },\n }),\n\n uploadedAt: schemaShape.uploadedAt.dateSpec({\n meaning: 'When the file bytes finished uploading to storage.',\n temporalRole: 'occurred',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'Last time metadata or link state on this document changed (excluding every storage adapter retry).',\n temporalRole: 'modified',\n }),\n\n deletedAt: schemaShape.deletedAt.dateSpec({\n meaning: 'When the file entered a soft-deleted / tombstone state for background purge.',\n temporalRole: 'occurred',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Resolve a single `File` row, usually when issuing download authorization or parent hydration.',\n outcome: 'Callers can trust storage pointers, status, and linkage fields before streaming bytes to the client.',\n whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata record for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized for the row’s scope — download authorization must still re-check the parent `z_file()` ACL; this row alone is not a permission boundary (see `businessConstraints`).' },\n ],\n idempotent: true,\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate file rows filtered by uploader, parent linkage, or scope in repository queries.',\n outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',\n whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata records matching the uploader / linkage / scope filters under org/app isolation.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },\n ],\n idempotent: true,\n },\n\n [Op.CREATE]: {\n purpose: 'Materialize a new metadata document for an upload flow; the database assigns the row’s identity (`_id`, projected as `fileId`) at insert, so the row — and its `fileId` — can be created before or after the bytes exist.',\n outcome: 'The system gets a first-class file row that can track upload progress, checksums, and eventual linking.',\n whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata record was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to upload into the requested scope (org/app/user-self isolation bucket).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a file row on upload start',\n request: {\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n organizationId: 'org_01HX2…',\n },\n response: {\n fileId: 'file_01HX2…',\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n status: FileStatus.PENDING,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n rateLimitNote: 'Upload materialization is the hot path for client file submissions; throttle per uploader/scope to bound abusive bulk-upload bursts against object storage.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Patch metadata (status, linkage, size, storage pointers, media analytics) as upload/analyze/link/cleanup events occur.',\n outcome: 'The row stays synchronized with object storage, AV/extraction, and the parent business record that references the file.',\n whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated record is returned. Internal/service write path owned by workers and trusted services.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails validation (e.g. an illegal `status` transition or a `linkedResource*` triple that breaks scope consistency).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A consumer caller attempts to mutate the row ad hoc — only workers and trusted services patch file metadata.' },\n ],\n idempotent: true,\n },\n\n [Op.DELETE]: {\n purpose: 'Mark or remove file metadata in coordination with object-storage deletion jobs.',\n outcome: 'The platform can enforce retention, GDPR erasure, and org teardown without orphan metadata references.',\n whenToUse: 'Use in compliance purges, org deletion, or when a business record severs a file attachment permanently.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The file metadata was soft-deleted / removed in coordination with object-storage cleanup; no body is returned. Internal/service path used in retention, GDPR erasure, and org teardown.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (or it was already deleted).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to delete files in the row’s scope.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'FILES declares NO `persistenceAdapter` — it follows the application default, so a file-metadata row and the resource row that owns it share one store and one native transaction (the pin that used to force MongoDB here was removed by the persistence-adapter parity work). This resource is precisely the case that must NOT declare one: it is written inside cross-resource atomic boundaries by design, so it could never make the `persistenceAdapterIsolation` claim that admits a divergent adapter.',\n 'Download authorization must still re-check the parent `z_file()` access policy: this row alone is not a permission boundary; `linkedResource*` fields and scope ids must be evaluated together with resource ACLs.',\n ],\n }),\n // Scope mirrors the registry-derived value: the `APPLICATION → FILES`\n // relationship in `resources-registry.shared.core.definitions.ts` carries\n // `isPrimaryScope: true` (applicationId is propagated to every file record\n // from the execution context), so the factory derives APPLICATION. Per-org /\n // per-user containment is enforced through the `linkedResource*` fields and\n // the parent `z_file()` access policy, not through the primary scope anchor.\n // Was ORGANIZATIONS until the companion alignment guard started pairing\n // engine specs with materialized core configs (2026-07-02) and flagged the\n // drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/engine/files/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}
|
package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"a2a-push-delivery-log.resource.specification.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"a2a-push-delivery-log.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AA+gB/B,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;iCAGvD,CAAC;AAEF,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;iCAG/D,CAAC;AAEF,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;iCAG9D,CAAC"}
|
package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"a2a-push-delivery-log.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n A2APushDeliveryLogSchema,\n A2APushDeliveryStatus,\n CoreResourceOperation as Op,\n CoreResourceType,\n ResourcePrimaryScope,\n a2aPushDeliveryLogPolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport { type CoreResourceTypeMemberName, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the `a2aPushDeliveryLog` POLYMORPHIC family: the durable\n * EVIDENCE that the agent attempted to notify a client's webhook when one of its Agent2Agent (A2A)\n * tasks changed state. One base envelope is stamped out as three variants, each owned by its\n * injected owner FK — mirroring the task resource's scope set exactly:\n * - `userA2aPushDeliveryLog` (USER_SELF — user-delegated A2A turns)\n * - `organizationA2aPushDeliveryLog` (ORGANIZATIONS — org-machine A2A turns)\n * - `applicationA2aPushDeliveryLog` (APPLICATION — app-machine A2A turns)\n *\n * A row is opened per (task transition × registered webhook) BEFORE the delivery is attempted, and\n * that ordering is the reason the resource exists at all: were the row created by the worker on its\n * first attempt, an unreachable queue would leave no trace, and an operator would see silence —\n * which is indistinguishable from \"no webhook was configured\". Writing first means there is always\n * one row per obligation, including the deliveries that never got as far as being tried.\n *\n * spec-cite: A2A 1.0 §4.3.3 — *\"Agents MUST attempt delivery at least once for each configured\n * webhook\"* — and §13.2, which asks for retry with exponential backoff and permits abandoning after\n * a configured number of consecutive failures. This row is where all three become CHECKABLE rather\n * than asserted.\n *\n * SIBLING, NOT A VARIANT, of `m2mWebhookDeliveryLog`. The two share a delivery PATTERN — row first,\n * one queue job per row, a worker that classifies and retries — and even the transport primitive.\n * What they do not share is a SCOPE SET: the M2M log is stamped out for ORGANIZATIONS and\n * APPLICATION only, while an A2A task can be owned by a USER, which is the ORDINARY case for a\n * delegated-user caller. Extending the M2M resource would have meant adding a user-facing variant to\n * a shipped feature on behalf of a different subsystem. Keeping them apart also keeps the two\n * producers separable in every query: a resource-operation notification and a task-lifecycle\n * notification are different facts about different things.\n *\n * ONE spec covers all three variants (per the flow-actor-tasks / token-budget polymorphic precedent).\n */\n\ntype A2APushDeliveryResourceType =\n | CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG;\ntype A2APushDeliveryResourceTypeMember = CoreResourceTypeMemberName<A2APushDeliveryResourceType>;\n\nconst a2aPushDeliveryPrimaryScopeByResourceType: Record<A2APushDeliveryResourceType, ResourcePrimaryScope> = {\n [CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.APPLICATION,\n};\n\ninterface A2APushDeliveryScopeExample {\n readonly deliveryResourceIdentity: Readonly<Record<string, string>>;\n readonly machineCredentialIdentity: Readonly<Record<string, string>>;\n readonly scopeIdentity: Readonly<Record<string, string>>;\n /** Human-readable prose fragment for example titles, not a semantic vocabulary. */\n readonly scopeLabel: string;\n}\n\n/**\n * Projects one semantic delivery scenario onto the concrete owner and route-id\n * fields of each polymorphic resource. Keeping this mapping beside the spec\n * prevents examples for one public contract from silently leaking a sibling's\n * `userId`, `organizationId`, `applicationId`, or resource-id parameter.\n */\nfunction createA2APushDeliveryScopeExample(resourceType: A2APushDeliveryResourceType): A2APushDeliveryScopeExample {\n switch (resourceType) {\n case CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { userA2aPushDeliveryLogId: 'a2a_delivery_user_01JEXAMPLE' },\n machineCredentialIdentity: {},\n scopeIdentity: { userId: 'user_01JEXAMPLE' },\n scopeLabel: 'user',\n };\n case CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { organizationA2aPushDeliveryLogId: 'a2a_delivery_org_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_org_01JEXAMPLE' },\n scopeIdentity: { organizationId: 'org_01JEXAMPLE' },\n scopeLabel: 'organization',\n };\n case CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { applicationA2aPushDeliveryLogId: 'a2a_delivery_app_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_app_01JEXAMPLE' },\n scopeIdentity: { applicationId: 'app_01JEXAMPLE' },\n scopeLabel: 'application',\n };\n default: {\n const exhaustiveResourceType: never = resourceType;\n throw new Error(`Unsupported A2A push-delivery resource type: ${String(exhaustiveResourceType)}`);\n }\n }\n}\n\nfunction createA2APushDeliveryPage<T>(data: readonly T[]) {\n return {\n data,\n pagination: { page: 1, limit: 20, total: data.length, totalPages: data.length === 0 ? 0 : 1 },\n };\n}\n\ntype Cfg = ReturnType<(typeof a2aPushDeliveryLogPolymorphicFactories)[CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof A2APushDeliveryLogSchema;\n\nfunction buildA2APushDeliveryLogResourceSpecification(\n resourceType: A2APushDeliveryResourceType,\n resourceTypeMemberName: A2APushDeliveryResourceTypeMember,\n) {\n const exampleScope = createA2APushDeliveryScopeExample(resourceType);\n const deliveryIdentity = {\n _id: Object.values(exampleScope.deliveryResourceIdentity)[0],\n deliveryId: 'delivery_attempt_01JEXAMPLE',\n taskId: 'task_01JEXAMPLE',\n pushNotificationConfigId: 'push_config_01JEXAMPLE',\n resourceServerInstanceRef: 'support-automation-agent',\n ...exampleScope.machineCredentialIdentity,\n httpUrl: 'https://integrations.customer.example/a2a/task-updates',\n payloadHash: 'c3e4db884cb42dd0ef818ae2ea032bdf3b45af622dbb39f9dc343b395874c8fc',\n payload: {\n statusUpdate: {\n taskId: 'task_01JEXAMPLE',\n contextId: 'support_case_INC_4821',\n status: { state: 'completed', timestamp: '2026-08-20T09:42:00.000Z' },\n final: true,\n },\n },\n createdAt: '2026-08-20T09:42:00.000Z',\n ...exampleScope.scopeIdentity,\n };\n const deliveredExample = {\n ...deliveryIdentity,\n status: A2APushDeliveryStatus.DELIVERED,\n attemptCount: 1,\n lastAttemptAt: '2026-08-20T09:42:03.000Z',\n responseStatus: 204,\n deliveredAt: '2026-08-20T09:42:03.000Z',\n };\n const retryingExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_retrying`,\n deliveryId: 'delivery_attempt_01JRETRY',\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 2,\n lastAttemptAt: '2026-08-20T09:44:00.000Z',\n nextAttemptAt: '2026-08-20T09:49:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503; another attempt is scheduled.',\n };\n const failedExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_failed`,\n deliveryId: 'delivery_attempt_01JFAILED',\n status: A2APushDeliveryStatus.FAILED,\n attemptCount: 5,\n lastAttemptAt: '2026-08-20T10:02:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503 after the final retry.',\n failedAt: '2026-08-20T10:02:00.000Z',\n };\n const pendingSummaryExample = {\n _id: `${deliveryIdentity._id}_pending`,\n deliveryId: 'delivery_attempt_01JPENDING',\n taskId: deliveryIdentity.taskId,\n pushNotificationConfigId: deliveryIdentity.pushNotificationConfigId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 0,\n createdAt: '2026-08-20T10:10:00.000Z',\n };\n const listRequest = {\n ...exampleScope.scopeIdentity,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n };\n\n return resourceSpecification<undefined, Core, Main>(\n a2aPushDeliveryLogPolymorphicFactories[resourceType],\n A2APushDeliveryLogSchema,\n ({ schemaShape }) => ({\n purpose: 'Record every attempt to notify a registered webhook that an A2A task changed state, so an integration owner can see whether the destination was reached.',\n businessRole: 'Operational history for diagnosing A2A push notifications by task, destination, status, attempt count, and HTTP outcome.',\n lifecycleRole: 'Created before the first delivery attempt, then progresses through pending and in-flight states to delivered or failed; retryable failures return to pending with a next-attempt time.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.FLOWS_ACTORS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryLogSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'a2aPushDeliveryLogPolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: resourceTypeMemberName,\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Three variants under `A2A_PUSH_DELIVERY_SCOPE_VARIANTS`, mirroring the task resource\\'s scope set exactly — an owner with no delivery-log variant is an owner whose notifications cannot be recorded.',\n 'MULTI-ROW: the declaration opts OUT of the singleton auto-business-key (`optOutPolymorphicAutoBusinessKey`) — there is one row per (task transition × registered webhook), so the owner FK is not its identity.',\n '`A2APushDeliveryStatus` is deliberately its OWN enum rather than a reuse of `M2MWebhookDeliveryLogStatus`, even though the members coincide: that enum is owned by the M2M notifications feature, and borrowing it would make either feature\\'s future state change a cross-feature edit.',\n 'Writers are `A2APushDispatcherBackendService` (opens the row) and the `a2a-push-delivery` batch worker (every status transition), both through `A2APushDeliveryLogRepository` and `*AsSystem` under this resource\\'s `systemAccessPolicy`. It follows the TASK service\\'s pattern rather than the M2M log\\'s because a push notification is triggered by `advanceTask` — a system-owned transition with no caller ExecutionContext to borrow.',\n 'CREATE and UPDATE are `INTERNAL_CALL`, which is MANDATORY rather than stylistic for a `*AsSystem` writer: those primitives dispatch through the SERVICE tier and resolve the operation via `getServiceOperationPathDefault`, which matches only INTERNAL_CALL / API_CALL variants. A REPOSITORY_ONLY default resolves to nothing and the write silently does not happen. DELETE / DELETE_MANY stay REPOSITORY_ONLY because nothing system-deletes a row — they are reached only by retention purging and the owner-scope cascade, both at the repository tier.',\n 'The webhook CREDENTIAL is never stored on a row: the worker re-resolves it from the live configuration at attempt time, so a client that rotates its credential (which §13.2 asks clients to do) does not have every queued retry keep presenting the stale one.',\n 'Runtime has no userNotifications / m2mNotifications — do not add communications.* (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Document id of this delivery record.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n deliveryId: schemaShape.deliveryId.stringSpec({\n meaning: 'Stable identity of this delivery, generated once when the record is opened and sent with every attempt.',\n whyItMatters: 'It is what makes duplicates RECOGNISABLE to the receiver. §4.3.3 asks clients to process notifications idempotently, which they can only do if a retry is identifiable as the same delivery — hence generated at row creation, never per attempt.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n taskId: schemaShape.taskId.stringSpec({\n meaning: 'The A2A task whose status transition triggered this notification.',\n whyItMatters: 'The join back to the work being reported on — an owner diagnosing a missed notification starts from the task they were expecting to hear about.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n pushNotificationConfigId: schemaShape.pushNotificationConfigId.stringSpec({\n meaning: 'Which registered webhook configuration this record delivers to — a task may carry several.',\n whyItMatters: 'Distinguishes \"one of my endpoints is broken\" from \"notifications are broken\", which are different incidents with different owners.',\n semanticRole: 'identifier',\n }),\n\n resourceServerInstanceRef: schemaShape.resourceServerInstanceRef.stringSpec({\n meaning: 'The named A2A agent instance the task belongs to.',\n whyItMatters: 'The isolation axis that keeps two agents of one tenant apart — the same axis the task read enforces, carried here so per-agent attribution and per-agent purging cannot reach another agent\\'s rows.',\n semanticRole: 'identifier',\n }),\n\n machineCredentialId: schemaShape.machineCredentialId.stringSpec({\n meaning: 'The machine credential that owns the task, when the caller presented one.',\n whyItMatters: 'The worker must re-read the LIVE configuration to obtain the client\\'s credential, and that read enforces all four isolation axes. Without this the read falls back to the \"no credential\" sentinel and matches nothing for any task a machine client created — which is most A2A tasks. Optional rather than sentinel-defaulted: a delegated-user task genuinely has none, and a sentinel would make \"absent\" and \"explicitly none\" the same value on a row whose whole job is to be evidence.',\n semanticRole: 'identifier',\n }),\n\n httpUrl: schemaShape.httpUrl.stringSpec({\n meaning: 'The webhook destination, captured as it was AT DISPATCH.',\n whyItMatters: 'Recorded on the row rather than read live so a later configuration edit cannot rewrite history — the evidence must say where this delivery was actually addressed. It is also why the worker POSTs to the row\\'s URL, not the configuration\\'s: honouring an edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n semanticRole: 'uri',\n }),\n\n payloadHash: schemaShape.payloadHash.stringSpec({\n meaning: 'SHA-256 of the exact body sent, so a recorded delivery can be tied to precise bytes.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Where this delivery is in its lifecycle: PENDING, IN_FLIGHT, DELIVERED or FAILED.',\n whyItMatters: 'The one field that answers \"was my integration reached?\". The PENDING → IN_FLIGHT claim is a compare-and-swap, so a duplicate queue message cannot cause a second POST to a customer endpoint.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [A2APushDeliveryStatus.PENDING]: { meaning: 'The record is open and either waiting for its first attempt or re-queued for another after a retryable failure.' },\n [A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the record (PENDING → IN_FLIGHT compare-and-swap) and is POSTing to the webhook.' },\n [A2APushDeliveryStatus.DELIVERED]: { meaning: 'The endpoint answered 2xx — terminal success, and the evidence that §4.3.3 delivery obligation was met.' },\n [A2APushDeliveryStatus.FAILED]: { meaning: 'Terminal failure: a non-retryable response, or the §13.2 attempt budget exhausted.' },\n },\n }),\n\n attemptCount: schemaShape.attemptCount.numberSpec({\n meaning: 'How many POST attempts have been made for this delivery.',\n whyItMatters: 'Bounds the retry schedule — the worker terminates the row as FAILED once the cap is reached, which is the §13.2 allowance to stop after a configured number of consecutive failures.',\n unit: 'attempts',\n }),\n\n lastAttemptAt: schemaShape.lastAttemptAt.dateSpec({\n meaning: 'When the most recent attempt was made.',\n temporalRole: 'occurred',\n }),\n\n nextAttemptAt: schemaShape.nextAttemptAt.dateSpec({\n meaning: 'When the next retry becomes eligible, under the exponential backoff schedule.',\n whyItMatters: 'Indexed — this is the field a drain query orders by, and the durable form of the backoff §13.2 asks for.',\n temporalRole: 'scheduled',\n }),\n\n responseStatus: schemaShape.responseStatus.numberSpec({\n meaning: 'The HTTP status the webhook answered with, when it answered at all.',\n whyItMatters: 'Only 2xx acknowledges receipt. A 3xx is NOT success: a redirect on a webhook is either a misconfiguration or an attempt to move our authenticated POST somewhere the SSRF guard never inspected.',\n }),\n\n responseBodyTruncated: schemaShape.responseBodyTruncated.stringSpec({\n meaning: 'A capped slice of the webhook\\'s response body, kept for diagnosis.',\n whyItMatters: 'Capped deliberately: a webhook is a third party\\'s endpoint and its error body is attacker-influenced in the general case, so an uncapped copy would let the RECEIVER decide how much of our storage one failed delivery consumes.',\n }),\n\n failureReason: schemaShape.failureReason.stringSpec({\n meaning: 'Why the delivery failed — a transport error, or the status the endpoint returned.',\n whyItMatters: 'The field an owner searches when asking \"why did my webhook stop working\", which is the question this resource exists to answer.',\n }),\n\n deliveredAt: schemaShape.deliveredAt.dateSpec({\n meaning: 'When the webhook acknowledged the notification with a 2xx.',\n temporalRole: 'occurred',\n }),\n\n failedAt: schemaShape.failedAt.dateSpec({\n meaning: 'When the delivery was abandoned — a non-retryable response, or the attempt cap.',\n temporalRole: 'occurred',\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the record was opened, which is BEFORE the first delivery attempt.',\n temporalRole: 'creation',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Inspect the destination, task update, status, attempt history, and latest HTTP outcome for one A2A push delivery.',\n outcome: 'The integration owner can determine whether the notification arrived and, when it did not, see the recorded failure evidence.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The delivery was found and its destination, task update, lifecycle status, attempts, and available HTTP outcome are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to inspect A2A push-delivery history in this user, organization, or application scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The delivery id does not exist in this scope, including when it belongs to another scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Inspect a terminal failure for the ${exampleScope.scopeLabel} integration`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: failedExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Inspect a delivered ${exampleScope.scopeLabel} notification with context`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: deliveredExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Inspect a pending ${exampleScope.scopeLabel} delivery summary`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: pendingSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Browse an owner\\'s recent notification deliveries.',\n outcome: 'An operator sees the delivery history for their integrations in one place, including the attempts that never left the queue.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of A2A push deliveries in this scope is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to browse A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Browse delivered and retrying ${exampleScope.scopeLabel} notifications`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample, retryingExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Browse ${exampleScope.scopeLabel} deliveries with relationship context`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Browse compact ${exampleScope.scopeLabel} delivery summaries`,\n request: listRequest,\n response: createA2APushDeliveryPage([pendingSummaryExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Filter deliveries by status, task, agent instance or date.',\n outcome: 'An owner can answer \"which of my notifications failed, and why\" without reading every row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of deliveries matching the supplied status, task, agent-instance, text, date, and pagination filters is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A filter value fails validation (e.g. an unknown status).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to search A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Find terminal failures for one ${exampleScope.scopeLabel} task`,\n request: {\n ...exampleScope.scopeIdentity,\n q: 'receiver returned HTTP 503',\n status: A2APushDeliveryStatus.FAILED,\n taskId: deliveryIdentity.taskId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n },\n response: createA2APushDeliveryPage([failedExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n\n [Op.CREATE]: {\n purpose: 'Open a PENDING row for one (task transition × registered webhook), before any delivery is attempted.',\n outcome: 'Every delivery obligation is recorded up front, so an unreachable queue leaves a visible row rather than silence.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery record was opened. REPOSITORY_ONLY — a delivery record is EVIDENCE that a notification was attempted, and a caller able to author one could fabricate that evidence. The dispatcher writes it via `createAsSystem`; there is no HTTP surface at all.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `deliveryId` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n },\n\n [Op.UPDATE]: {\n purpose: 'Advance a delivery through its lifecycle — claim it, then record the outcome.',\n outcome: 'The row reflects what actually happened to the notification, including scheduled retries.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the record.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The row is gone, or another worker already claimed it — the compare-and-swap matched nothing, and the loser stops rather than sending a duplicate POST.' },\n ],\n idempotent: false,\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a delivery row — retention purging, and the cleanup the owning user/org/app deletion cascades to.',\n outcome: 'Delivery evidence does not outlive the tenant it describes.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The record was removed. REPOSITORY_ONLY and deliberately NOT offered to the owner: a trail an owner can selectively erase is not a trail. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No such row (already purged, or never existed).' },\n ],\n idempotent: true,\n },\n\n [Op.UPDATE_MANY]: {\n purpose: 'In-place scrub of retained rows when a data subject is erased.',\n outcome: 'The delivery history survives for operational accounting while the personal data in it does not.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were scrubbed. INTERNAL_CALL — it registers no HTTP route, and exists because `retentionPolicy` reaches records through `updateManyAsSystem`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n },\n [Op.DELETE_MANY]: {\n purpose: 'Bulk removal for retention windows and owner-scope teardown.',\n outcome: 'Delivery history is bounded without a per-row round trip.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were removed. REPOSITORY_ONLY, the bulk twin of DELETE and restricted for the same reason.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'The notification BODY is an A2A `StreamResponse` carrying a `statusUpdate` event, never a whole `Task`. Both are conformant under §4.3.3, but a Task echoes the entire conversation — including message content — to an endpoint that only needed to learn the task finished, which would turn a stolen or mistyped webhook URL into a transcript exfiltration channel. The stored `payload` therefore holds status facts only.',\n 'A row is opened BEFORE the delivery is attempted, never by the worker on first contact. That ordering is the resource\\'s entire value: an unreachable queue must leave a visible PENDING row rather than silence, because silence is indistinguishable from \"no webhook was configured\".',\n 'One row per (task transition × registered webhook). A task carrying several configurations produces several rows for one transition, and a failure on one endpoint never suppresses the others.',\n 'The webhook CREDENTIAL is never persisted here. It is re-resolved from the live configuration at attempt time, so a client that rotates its credential does not have every queued retry keep presenting the stale one. The cost — a configuration deleted mid-flight ends the delivery — is the correct outcome: the client asked to stop being notified there.',\n 'The destination is captured at dispatch and the worker POSTs to the ROW\\'s URL, not the configuration\\'s. Honouring a URL edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n 'Only 2xx acknowledges receipt. 3xx is treated as a failure rather than followed, because a redirect on a webhook is either a misconfiguration or an attempt to move an authenticated POST past the URL validation entirely.',\n 'READ / LIST / SEARCH are owner-level, not admin-gated: a row names a webhook the owner registered and its outcome, and carries no message content by construction (the payload is a `statusUpdate` event, never a whole `Task`). Forcing an owner to an administrator to diagnose their own endpoint helps nobody.',\n 'Every WRITE is REPOSITORY_ONLY. A delivery row is evidence a notification was attempted: a caller able to CREATE one could fabricate that evidence, and one able to UPDATE could mark its own undelivered notifications DELIVERED. There is deliberately no external single-row delete either.',\n 'There is NO owner-facing retry operation, unlike the M2M delivery log. There, retry is an administrator repairing their own integration; here the caller is an external agent client, and letting it re-fire deliveries on demand would hand it an amplifier pointed at a URL it also chose. Retries belong to the worker\\'s backoff schedule.',\n 'Rows are cascade-deleted with the owning scope (COMPOSITION, IMMEDIATE) rather than retained the way billing records are. A delivery log carries no financial or statutory obligation, and retaining it would leave a tenant\\'s webhook URLs — their own infrastructure addresses — alive after erasure.',\n 'A delivery row is owned by exactly ONE scope; the polymorphic owner FK is injected on each concrete variant schema, not on `A2APushDeliveryLogSchema` itself, and the owner primary-scope filter must never expose another tenant\\'s deliveries.',\n ],\n }),\n // The owner is the injected scope FK, anchored by the `<SCOPE> → *A2aPushDeliveryLog`\n // primary-scope COMPOSITION edge in `resources-registry.shared.core.definitions.ts`\n // (generated by `createPolymorphicScopeRelationships`, default MANY cardinality). The registry\n // factory derives the scope from `isPrimaryScope: true`; this declaration feeds the spec ↔\n // registry alignment guard and must match per variant.\n { resourcePrimaryScope: a2aPushDeliveryPrimaryScopeByResourceType[resourceType] },\n );\n}\n\nexport const userA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG,\n 'USER_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const organizationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG,\n 'ORGANIZATION_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const applicationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG,\n 'APPLICATION_A2A_PUSH_DELIVERY_LOG',\n);\n"]}
|
|
1
|
+
{"version":3,"file":"a2a-push-delivery-log.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n A2APushDeliveryLogSchema,\n A2APushDeliveryStatus,\n CoreResourceOperation as Op,\n CoreResourceType,\n ResourcePrimaryScope,\n a2aPushDeliveryLogPolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport { type CoreResourceTypeMemberName, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the `a2aPushDeliveryLog` POLYMORPHIC family: the durable\n * EVIDENCE that the agent attempted to notify a client's webhook when one of its Agent2Agent (A2A)\n * tasks changed state. One base envelope is stamped out as three variants, each owned by its\n * injected owner FK — mirroring the task resource's scope set exactly:\n * - `userA2aPushDeliveryLog` (USER_SELF — user-delegated A2A turns)\n * - `organizationA2aPushDeliveryLog` (ORGANIZATIONS — org-machine A2A turns)\n * - `applicationA2aPushDeliveryLog` (APPLICATION — app-machine A2A turns)\n *\n * A row is opened per (task transition × registered webhook) BEFORE the delivery is attempted, and\n * that ordering is the reason the resource exists at all: were the row created by the worker on its\n * first attempt, an unreachable queue would leave no trace, and an operator would see silence —\n * which is indistinguishable from \"no webhook was configured\". Writing first means there is always\n * one row per obligation, including the deliveries that never got as far as being tried.\n *\n * spec-cite: A2A 1.0 §4.3.3 — *\"Agents MUST attempt delivery at least once for each configured\n * webhook\"* — and §13.2, which asks for retry with exponential backoff and permits abandoning after\n * a configured number of consecutive failures. This row is where all three become CHECKABLE rather\n * than asserted.\n *\n * SIBLING, NOT A VARIANT, of `m2mWebhookDeliveryLog`. The two share a delivery PATTERN — row first,\n * one queue job per row, a worker that classifies and retries — and even the transport primitive.\n * What they do not share is a SCOPE SET: the M2M log is stamped out for ORGANIZATIONS and\n * APPLICATION only, while an A2A task can be owned by a USER, which is the ORDINARY case for a\n * delegated-user caller. Extending the M2M resource would have meant adding a user-facing variant to\n * a shipped feature on behalf of a different subsystem. Keeping them apart also keeps the two\n * producers separable in every query: a resource-operation notification and a task-lifecycle\n * notification are different facts about different things.\n *\n * ONE spec covers all three variants (per the flow-actor-tasks / token-budget polymorphic precedent).\n */\n\ntype A2APushDeliveryResourceType =\n | CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG;\ntype A2APushDeliveryResourceTypeMember = CoreResourceTypeMemberName<A2APushDeliveryResourceType>;\n\nconst a2aPushDeliveryPrimaryScopeByResourceType: Record<A2APushDeliveryResourceType, ResourcePrimaryScope> = {\n [CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.APPLICATION,\n};\n\ninterface A2APushDeliveryScopeExample {\n readonly deliveryResourceIdentity: Readonly<Record<string, string>>;\n readonly machineCredentialIdentity: Readonly<Record<string, string>>;\n readonly scopeIdentity: Readonly<Record<string, string>>;\n /** Human-readable prose fragment for example titles, not a semantic vocabulary. */\n readonly scopeLabel: string;\n}\n\n/**\n * Projects one semantic delivery scenario onto the concrete owner and route-id\n * fields of each polymorphic resource. Keeping this mapping beside the spec\n * prevents examples for one public contract from silently leaking a sibling's\n * `userId`, `organizationId`, `applicationId`, or resource-id parameter.\n */\nfunction createA2APushDeliveryScopeExample(resourceType: A2APushDeliveryResourceType): A2APushDeliveryScopeExample {\n switch (resourceType) {\n case CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { userA2aPushDeliveryLogId: 'a2a_delivery_user_01JEXAMPLE' },\n machineCredentialIdentity: {},\n scopeIdentity: { userId: 'user_01JEXAMPLE' },\n scopeLabel: 'user',\n };\n case CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { organizationA2aPushDeliveryLogId: 'a2a_delivery_org_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_org_01JEXAMPLE' },\n scopeIdentity: { organizationId: 'org_01JEXAMPLE' },\n scopeLabel: 'organization',\n };\n case CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { applicationA2aPushDeliveryLogId: 'a2a_delivery_app_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_app_01JEXAMPLE' },\n scopeIdentity: { applicationId: 'app_01JEXAMPLE' },\n scopeLabel: 'application',\n };\n default: {\n const exhaustiveResourceType: never = resourceType;\n throw new Error(`Unsupported A2A push-delivery resource type: ${String(exhaustiveResourceType)}`);\n }\n }\n}\n\nfunction createA2APushDeliveryPage<T>(data: readonly T[]) {\n return {\n data,\n pagination: { page: 1, limit: 20, total: data.length, totalPages: data.length === 0 ? 0 : 1 },\n };\n}\n\ntype Cfg = ReturnType<(typeof a2aPushDeliveryLogPolymorphicFactories)[CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof A2APushDeliveryLogSchema;\n\nfunction buildA2APushDeliveryLogResourceSpecification(\n resourceType: A2APushDeliveryResourceType,\n resourceTypeMemberName: A2APushDeliveryResourceTypeMember,\n) {\n const exampleScope = createA2APushDeliveryScopeExample(resourceType);\n const deliveryIdentity = {\n _id: Object.values(exampleScope.deliveryResourceIdentity)[0],\n deliveryId: 'delivery_attempt_01JEXAMPLE',\n taskId: 'task_01JEXAMPLE',\n pushNotificationConfigId: 'push_config_01JEXAMPLE',\n resourceServerInstanceRef: 'support-automation-agent',\n ...exampleScope.machineCredentialIdentity,\n httpUrl: 'https://integrations.customer.example/a2a/task-updates',\n payloadHash: 'c3e4db884cb42dd0ef818ae2ea032bdf3b45af622dbb39f9dc343b395874c8fc',\n payload: {\n statusUpdate: {\n taskId: 'task_01JEXAMPLE',\n contextId: 'support_case_INC_4821',\n status: { state: 'completed', timestamp: '2026-08-20T09:42:00.000Z' },\n final: true,\n },\n },\n createdAt: '2026-08-20T09:42:00.000Z',\n ...exampleScope.scopeIdentity,\n };\n const deliveredExample = {\n ...deliveryIdentity,\n status: A2APushDeliveryStatus.DELIVERED,\n attemptCount: 1,\n lastAttemptAt: '2026-08-20T09:42:03.000Z',\n responseStatus: 204,\n deliveredAt: '2026-08-20T09:42:03.000Z',\n };\n const retryingExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_retrying`,\n deliveryId: 'delivery_attempt_01JRETRY',\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 2,\n lastAttemptAt: '2026-08-20T09:44:00.000Z',\n nextAttemptAt: '2026-08-20T09:49:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503; another attempt is scheduled.',\n };\n const failedExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_failed`,\n deliveryId: 'delivery_attempt_01JFAILED',\n status: A2APushDeliveryStatus.FAILED,\n attemptCount: 5,\n lastAttemptAt: '2026-08-20T10:02:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503 after the final retry.',\n failedAt: '2026-08-20T10:02:00.000Z',\n };\n const pendingSummaryExample = {\n _id: `${deliveryIdentity._id}_pending`,\n deliveryId: 'delivery_attempt_01JPENDING',\n taskId: deliveryIdentity.taskId,\n pushNotificationConfigId: deliveryIdentity.pushNotificationConfigId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 0,\n createdAt: '2026-08-20T10:10:00.000Z',\n };\n const listRequest = {\n ...exampleScope.scopeIdentity,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n };\n\n return resourceSpecification<undefined, Core, Main>(\n a2aPushDeliveryLogPolymorphicFactories[resourceType],\n A2APushDeliveryLogSchema,\n ({ schemaShape }) => ({\n purpose: 'Record every attempt to notify a registered webhook that an A2A task changed state, so an integration owner can see whether the destination was reached.',\n businessRole: 'Operational history for diagnosing A2A push notifications by task, destination, status, attempt count, and HTTP outcome.',\n lifecycleRole: 'Created before the first delivery attempt, then progresses through pending and in-flight states to delivered or failed; retryable failures return to pending with a next-attempt time.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.FLOWS_ACTORS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryLogSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'a2aPushDeliveryLogPolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: resourceTypeMemberName,\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Three variants under `A2A_PUSH_DELIVERY_SCOPE_VARIANTS`, mirroring the task resource\\'s scope set exactly — an owner with no delivery-log variant is an owner whose notifications cannot be recorded.',\n 'MULTI-ROW: the declaration opts OUT of the singleton auto-business-key (`optOutPolymorphicAutoBusinessKey`) — there is one row per (task transition × registered webhook), so the owner FK is not its identity.',\n '`A2APushDeliveryStatus` is deliberately its OWN enum rather than a reuse of `M2MWebhookDeliveryLogStatus`, even though the members coincide: that enum is owned by the M2M notifications feature, and borrowing it would make either feature\\'s future state change a cross-feature edit.',\n 'Writers are `A2APushDispatcherBackendService` (opens the row) and the `a2a-push-delivery` batch worker (every status transition), both through `A2APushDeliveryLogRepository` and `*AsSystem` under this resource\\'s `systemAccessPolicy`. It follows the TASK service\\'s pattern rather than the M2M log\\'s because a push notification is triggered by `advanceTask` — a system-owned transition with no caller ExecutionContext to borrow.',\n 'CREATE and UPDATE are `INTERNAL_CALL`, which is MANDATORY rather than stylistic for a `*AsSystem` writer: those primitives dispatch through the SERVICE tier and resolve the operation via `getServiceOperationPathDefault`, which matches only INTERNAL_CALL / API_CALL variants. A REPOSITORY_ONLY default resolves to nothing and the write silently does not happen. DELETE / DELETE_MANY stay REPOSITORY_ONLY because nothing system-deletes a row — they are reached only by retention purging and the owner-scope cascade, both at the repository tier.',\n 'The webhook CREDENTIAL is never stored on a row: the worker re-resolves it from the live configuration at attempt time, so a client that rotates its credential (which §13.2 asks clients to do) does not have every queued retry keep presenting the stale one.',\n 'Runtime has no userNotifications / m2mNotifications — do not add communications.* (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Document id of this delivery record.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n deliveryId: schemaShape.deliveryId.stringSpec({\n meaning: 'Stable identity of this delivery, generated once when the record is opened and sent with every attempt.',\n whyItMatters: 'It is what makes duplicates RECOGNISABLE to the receiver. §4.3.3 asks clients to process notifications idempotently, which they can only do if a retry is identifiable as the same delivery — hence generated at row creation, never per attempt.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n taskId: schemaShape.taskId.stringSpec({\n meaning: 'The A2A task whose status transition triggered this notification.',\n whyItMatters: 'The join back to the work being reported on — an owner diagnosing a missed notification starts from the task they were expecting to hear about.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n pushNotificationConfigId: schemaShape.pushNotificationConfigId.stringSpec({\n meaning: 'Which registered webhook configuration this record delivers to — a task may carry several.',\n whyItMatters: 'Distinguishes \"one of my endpoints is broken\" from \"notifications are broken\", which are different incidents with different owners.',\n semanticRole: 'identifier',\n }),\n\n resourceServerInstanceRef: schemaShape.resourceServerInstanceRef.stringSpec({\n meaning: 'The named A2A agent instance the task belongs to.',\n whyItMatters: 'The isolation axis that keeps two agents of one tenant apart — the same axis the task read enforces, carried here so per-agent attribution and per-agent purging cannot reach another agent\\'s rows.',\n semanticRole: 'identifier',\n }),\n\n machineCredentialId: schemaShape.machineCredentialId.stringSpec({\n meaning: 'The machine credential that owns the task, when the caller presented one.',\n whyItMatters: 'The worker must re-read the LIVE configuration to obtain the client\\'s credential, and that read enforces all four isolation axes. Without this the read falls back to the \"no credential\" sentinel and matches nothing for any task a machine client created — which is most A2A tasks. Optional rather than sentinel-defaulted: a delegated-user task genuinely has none, and a sentinel would make \"absent\" and \"explicitly none\" the same value on a row whose whole job is to be evidence.',\n semanticRole: 'identifier',\n }),\n\n httpUrl: schemaShape.httpUrl.stringSpec({\n meaning: 'The webhook destination, captured as it was AT DISPATCH.',\n whyItMatters: 'Recorded on the row rather than read live so a later configuration edit cannot rewrite history — the evidence must say where this delivery was actually addressed. It is also why the worker POSTs to the row\\'s URL, not the configuration\\'s: honouring an edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n semanticRole: 'uri',\n }),\n\n payloadHash: schemaShape.payloadHash.stringSpec({\n meaning: 'SHA-256 of the exact body sent, so a recorded delivery can be tied to precise bytes.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Where this delivery is in its lifecycle: PENDING, IN_FLIGHT, DELIVERED or FAILED.',\n whyItMatters: 'The one field that answers \"was my integration reached?\". The PENDING → IN_FLIGHT claim is a compare-and-swap, so a duplicate queue message cannot cause a second POST to a customer endpoint.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [A2APushDeliveryStatus.PENDING]: { meaning: 'The record is open and either waiting for its first attempt or re-queued for another after a retryable failure.' },\n [A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the record (PENDING → IN_FLIGHT compare-and-swap) and is POSTing to the webhook.' },\n [A2APushDeliveryStatus.DELIVERED]: { meaning: 'The endpoint answered 2xx — terminal success, and the evidence that §4.3.3 delivery obligation was met.' },\n [A2APushDeliveryStatus.FAILED]: { meaning: 'Terminal failure: a non-retryable response, or the §13.2 attempt budget exhausted.' },\n },\n }),\n\n attemptCount: schemaShape.attemptCount.numberSpec({\n meaning: 'How many POST attempts have been made for this delivery.',\n whyItMatters: 'Bounds the retry schedule — the worker terminates the row as FAILED once the cap is reached, which is the §13.2 allowance to stop after a configured number of consecutive failures.',\n unit: 'attempts',\n }),\n\n lastAttemptAt: schemaShape.lastAttemptAt.dateSpec({\n meaning: 'When the most recent attempt was made.',\n temporalRole: 'occurred',\n }),\n\n nextAttemptAt: schemaShape.nextAttemptAt.dateSpec({\n meaning: 'When the next retry becomes eligible, under the exponential backoff schedule.',\n whyItMatters: 'Indexed — this is the field a drain query orders by, and the durable form of the backoff §13.2 asks for.',\n temporalRole: 'scheduled',\n }),\n\n responseStatus: schemaShape.responseStatus.numberSpec({\n meaning: 'The HTTP status the webhook answered with, when it answered at all.',\n whyItMatters: 'Only 2xx acknowledges receipt. A 3xx is NOT success: a redirect on a webhook is either a misconfiguration or an attempt to move our authenticated POST somewhere the SSRF guard never inspected.',\n }),\n\n responseBodyTruncated: schemaShape.responseBodyTruncated.stringSpec({\n meaning: 'A capped slice of the webhook\\'s response body, kept for diagnosis.',\n whyItMatters: 'Capped deliberately: a webhook is a third party\\'s endpoint and its error body is attacker-influenced in the general case, so an uncapped copy would let the RECEIVER decide how much of our storage one failed delivery consumes.',\n }),\n\n failureReason: schemaShape.failureReason.stringSpec({\n meaning: 'Why the delivery failed — a transport error, or the status the endpoint returned.',\n whyItMatters: 'The field an owner searches when asking \"why did my webhook stop working\", which is the question this resource exists to answer.',\n }),\n\n deliveredAt: schemaShape.deliveredAt.dateSpec({\n meaning: 'When the webhook acknowledged the notification with a 2xx.',\n temporalRole: 'occurred',\n }),\n\n failedAt: schemaShape.failedAt.dateSpec({\n meaning: 'When the delivery was abandoned — a non-retryable response, or the attempt cap.',\n temporalRole: 'occurred',\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the record was opened, which is BEFORE the first delivery attempt.',\n temporalRole: 'creation',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Inspect the destination, task update, status, attempt history, and latest HTTP outcome for one A2A push delivery.',\n outcome: 'The integration owner can determine whether the notification arrived and, when it did not, see the recorded failure evidence.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The delivery was found and its destination, task update, lifecycle status, attempts, and available HTTP outcome are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to inspect A2A push-delivery history in this user, organization, or application scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The delivery id does not exist in this scope, including when it belongs to another scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Inspect a terminal failure for the ${exampleScope.scopeLabel} integration`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: failedExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Inspect a delivered ${exampleScope.scopeLabel} notification with context`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: deliveredExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Inspect a pending ${exampleScope.scopeLabel} delivery summary`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: pendingSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Browse an owner\\'s recent notification deliveries.',\n outcome: 'An operator sees the delivery history for their integrations in one place, including the attempts that never left the queue.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of A2A push deliveries in this scope is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to browse A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Browse delivered and retrying ${exampleScope.scopeLabel} notifications`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample, retryingExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Browse ${exampleScope.scopeLabel} deliveries with relationship context`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Browse compact ${exampleScope.scopeLabel} delivery summaries`,\n request: listRequest,\n response: createA2APushDeliveryPage([pendingSummaryExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Filter deliveries by status, task, agent instance or date.',\n outcome: 'An owner can answer \"which of my notifications failed, and why\" without reading every row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of deliveries matching the supplied status, task, agent-instance, text, date, and pagination filters is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A filter value fails validation (e.g. an unknown status).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to search A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Find terminal failures for one ${exampleScope.scopeLabel} task`,\n request: {\n ...exampleScope.scopeIdentity,\n q: 'receiver returned HTTP 503',\n status: A2APushDeliveryStatus.FAILED,\n taskId: deliveryIdentity.taskId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n },\n response: createA2APushDeliveryPage([failedExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n\n [Op.CREATE]: {\n purpose: 'Open a PENDING row for one (task transition × registered webhook), before any delivery is attempted.',\n outcome: 'Every delivery obligation is recorded up front, so an unreachable queue leaves a visible row rather than silence.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery record was opened. REPOSITORY_ONLY — a delivery record is EVIDENCE that a notification was attempted, and a caller able to author one could fabricate that evidence. The dispatcher writes it via `createAsSystem`; there is no HTTP surface at all.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `deliveryId` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n },\n\n [Op.UPDATE]: {\n purpose: 'Advance a delivery through its lifecycle — claim it, then record the outcome.',\n outcome: 'The row reflects what actually happened to the notification, including scheduled retries.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the record.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The row is gone, or another worker already claimed it — the compare-and-swap matched nothing, and the loser stops rather than sending a duplicate POST.' },\n ],\n idempotent: false,\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a delivery row — retention purging, and the cleanup the owning user/org/app deletion cascades to.',\n outcome: 'Delivery evidence does not outlive the tenant it describes.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The record was removed. REPOSITORY_ONLY and deliberately NOT offered to the owner: a trail an owner can selectively erase is not a trail. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No such row (already purged, or never existed).' },\n ],\n idempotent: true,\n },\n\n [Op.UPDATE_MANY]: {\n purpose: 'In-place scrub of retained rows when a data subject is erased.',\n outcome: 'The delivery history survives for operational accounting while the personal data in it does not.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were scrubbed. INTERNAL_CALL — it registers no HTTP route, and exists because `retentionPolicy` reaches records through `updateManyAsSystem`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n },\n [Op.DELETE_MANY]: {\n purpose: 'Bulk removal for retention windows and owner-scope teardown.',\n outcome: 'Delivery history is bounded without a per-row round trip.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were removed. REPOSITORY_ONLY, the bulk twin of DELETE and restricted for the same reason.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'The notification BODY is an A2A `StreamResponse` carrying a `statusUpdate` event, never a whole `Task`. Both are conformant under §4.3.3, but a Task echoes the entire conversation — including message content — to an endpoint that only needed to learn the task finished, which would turn a stolen or mistyped webhook URL into a transcript exfiltration channel. The stored `payload` therefore holds status facts only.',\n 'A row is opened BEFORE the delivery is attempted, never by the worker on first contact. That ordering is the resource\\'s entire value: an unreachable queue must leave a visible PENDING row rather than silence, because silence is indistinguishable from \"no webhook was configured\".',\n 'One row per (task transition × registered webhook). A task carrying several configurations produces several rows for one transition, and a failure on one endpoint never suppresses the others.',\n 'The webhook CREDENTIAL is never persisted here. It is re-resolved from the live configuration at attempt time, so a client that rotates its credential does not have every queued retry keep presenting the stale one. The cost — a configuration deleted mid-flight ends the delivery — is the correct outcome: the client asked to stop being notified there.',\n 'The destination is captured at dispatch and the worker POSTs to the ROW\\'s URL, not the configuration\\'s. Honouring a URL edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n 'Only 2xx acknowledges receipt. 3xx is treated as a failure rather than followed, because a redirect on a webhook is either a misconfiguration or an attempt to move an authenticated POST past the URL validation entirely.',\n 'READ / LIST / SEARCH are owner-level, not admin-gated: a row names a webhook the owner registered and its outcome, and carries no message content by construction (the payload is a `statusUpdate` event, never a whole `Task`). Forcing an owner to an administrator to diagnose their own endpoint helps nobody.',\n 'Every WRITE is REPOSITORY_ONLY. A delivery row is evidence a notification was attempted: a caller able to CREATE one could fabricate that evidence, and one able to UPDATE could mark its own undelivered notifications DELIVERED. There is deliberately no external single-row delete either.',\n 'There is NO owner-facing retry operation, unlike the M2M delivery log. There, retry is an administrator repairing their own integration; here the caller is an external agent client, and letting it re-fire deliveries on demand would hand it an amplifier pointed at a URL it also chose. Retries belong to the worker\\'s backoff schedule.',\n 'Rows are cascade-deleted with the owning scope (COMPOSITION, IMMEDIATE) rather than retained the way billing records are. A delivery log carries no financial or statutory obligation, and retaining it would leave a tenant\\'s webhook URLs — their own infrastructure addresses — alive after erasure.',\n 'A delivery row is owned by exactly ONE scope; the polymorphic owner FK is injected on each concrete variant schema, not on `A2APushDeliveryLogSchema` itself, and the owner primary-scope filter must never expose another tenant\\'s deliveries.',\n ],\n }),\n // The owner is the injected scope FK, anchored by the `<SCOPE> → *A2aPushDeliveryLog`\n // primary-scope COMPOSITION edge in `resources-registry.shared.core.definitions.ts`\n // (generated by `createPolymorphicScopeRelationships`, default MANY cardinality). The registry\n // factory derives the scope from `isPrimaryScope: true`; this declaration feeds the spec ↔\n // registry alignment guard and must match per variant.\n { resourcePrimaryScope: a2aPushDeliveryPrimaryScopeByResourceType[resourceType] },\n );\n}\n\nexport const userA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG,\n 'USER_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const organizationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG,\n 'ORGANIZATION_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const applicationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG,\n 'APPLICATION_A2A_PUSH_DELIVERY_LOG',\n);\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"a2a-token-budget-state.resource.specification.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"a2a-token-budget-state.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AAmR/B,eAAO,MAAM,4CAA4C;;;;;;;iCAGxD,CAAC;AAEF,eAAO,MAAM,oDAAoD;;;;;;;iCAGhE,CAAC;AAEF,eAAO,MAAM,mDAAmD;;;;;;;iCAG/D,CAAC"}
|
package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"a2a-token-budget-state.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n A2ATokenBudgetStateSchema,\n CoreResourceOperation as Op,\n CoreResourceType,\n ResourcePrimaryScope,\n a2aTokenBudgetStatePolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport { type CoreResourceTypeMemberName, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the `a2aTokenBudgetState` POLYMORPHIC SINGLETON\n * family: the per-tenant LLM **token budget accumulator** that lets the inbound\n * Agent2Agent (A2A) transport fail-closed BEFORE dispatch once a tenant has spent its\n * plan-granted period allowance. One base envelope is stamped out as three genuine\n * single-scope variants, each owned by its injected owner FK:\n * - `userA2aTokenBudgetState` (USER_SELF — user-delegated A2A turns)\n * - `organizationA2aTokenBudgetState` (ORGANIZATIONS — org-machine A2A turns)\n * - `applicationA2aTokenBudgetState` (APPLICATION — app-machine A2A turns)\n *\n * This is INTERNAL ENFORCEMENT STATE, not user-authored data. The A2A runtime\n * (`A2ATokenBudgetBackendService`) is the only writer — it opens the singleton on the\n * first budgeted turn (CREATE, INTERNAL_CALL super-admin via `*AsSystem`) and then\n * advances the counter through an ATOMIC repository-tier increment rather than a\n * service-tier update, so concurrent turns cannot lose tokens to a read-modify-write\n * race. That is why NO `UPDATE` operation is declared. The tenant's own surface is READ\n * only: an owner-level \"how much of my allowance have I used?\" view. DELETE exists solely\n * as the cascade teardown and is INTERNAL_CALL — it gets NO HTTP route at all, because\n * zeroing this row would reset a tenant's recorded spend (see the DELETE operation prose).\n *\n * TWO HALVES, DELIBERATELY SEPARATED: the ALLOWANCE (the cap) is NOT stored here — it\n * is resolved live from the tenant's billing plan via the `a2a.llm.tokensPerPeriod`\n * LIMIT feature (`A2A_TOKEN_BUDGET_FEATURE_ID`), so a plan upgrade/downgrade applies\n * immediately with no copy to keep in sync. This row accumulates CONSUMPTION only.\n *\n * ONE spec covers all three variants (per the flow-actor-executions / billing / SSO\n * polymorphic-spec precedent).\n */\n\ntype A2ABudgetResourceType =\n | CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE\n | CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE\n | CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE;\ntype A2ABudgetResourceTypeMember = CoreResourceTypeMemberName<A2ABudgetResourceType>;\n\nconst a2aBudgetPrimaryScopeByResourceType: Record<A2ABudgetResourceType, ResourcePrimaryScope> = {\n [CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE]: ResourcePrimaryScope.APPLICATION,\n};\n\ninterface A2ATokenBudgetScopeExample {\n readonly scopeIdentity: Readonly<Record<string, string>>;\n /** Human-readable prose fragment for example titles, not a semantic vocabulary. */\n readonly scopeLabel: string;\n}\n\n/**\n * Owns the concrete path and response FK for each polymorphic budget contract.\n * The budget semantics are shared, but the public scope identity is not: an\n * example for one tenant type must never teach a sibling's URL parameter.\n */\nfunction createA2ATokenBudgetScopeExample(resourceType: A2ABudgetResourceType): A2ATokenBudgetScopeExample {\n switch (resourceType) {\n case CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE:\n return { scopeIdentity: { userId: 'user_01JEXAMPLE' }, scopeLabel: 'user' };\n case CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE:\n return { scopeIdentity: { organizationId: 'org_01JEXAMPLE' }, scopeLabel: 'organization' };\n case CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE:\n return { scopeIdentity: { applicationId: 'app_01JEXAMPLE' }, scopeLabel: 'application' };\n default: {\n const exhaustiveResourceType: never = resourceType;\n throw new Error(`Unsupported A2A token-budget resource type: ${String(exhaustiveResourceType)}`);\n }\n }\n}\n\ntype Cfg = ReturnType<(typeof a2aTokenBudgetStatePolymorphicFactories)[CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof A2ATokenBudgetStateSchema;\n\nfunction buildA2ATokenBudgetStateResourceSpecification(\n resourceType: A2ABudgetResourceType,\n resourceTypeMemberName: A2ABudgetResourceTypeMember,\n) {\n const exampleScope = createA2ATokenBudgetScopeExample(resourceType);\n const currentBudgetExample = {\n _id: `a2a_budget_${exampleScope.scopeLabel}_01JEXAMPLE`,\n periodKey: '2026-08',\n consumedTokens: 72_450,\n lastTurnAt: '2026-08-20T11:18:42.000Z',\n createdAt: '2026-08-02T08:15:00.000Z',\n updatedAt: '2026-08-20T11:18:42.000Z',\n ...exampleScope.scopeIdentity,\n };\n const currentBudgetSummaryExample = {\n _id: currentBudgetExample._id,\n periodKey: currentBudgetExample.periodKey,\n consumedTokens: currentBudgetExample.consumedTokens,\n lastTurnAt: currentBudgetExample.lastTurnAt,\n };\n\n return resourceSpecification<undefined, Core, Main>(\n a2aTokenBudgetStatePolymorphicFactories[resourceType],\n A2ATokenBudgetStateSchema,\n ({ schemaShape }) => ({\n purpose: 'Report how many LLM tokens this user, organization, or application has consumed through inbound A2A agent turns in the current budget period.',\n businessRole: 'Current-period A2A consumption used with the plan allowance to decide whether another agent turn may start; the allowance itself is resolved separately and is not part of this response.',\n lifecycleRole: 'Created after the first budgeted A2A turn, incremented after completed turns, and reset in place when the period changes; this resource does not retain prior-period history.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.FLOWS_ACTORS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2ATokenBudgetStateSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'a2aTokenBudgetStatePolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: resourceTypeMemberName,\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Three variants under `A2A_TOKEN_BUDGET_SCOPE_VARIANTS` — user row is `USER_SELF`; org/app rows are `ORGANIZATIONS`/`APPLICATION` (machine-owned A2A).',\n 'SINGLETON: the injected owner FK is the auto business key, so the declaration deliberately does NOT opt out of the singleton auto-business-key. NOTE the uniqueness is index-enforced on MongoDB only — the SQL planner leaves index creation to migrations, so on PostgreSQL the one-row invariant is upheld by the runtime rather than the database (see businessConstraints).',\n 'The allowance is NOT persisted here: it is resolved live from the `a2a.llm.tokensPerPeriod` LIMIT feature (`A2A_TOKEN_BUDGET_FEATURE_ID` in `@wildo-ai/saas-models`) via feature resolution for the owner scope.',\n 'Sole runtime reader/writer is `A2ATokenBudgetBackendService` (`@wildo-ai/saas-backend-lib`); CREATE and READ go through `*AsSystem` under the resource\\'s `systemAccessPolicy`, while the counter is advanced by the atomic repository-tier increment primitive (there is deliberately no UPDATE operation).',\n 'Runtime has no userNotifications / m2mNotifications — do not add communications.* (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Document id of this tenant\\'s single A2A token-budget record.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n periodKey: schemaShape.periodKey.stringSpec({\n meaning: 'Stable id of the budget WINDOW this counter currently covers — a UTC calendar month (`YYYY-MM`) in v1.',\n whyItMatters: 'It is the reset boundary: when the runtime resolves a different current period, the accumulator resets `consumedTokens` and advances this key in place, so a stale period reads as zero consumption rather than carrying spend forward.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n consumedTokens: schemaShape.consumedTokens.numberSpec({\n meaning: 'Tokens (prompt + completion) this tenant\\'s A2A agent turns have consumed within `periodKey`.',\n whyItMatters: 'It is the single value the pre-dispatch gate compares against the plan allowance; once it reaches the allowance the transport denies further turns for the rest of the period.',\n unit: 'tokens',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n lastTurnAt: schemaShape.lastTurnAt.dateSpec({\n meaning: 'When the last A2A turn was recorded against this budget.',\n whyItMatters: 'Observability only — it lets an operator see whether a tenant is actively spending without reconstructing the turn log; nothing in the gate reads it.',\n temporalRole: 'occurred',\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the tenant\\'s budget record was first opened (its first budgeted A2A turn).',\n temporalRole: 'creation',\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'When the counter was last incremented or rolled to a new period.',\n temporalRole: 'modified',\n }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the tenant\\'s budget singleton on its first budgeted A2A turn.',\n outcome: 'The tenant has exactly one counter row, stamped with the current period and that first turn\\'s tokens, against which every later turn is measured.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The tenant\\'s single budget record was opened. Internal/system write path (INTERNAL_CALL, service-tier) — the A2A runtime writes on the tenant\\'s behalf via `createAsSystem`; there is no self-serve create surface.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `periodKey` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A concurrent turn already opened the tenant\\'s singleton — the injected owner FK is a unique business key, so only one racer creates. The accumulator swallows this and increments the winner\\'s row instead of surfacing the conflict to the turn.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-system caller attempts to create a budget row — the operation is INTERNAL_CALL with a super-admin floor, reachable only through the A2A runtime.' },\n ],\n idempotent: false,\n },\n\n [Op.READ]: {\n purpose: 'Read the current A2A token-consumption period, consumed-token count, and latest recorded turn for this scope.',\n outcome: 'The integration owner can monitor current-period A2A consumption without treating this state as the plan allowance or as historical usage.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The current consumption state for this scope is returned, including its period key, consumed tokens, and latest recorded turn when available.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to inspect A2A consumption for this user, organization, or application scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No budgeted A2A turn has been recorded for this scope yet, or the requested scope belongs to another owner.' },\n ],\n idempotent: true,\n examples: [{\n title: `Inspect current ${exampleScope.scopeLabel} A2A consumption`,\n request: exampleScope.scopeIdentity,\n response: currentBudgetExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Inspect current ${exampleScope.scopeLabel} A2A consumption with context`,\n request: exampleScope.scopeIdentity,\n response: currentBudgetExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Inspect the compact ${exampleScope.scopeLabel} A2A consumption summary`,\n request: exampleScope.scopeIdentity,\n response: currentBudgetSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n // No UPDATE operation is declared, deliberately: advancing the counter after a turn\n // (increment, or roll the period in place) is an ATOMIC repository-tier increment, not a\n // service-tier update, precisely so concurrent turns cannot lose tokens to a\n // read-modify-write race. Documenting an UPDATE here would describe a write path that does\n // not exist and invite routing the counter through it.\n\n [Op.DELETE]: {\n purpose: 'Remove a tenant\\'s budget row — platform teardown, and the cleanup the owning user/org/app deletion cascades to.',\n outcome: 'The counter row is physically removed, so a deleted tenant leaves no orphaned enforcement state behind.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The budget record was removed. The role floor is deliberately PLATFORM-ONLY (`APP_ADMIN_SUPER_ADMIN`) — NOT the owner-read roles and NOT an org admin: deleting this record zeroes the tenant\\'s recorded consumption, which is a spend-cap bypass. Read-authority does not imply delete-authority here, because the counter is enforcement state ABOUT the tenant rather than data BELONGING to it. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks and is therefore unaffected by the floor.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No budget row exists for the targeted tenant (it never ran a budgeted turn, or it was already removed).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A caller below the platform super-admin floor — including the owning tenant\\'s own admin — attempts to delete the row and reset its recorded spend.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'One row per tenant: the injected owner FK (`userId` / `organizationId` / `applicationId`) is the unique business key (database-enforced on MongoDB only — see the PostgreSQL caveat below). The period lives INSIDE the row and is rolled in place, so the resource holds current-period state only — per-period history and multi-budget-feature accounting are documented follow-ons.',\n 'The plan ALLOWANCE is never stored here. It is resolved live from the `a2a.llm.tokensPerPeriod` LIMIT feature for the owner scope, so a plan change takes effect on the next turn with no copy to reconcile. This resource is the CONSUMPTION half only.',\n 'This is internal enforcement state, not user-authored data: only the A2A runtime writes it. It CREATES the row via `*AsSystem` (INTERNAL_CALL, super-admin, under the resource\\'s `systemAccessPolicy`), then advances the counter through an ATOMIC repository-tier increment rather than an update operation — which is why no UPDATE operation is declared at all. The tenant\\'s only surface is reading its own consumption.',\n 'DELETE authority is strictly platform-level and intentionally diverges from read authority: zeroing recorded consumption would let a tenant admin reset their own spend cap at will.',\n 'The budget window is a UTC calendar month (`YYYY-MM`) in v1 — deterministic and free of a per-turn billing-account lookup on the hot path. Anchoring the window to the tenant\\'s actual subscription period is a documented follow-on, isolated to the single function that resolves the current period key.',\n 'Overage is bounded but is NOT a single turn: usage is only known AFTER a turn completes and recording is fire-and-forget, so every turn already in flight when the allowance is reached passes the gate on the same reading. The burst throttle that bounds it is per-PRINCIPAL while the budget is per-TENANT, so a tenant with many members or machine credentials can overshoot proportionally to how many act at once. Pre-charging an estimate was rejected because it would require a refund/reconcile path on every turn.',\n 'Accumulation is adapter-portable: the counter is advanced through a per-adapter atomic increment primitive (a single document update on MongoDB, a single `UPDATE … RETURNING` on PostgreSQL) rather than raw MongoDB operators, so a concurrent increment cannot be lost to a read-modify-write race on either backend. Both arms are covered by real-database integration tests, including the concurrent compare-and-set on a REAL PostgreSQL: a racing writer holds the row lock while a guarded reset blocks on it, and on resuming the reset correctly matches nothing rather than overwriting the racer\\'s accumulated total. The in-memory SQL engine also used in tests models neither MVCC nor the row-lock recheck, so it covers SQL shape and sequential semantics only — the concurrency proof comes from the real-engine suite.',\n 'Exactly one row per tenant is declared through the injected owner foreign key, but the unique index is emitted only by the MongoDB adapter — the SQL planner leaves index creation to migrations. On PostgreSQL the invariant is therefore NOT database-enforced today: the runtime repairs the common race (a rejected create falls through to an increment), but two truly simultaneous first-ever turns can leave two rows, splitting consumption and under-reporting spend until a unique constraint on the owner foreign key is added to the migration.',\n 'A budget row is owned by exactly ONE scope; the polymorphic owner FK is injected on each concrete variant schema, not on `A2ATokenBudgetStateSchema` itself, and the owner primary-scope filter must never expose another tenant\\'s counter.',\n ],\n }),\n // The owner is the injected scope FK, anchored by the `<SCOPE> → *A2aTokenBudgetState`\n // primary-scope COMPOSITION edge in `resources-registry.shared.core.definitions.ts`\n // (generated by `createPolymorphicScopeRelationships` with `childCardinality: ONE`).\n // The registry factory derives the scope from `isPrimaryScope: true`; this declaration\n // feeds the spec ↔ registry alignment guard and must match per variant.\n { resourcePrimaryScope: a2aBudgetPrimaryScopeByResourceType[resourceType] },\n );\n}\n\nexport const userA2aTokenBudgetStateResourceSpecification = buildA2ATokenBudgetStateResourceSpecification(\n CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE,\n 'USER_A2A_TOKEN_BUDGET_STATE',\n);\n\nexport const organizationA2aTokenBudgetStateResourceSpecification = buildA2ATokenBudgetStateResourceSpecification(\n CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE,\n 'ORGANIZATION_A2A_TOKEN_BUDGET_STATE',\n);\n\nexport const applicationA2aTokenBudgetStateResourceSpecification = buildA2ATokenBudgetStateResourceSpecification(\n CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE,\n 'APPLICATION_A2A_TOKEN_BUDGET_STATE',\n);\n"]}
|
|
1
|
+
{"version":3,"file":"a2a-token-budget-state.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n A2ATokenBudgetStateSchema,\n CoreResourceOperation as Op,\n CoreResourceType,\n ResourcePrimaryScope,\n a2aTokenBudgetStatePolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport { type CoreResourceTypeMemberName, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the `a2aTokenBudgetState` POLYMORPHIC SINGLETON\n * family: the per-tenant LLM **token budget accumulator** that lets the inbound\n * Agent2Agent (A2A) transport fail-closed BEFORE dispatch once a tenant has spent its\n * plan-granted period allowance. One base envelope is stamped out as three genuine\n * single-scope variants, each owned by its injected owner FK:\n * - `userA2aTokenBudgetState` (USER_SELF — user-delegated A2A turns)\n * - `organizationA2aTokenBudgetState` (ORGANIZATIONS — org-machine A2A turns)\n * - `applicationA2aTokenBudgetState` (APPLICATION — app-machine A2A turns)\n *\n * This is INTERNAL ENFORCEMENT STATE, not user-authored data. The A2A runtime\n * (`A2ATokenBudgetBackendService`) is the only writer — it opens the singleton on the\n * first budgeted turn (CREATE, INTERNAL_CALL super-admin via `*AsSystem`) and then\n * advances the counter through an ATOMIC repository-tier increment rather than a\n * service-tier update, so concurrent turns cannot lose tokens to a read-modify-write\n * race. That is why NO `UPDATE` operation is declared. The tenant's own surface is READ\n * only: an owner-level \"how much of my allowance have I used?\" view. DELETE exists solely\n * as the cascade teardown and is INTERNAL_CALL — it gets NO HTTP route at all, because\n * zeroing this row would reset a tenant's recorded spend (see the DELETE operation prose).\n *\n * TWO HALVES, DELIBERATELY SEPARATED: the ALLOWANCE (the cap) is NOT stored here — it\n * is resolved live from the tenant's billing plan via the `a2a.llm.tokensPerPeriod`\n * LIMIT feature (`A2A_TOKEN_BUDGET_FEATURE_ID`), so a plan upgrade/downgrade applies\n * immediately with no copy to keep in sync. This row accumulates CONSUMPTION only.\n *\n * ONE spec covers all three variants (per the flow-actor-executions / billing / SSO\n * polymorphic-spec precedent).\n */\n\ntype A2ABudgetResourceType =\n | CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE\n | CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE\n | CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE;\ntype A2ABudgetResourceTypeMember = CoreResourceTypeMemberName<A2ABudgetResourceType>;\n\nconst a2aBudgetPrimaryScopeByResourceType: Record<A2ABudgetResourceType, ResourcePrimaryScope> = {\n [CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE]: ResourcePrimaryScope.APPLICATION,\n};\n\ninterface A2ATokenBudgetScopeExample {\n readonly scopeIdentity: Readonly<Record<string, string>>;\n /** Human-readable prose fragment for example titles, not a semantic vocabulary. */\n readonly scopeLabel: string;\n}\n\n/**\n * Owns the concrete path and response FK for each polymorphic budget contract.\n * The budget semantics are shared, but the public scope identity is not: an\n * example for one tenant type must never teach a sibling's URL parameter.\n */\nfunction createA2ATokenBudgetScopeExample(resourceType: A2ABudgetResourceType): A2ATokenBudgetScopeExample {\n switch (resourceType) {\n case CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE:\n return { scopeIdentity: { userId: 'user_01JEXAMPLE' }, scopeLabel: 'user' };\n case CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE:\n return { scopeIdentity: { organizationId: 'org_01JEXAMPLE' }, scopeLabel: 'organization' };\n case CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE:\n return { scopeIdentity: { applicationId: 'app_01JEXAMPLE' }, scopeLabel: 'application' };\n default: {\n const exhaustiveResourceType: never = resourceType;\n throw new Error(`Unsupported A2A token-budget resource type: ${String(exhaustiveResourceType)}`);\n }\n }\n}\n\ntype Cfg = ReturnType<(typeof a2aTokenBudgetStatePolymorphicFactories)[CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof A2ATokenBudgetStateSchema;\n\nfunction buildA2ATokenBudgetStateResourceSpecification(\n resourceType: A2ABudgetResourceType,\n resourceTypeMemberName: A2ABudgetResourceTypeMember,\n) {\n const exampleScope = createA2ATokenBudgetScopeExample(resourceType);\n const currentBudgetExample = {\n _id: `a2a_budget_${exampleScope.scopeLabel}_01JEXAMPLE`,\n periodKey: '2026-08',\n consumedTokens: 72_450,\n lastTurnAt: '2026-08-20T11:18:42.000Z',\n createdAt: '2026-08-02T08:15:00.000Z',\n updatedAt: '2026-08-20T11:18:42.000Z',\n ...exampleScope.scopeIdentity,\n };\n const currentBudgetSummaryExample = {\n _id: currentBudgetExample._id,\n periodKey: currentBudgetExample.periodKey,\n consumedTokens: currentBudgetExample.consumedTokens,\n lastTurnAt: currentBudgetExample.lastTurnAt,\n };\n\n return resourceSpecification<undefined, Core, Main>(\n a2aTokenBudgetStatePolymorphicFactories[resourceType],\n A2ATokenBudgetStateSchema,\n ({ schemaShape }) => ({\n purpose: 'Report how many LLM tokens this user, organization, or application has consumed through inbound A2A agent turns in the current budget period.',\n businessRole: 'Current-period A2A consumption used with the plan allowance to decide whether another agent turn may start; the allowance itself is resolved separately and is not part of this response.',\n lifecycleRole: 'Created after the first budgeted A2A turn, incremented after completed turns, and reset in place when the period changes; this resource does not retain prior-period history.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.FLOWS_ACTORS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2ATokenBudgetStateSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'a2aTokenBudgetStatePolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: resourceTypeMemberName,\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Three variants under `A2A_TOKEN_BUDGET_SCOPE_VARIANTS` — user row is `USER_SELF`; org/app rows are `ORGANIZATIONS`/`APPLICATION` (machine-owned A2A).',\n 'SINGLETON: the injected owner FK is the auto business key, so the declaration deliberately does NOT opt out of the singleton auto-business-key. NOTE the uniqueness is index-enforced on MongoDB only — the SQL planner leaves index creation to migrations, so on PostgreSQL the one-row invariant is upheld by the runtime rather than the database (see businessConstraints).',\n 'The allowance is NOT persisted here: it is resolved live from the `a2a.llm.tokensPerPeriod` LIMIT feature (`A2A_TOKEN_BUDGET_FEATURE_ID` in `@wildo-ai/saas-models`) via feature resolution for the owner scope.',\n 'Sole runtime reader/writer is `A2ATokenBudgetBackendService` (`@wildo-ai/saas-backend-lib`); CREATE and READ go through `*AsSystem` under the resource\\'s `systemAccessPolicy`, while the counter is advanced by the atomic repository-tier increment primitive (there is deliberately no UPDATE operation).',\n 'Runtime has no userNotifications / m2mNotifications — do not add communications.* (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Document id of this tenant\\'s single A2A token-budget record.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n periodKey: schemaShape.periodKey.stringSpec({\n meaning: 'Stable id of the budget WINDOW this counter currently covers — a UTC calendar month (`YYYY-MM`) in v1.',\n whyItMatters: 'It is the reset boundary: when the runtime resolves a different current period, the accumulator resets `consumedTokens` and advances this key in place, so a stale period reads as zero consumption rather than carrying spend forward.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n consumedTokens: schemaShape.consumedTokens.numberSpec({\n meaning: 'Tokens (prompt + completion) this tenant\\'s A2A agent turns have consumed within `periodKey`.',\n whyItMatters: 'It is the single value the pre-dispatch gate compares against the plan allowance; once it reaches the allowance the transport denies further turns for the rest of the period.',\n unit: 'tokens',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n lastTurnAt: schemaShape.lastTurnAt.dateSpec({\n meaning: 'When the last A2A turn was recorded against this budget.',\n whyItMatters: 'Observability only — it lets an operator see whether a tenant is actively spending without reconstructing the turn log; nothing in the gate reads it.',\n temporalRole: 'occurred',\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the tenant\\'s budget record was first opened (its first budgeted A2A turn).',\n temporalRole: 'creation',\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'When the counter was last incremented or rolled to a new period.',\n temporalRole: 'modified',\n }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the tenant\\'s budget singleton on its first budgeted A2A turn.',\n outcome: 'The tenant has exactly one counter row, stamped with the current period and that first turn\\'s tokens, against which every later turn is measured.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The tenant\\'s single budget record was opened. Internal/system write path (INTERNAL_CALL, service-tier) — the A2A runtime writes on the tenant\\'s behalf via `createAsSystem`; there is no self-serve create surface.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `periodKey` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A concurrent turn already opened the tenant\\'s singleton — the injected owner FK is a unique business key, so only one racer creates. The accumulator swallows this and increments the winner\\'s row instead of surfacing the conflict to the turn.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-system caller attempts to create a budget row — the operation is INTERNAL_CALL with a super-admin floor, reachable only through the A2A runtime.' },\n ],\n idempotent: false,\n },\n\n [Op.READ]: {\n purpose: 'Read the current A2A token-consumption period, consumed-token count, and latest recorded turn for this scope.',\n outcome: 'The integration owner can monitor current-period A2A consumption without treating this state as the plan allowance or as historical usage.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The current consumption state for this scope is returned, including its period key, consumed tokens, and latest recorded turn when available.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to inspect A2A consumption for this user, organization, or application scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No budgeted A2A turn has been recorded for this scope yet, or the requested scope belongs to another owner.' },\n ],\n idempotent: true,\n examples: [{\n title: `Inspect current ${exampleScope.scopeLabel} A2A consumption`,\n request: exampleScope.scopeIdentity,\n response: currentBudgetExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Inspect current ${exampleScope.scopeLabel} A2A consumption with context`,\n request: exampleScope.scopeIdentity,\n response: currentBudgetExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Inspect the compact ${exampleScope.scopeLabel} A2A consumption summary`,\n request: exampleScope.scopeIdentity,\n response: currentBudgetSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n // No UPDATE operation is declared, deliberately: advancing the counter after a turn\n // (increment, or roll the period in place) is an ATOMIC repository-tier increment, not a\n // service-tier update, precisely so concurrent turns cannot lose tokens to a\n // read-modify-write race. Documenting an UPDATE here would describe a write path that does\n // not exist and invite routing the counter through it.\n\n [Op.DELETE]: {\n purpose: 'Remove a tenant\\'s budget row — platform teardown, and the cleanup the owning user/org/app deletion cascades to.',\n outcome: 'The counter row is physically removed, so a deleted tenant leaves no orphaned enforcement state behind.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The budget record was removed. The role floor is deliberately PLATFORM-ONLY (`APP_ADMIN_SUPER_ADMIN`) — NOT the owner-read roles and NOT an org admin: deleting this record zeroes the tenant\\'s recorded consumption, which is a spend-cap bypass. Read-authority does not imply delete-authority here, because the counter is enforcement state ABOUT the tenant rather than data BELONGING to it. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks and is therefore unaffected by the floor.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No budget row exists for the targeted tenant (it never ran a budgeted turn, or it was already removed).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A caller below the platform super-admin floor — including the owning tenant\\'s own admin — attempts to delete the row and reset its recorded spend.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'One row per tenant: the injected owner FK (`userId` / `organizationId` / `applicationId`) is the unique business key (database-enforced on MongoDB only — see the PostgreSQL caveat below). The period lives INSIDE the row and is rolled in place, so the resource holds current-period state only — per-period history and multi-budget-feature accounting are documented follow-ons.',\n 'The plan ALLOWANCE is never stored here. It is resolved live from the `a2a.llm.tokensPerPeriod` LIMIT feature for the owner scope, so a plan change takes effect on the next turn with no copy to reconcile. This resource is the CONSUMPTION half only.',\n 'This is internal enforcement state, not user-authored data: only the A2A runtime writes it. It CREATES the row via `*AsSystem` (INTERNAL_CALL, super-admin, under the resource\\'s `systemAccessPolicy`), then advances the counter through an ATOMIC repository-tier increment rather than an update operation — which is why no UPDATE operation is declared at all. The tenant\\'s only surface is reading its own consumption.',\n 'DELETE authority is strictly platform-level and intentionally diverges from read authority: zeroing recorded consumption would let a tenant admin reset their own spend cap at will.',\n 'The budget window is a UTC calendar month (`YYYY-MM`) in v1 — deterministic and free of a per-turn billing-account lookup on the hot path. Anchoring the window to the tenant\\'s actual subscription period is a documented follow-on, isolated to the single function that resolves the current period key.',\n 'Overage is bounded but is NOT a single turn: usage is only known AFTER a turn completes and recording is fire-and-forget, so every turn already in flight when the allowance is reached passes the gate on the same reading. The burst throttle that bounds it is per-PRINCIPAL while the budget is per-TENANT, so a tenant with many members or machine credentials can overshoot proportionally to how many act at once. Pre-charging an estimate was rejected because it would require a refund/reconcile path on every turn.',\n 'Accumulation is adapter-portable: the counter is advanced through a per-adapter atomic increment primitive (a single document update on MongoDB, a single `UPDATE … RETURNING` on PostgreSQL) rather than raw MongoDB operators, so a concurrent increment cannot be lost to a read-modify-write race on either backend. Both arms are covered by real-database integration tests, including the concurrent compare-and-set on a REAL PostgreSQL: a racing writer holds the row lock while a guarded reset blocks on it, and on resuming the reset correctly matches nothing rather than overwriting the racer\\'s accumulated total. The in-memory SQL engine also used in tests models neither MVCC nor the row-lock recheck, so it covers SQL shape and sequential semantics only — the concurrency proof comes from the real-engine suite.',\n 'Exactly one row per tenant is declared through the injected owner foreign key, but the unique index is emitted only by the MongoDB adapter — the SQL planner leaves index creation to migrations. On PostgreSQL the invariant is therefore NOT database-enforced today: the runtime repairs the common race (a rejected create falls through to an increment), but two truly simultaneous first-ever turns can leave two rows, splitting consumption and under-reporting spend until a unique constraint on the owner foreign key is added to the migration.',\n 'A budget row is owned by exactly ONE scope; the polymorphic owner FK is injected on each concrete variant schema, not on `A2ATokenBudgetStateSchema` itself, and the owner primary-scope filter must never expose another tenant\\'s counter.',\n ],\n }),\n // The owner is the injected scope FK, anchored by the `<SCOPE> → *A2aTokenBudgetState`\n // primary-scope COMPOSITION edge in `resources-registry.shared.core.definitions.ts`\n // (generated by `createPolymorphicScopeRelationships` with `childCardinality: ONE`).\n // The registry factory derives the scope from `isPrimaryScope: true`; this declaration\n // feeds the spec ↔ registry alignment guard and must match per variant.\n { resourcePrimaryScope: a2aBudgetPrimaryScopeByResourceType[resourceType] },\n );\n}\n\nexport const userA2aTokenBudgetStateResourceSpecification = buildA2ATokenBudgetStateResourceSpecification(\n CoreResourceType.USER_A2A_TOKEN_BUDGET_STATE,\n 'USER_A2A_TOKEN_BUDGET_STATE',\n);\n\nexport const organizationA2aTokenBudgetStateResourceSpecification = buildA2ATokenBudgetStateResourceSpecification(\n CoreResourceType.ORGANIZATION_A2A_TOKEN_BUDGET_STATE,\n 'ORGANIZATION_A2A_TOKEN_BUDGET_STATE',\n);\n\nexport const applicationA2aTokenBudgetStateResourceSpecification = buildA2ATokenBudgetStateResourceSpecification(\n CoreResourceType.APPLICATION_A2A_TOKEN_BUDGET_STATE,\n 'APPLICATION_A2A_TOKEN_BUDGET_STATE',\n);\n"]}
|
package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"flow-actor-executions.resource.specification.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"flow-actor-executions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/flows-actors/resources/flow-actor-executions.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAI3B,4BAA4B,EAC5B,8BAA8B,EAC9B,oBAAoB,EACpB,kBAAkB,EAGnB,MAAM,uBAAuB,CAAC;AA8Y/B,eAAO,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;iCAGxD,CAAC;AAEF,eAAO,MAAM,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;iCAGhE,CAAC;AAEF,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;;;;;iCAG/D,CAAC"}
|