{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "@context": [
    "https://schemas.meta-aiml.org/v3.0.0/context.jsonld"
  ],
  "@id": "https://schemas.meta-aiml.org/v3.0.0/components/entity_capabilities_extended.json",
  "@type": [
    "Thing",
    "ComponentSchema"
  ],
  "schemaVersion": "3.0.0",
  "aimlVersion": "3.0.0",
  "title": "Entity Capabilities Extended Component",
  "description": "Extended schema for entity-level functional capabilities groupings in META-AIML v3. Provides structured definitions for all 8 core capability groups plus optional groups. Each group is independently composable and referenced by entity schemas.",
  "type": "object",
  "$defs": {
    "EntityCapabilities": {
      "type": "object",
      "title": "Entity Capabilities — Full Group Definitions",
      "description": "Top-level capabilities object. Each key is a capability group name. Groups are independently optional but archetypes impose minimum requirements (see archetype schemas for group-level requirements).",
      "properties": {
        "booking": {
          "$ref": "#/$defs/BookingGroup",
          "description": "Reservation, scheduling, and appointment management capabilities."
        },
        "commerce": {
          "$ref": "#/$defs/CommerceGroup",
          "description": "Product catalog, ordering, and transaction capabilities."
        },
        "financial": {
          "$ref": "#/$defs/FinancialGroup",
          "description": "Payment processing, invoicing, and financial management capabilities."
        },
        "location": {
          "$ref": "#/$defs/LocationGroup",
          "description": "Geographic presence, wayfinding, and area-based features."
        },
        "content": {
          "$ref": "#/$defs/ContentGroup",
          "description": "Content publishing, curation, and media management capabilities."
        },
        "interaction": {
          "$ref": "#/$defs/InteractionGroup",
          "description": "User-to-platform and user-to-user communication capabilities. REQUIRED for DirectService archetype."
        },
        "amenities": {
          "$ref": "#/$defs/AmenitiesGroup",
          "description": "Physical and digital conveniences and accessibility features."
        },
        "community": {
          "$ref": "#/$defs/CommunityGroup",
          "description": "Group structures, membership, and collective user spaces. REQUIRED for NetworkGraph archetype."
        },
        "media": {
          "type": "object",
          "description": "Video/audio streaming, transcoding, CDN delivery, live streaming capabilities."
        },
        "ai": {
          "type": "object",
          "description": "AI/ML features: text generation, recommendations, image processing, classification."
        },
        "communication": {
          "type": "object",
          "description": "Real-time communication: voice/video calls, conferencing, broadcasting."
        }
      }
    },
    "BookingGroup": {
      "type": "object",
      "title": "Booking Capability Group",
      "description": "Reservation, scheduling, availability, and appointment management.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "reservation",
              "availabilityCheck",
              "scheduling",
              "calendarSync",
              "instantBooking",
              "waitlist",
              "cancellation",
              "reminder",
              "depositRequired",
              "groupBooking"
            ]
          }
        },
        "acceptsReservations": {
          "type": "boolean"
        },
        "requiresDeposit": {
          "type": "boolean"
        },
        "cancellationPolicy": {
          "type": "string"
        },
        "maxPartySize": {
          "type": "integer",
          "minimum": 1
        },
        "leadTimeHours": {
          "type": "integer",
          "minimum": 0,
          "description": "Minimum hours in advance required to book."
        },
        "realTimeFeatures": {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      }
    },
    "CommerceGroup": {
      "type": "object",
      "title": "Commerce Capability Group",
      "description": "Buying, selling, catalog, and order management capabilities.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "productCatalog",
              "cart",
              "checkout",
              "orderTracking",
              "inventory",
              "vendorManagement",
              "listingManagement",
              "pricing",
              "search",
              "filtering",
              "wishlist",
              "compareProducts"
            ]
          }
        },
        "serviceTypes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "hasDelivery": {
          "type": "boolean"
        },
        "hasTakeout": {
          "type": "boolean"
        },
        "multiVendor": {
          "type": "boolean"
        },
        "inventoryManagement": {
          "type": "boolean"
        }
      }
    },
    "FinancialGroup": {
      "type": "object",
      "title": "Financial Capability Group",
      "description": "Payment, invoicing, refund, and financial management capabilities.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "payments",
              "invoicing",
              "refunds",
              "wallet",
              "billing",
              "subscriptionManagement",
              "currencyExchange",
              "escrow",
              "tipping",
              "payouts",
              "loyaltyPoints"
            ]
          }
        },
        "paymentMethods": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "acceptsCreditCards": {
          "type": "boolean"
        },
        "currencies": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "priceRange": {
          "type": "string",
          "enum": [
            "$",
            "$$",
            "$$$",
            "$$$$"
          ]
        },
        "commissionModel": {
          "type": "string",
          "enum": [
            "percentage",
            "flat_fee",
            "hybrid",
            "none"
          ]
        },
        "commissionRate": {
          "type": "number",
          "minimum": 0,
          "maximum": 100
        }
      }
    },
    "LocationGroup": {
      "type": "object",
      "title": "Location Capability Group",
      "description": "Geographic features: address, coordinates, directions, proximity search.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "physicalAddress",
              "geoCoordinates",
              "directions",
              "mapIntegration",
              "proximitySearch",
              "realTimeTracking",
              "routing",
              "geofencing"
            ]
          }
        },
        "hasParking": {
          "type": "boolean"
        },
        "isWheelchairAccessible": {
          "type": "boolean"
        },
        "hasDeliveryZone": {
          "type": "boolean"
        },
        "serviceRadius": {
          "type": "object",
          "properties": {
            "value": {
              "type": "number"
            },
            "unit": {
              "type": "string",
              "enum": [
                "meters",
                "km",
                "miles"
              ]
            }
          }
        }
      }
    },
    "ContentGroup": {
      "type": "object",
      "title": "Content Capability Group",
      "description": "Content creation, publishing, curation, and media management.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "publishing",
              "curation",
              "mediaHosting",
              "search",
              "categories",
              "tags",
              "archives",
              "rss",
              "newsletter",
              "podcast",
              "paywall"
            ]
          }
        },
        "contentTypes": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "contentFormats": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "contentAccess": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "public",
              "subscriber",
              "member",
              "premium",
              "restricted"
            ]
          }
        },
        "editorialControl": {
          "type": "boolean"
        },
        "userGeneratedContent": {
          "type": "boolean"
        }
      }
    },
    "InteractionGroup": {
      "type": "object",
      "title": "Interaction Capability Group",
      "description": "User-to-platform and user-to-user communication. REQUIRED for DirectService archetype.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "messaging",
              "commenting",
              "rating",
              "reviews",
              "socialGraph",
              "feed",
              "notifications",
              "matching",
              "chat",
              "contactForm",
              "disputeResolution"
            ]
          }
        },
        "interactionMethods": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "availableActions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "realTimeCommunication": {
          "type": "boolean"
        },
        "moderationEnabled": {
          "type": "boolean"
        },
        "responseTime": {
          "type": "string"
        },
        "bidirectionalRating": {
          "type": "boolean"
        }
      }
    },
    "AmenitiesGroup": {
      "type": "object",
      "title": "Amenities Capability Group",
      "description": "Physical and digital conveniences, accessibility, and lifestyle features.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "wifi",
              "parking",
              "accessibility",
              "petFriendly",
              "outdoorSeating",
              "dietaryOptions",
              "childFriendly",
              "powerOutlets",
              "privateRoom",
              "bar",
              "delivery"
            ]
          }
        },
        "hasWifi": {
          "type": "boolean"
        },
        "wifiSpeed": {
          "type": "string",
          "enum": [
            "basic",
            "standard",
            "high_speed",
            "gigabit"
          ]
        },
        "hasOutdoorSeating": {
          "type": "boolean"
        },
        "hasVegetarianOptions": {
          "type": "boolean"
        },
        "hasVeganOptions": {
          "type": "boolean"
        },
        "hasGlutenFreeOptions": {
          "type": "boolean"
        },
        "petPolicy": {
          "type": "string",
          "enum": [
            "allowed",
            "not_allowed",
            "allowed_outdoor",
            "service_only"
          ]
        },
        "smokingPolicy": {
          "type": "string",
          "enum": [
            "smoking",
            "non_smoking",
            "designated_areas"
          ]
        }
      }
    },
    "CommunityGroup": {
      "type": "object",
      "title": "Community Capability Group",
      "description": "Group structures, membership, and governance. REQUIRED for NetworkGraph archetype.",
      "properties": {
        "features": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "groups",
              "channels",
              "discovery",
              "moderation",
              "membershipManagement",
              "groupEvents",
              "polls",
              "announcements",
              "invites"
            ]
          }
        },
        "privacyControls": {
          "type": "boolean"
        },
        "moderationModel": {
          "type": "string",
          "enum": [
            "community_elected",
            "platform_assigned",
            "ai_assisted_human",
            "user_reported"
          ]
        },
        "groupTypes": {
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "public",
              "private",
              "secret",
              "invite_only"
            ]
          }
        },
        "maxGroupSize": {
          "type": "integer",
          "minimum": 2
        },
        "hasGroupEvents": {
          "type": "boolean"
        },
        "hasPolls": {
          "type": "boolean"
        }
      }
    }
  },
  "semanticAnnotations": {
    "type": "object",
    "description": "Notes on how capability groups relate to archetypes.",
    "properties": {
      "archetypeRequirements": {
        "type": "object",
        "description": "Which capability groups are required by each archetype per spec.",
        "const": {
          "DirectService": [
            "interaction"
          ],
          "MediatedExchange": [
            "commerce",
            "financial",
            "interaction"
          ],
          "NetworkGraph": [
            "interaction",
            "content",
            "community"
          ],
          "BroadcastPublisher": [
            "content"
          ],
          "ProtocolSystem": []
        }
      }
    }
  },
  "governanceMetadata": {
    "type": "object",
    "properties": {
      "componentVersion": {
        "type": "string",
        "const": "3.0.0"
      },
      "coreGroups": {
        "type": "array",
        "const": [
          "booking",
          "commerce",
          "financial",
          "location",
          "content",
          "interaction",
          "amenities",
          "community"
        ]
      },
      "optionalGroups": {
        "type": "array",
        "const": [
          "media",
          "ai",
          "communication"
        ]
      }
    }
  },
  "validationMetadata": {
    "schemaVersion": "3.0.0",
    "phase": "phase_1",
    "status": "draft",
    "lastValidated": "2026-02-19",
    "validator": "META-AIML QA"
  },
  "$id": "https://schemas.meta-aiml.org/v3.0.0/components/entity_capabilities_extended.json",
  "examples": [
    {
      "scenario": "DirectService baseline",
      "capabilities": {
        "interaction": {
          "features": [
            "messaging"
          ]
        }
      }
    },
    {
      "scenario": "NetworkGraph baseline",
      "capabilities": {
        "interaction": {
          "features": [
            "socialGraph"
          ]
        },
        "content": {
          "features": [
            "publishing"
          ]
        },
        "community": {
          "features": [
            "groups"
          ]
        }
      }
    }
  ]
}