Source of truth for implementation is the canonical schema host:
https://schemas.meta-aiml.org/v3.0.0/. If any page text conflicts with canonical schema files, follow canonical files. Documentation home.Core Concepts
META-AIML v3.0.0
META-AIML v3 models each entity through ontology, interaction archetype, capability groups, and structural semantics.
Canonical source is
https://schemas.meta-aiml.org/v3.0.0/ (ontology, archetypes, components, entities, examples, sdk).5 Ontology Modes
What kind of system/object is modeled.
PhysicalEntity
DigitalEntity
FinancialEntity
EventEntity
ProductEntity
5 Interaction Archetypes
How value and interaction flow are organized.
DirectService
MediatedExchange
NetworkGraph
BroadcastPublisher
ProtocolSystem
Entity Contract Shape
Identity + ontology + archetype + domain + capabilities + structural metadata.
{
"@context": ["https://schemas.meta-aiml.org/v3.0.0/context.jsonld"],
"@type": "Marketplace",
"ontologicalMode": "DigitalEntity",
"interactionArchetype": ["MediatedExchange"],
"domain": "Commerce",
"deliveryFormat": ["WebApp", "MobileApp"],
"capabilities": {
"commerce": { "features": ["checkout", "orderTracking"] },
"financial": { "features": ["payments", "refunds"] },
"interaction": { "features": ["messaging", "reviews"] }
},
"structuralMetadata": {
"topology": "triadic",
"roles": ["buyer", "seller", "platform"],
"valueSource": "transaction_mediation"
}
}Compatibility Rules
Archetype assignment must match ontology mode constraints.
Allowed Ontology -> Archetype mapping
PhysicalEntity -> DirectService | BroadcastPublisher
DigitalEntity -> DirectService | MediatedExchange | NetworkGraph | BroadcastPublisher | ProtocolSystem
FinancialEntity -> DirectService | ProtocolSystem
EventEntity -> DirectService | BroadcastPublisher
ProductEntity -> (no archetype)Validation Semantics
Validity gate and score are related but not identical.
SDK validity semantics (v3):
- critical: blocker, schema is invalid
- major: high-impact warning, non-blocking
- minor: recommendation warning, non-blocking
- info: advisory
Score zones:
- RED: 0..49
- ORANGE: 50..89
- GREEN: 90..100
Default pass threshold: 50Contract vs Instance
Contract files: https://schemas.meta-aiml.org/v3.0.0/entity/<entity>.json.
Example instances: https://schemas.meta-aiml.org/v3.0.0/examples/<entity>_example_schema_v3.json.
Schema validator: checks contract structure/consistency.
SDK validator: checks both contracts and instances with score and findings.