yettagam

a digital safe storage box. a set of JSON schemas — yType — that can be instantiated into objects — yObj. when saying yObj or yType, the y is silent.

browse schemas integration guide

for ai agents

agents can discover yettagam schemas via the machine-readable endpoint at /agent-context/. this returns project metadata, schema URLs, and integration guidance. for full details on how to work with yettagam types programmatically, see the integration guide.

what is yettagam?

yettagam is a coinage of "yettu" + "pettagam" — pettagam in tamil is "box" and yettu is a reference to how all digits can be shown with that shape, like on a calculator display.

the name is used as a reference to a digital safe storage box.

yettagam offers a set of JSON schemas called yType (yettagam type). these can be instantiated into yObj (yettagam objects). yType defines the structure; yObj is the data.

part of the metarium.net ecosystem.

schema architecture

yettagam uses a three-layer validation architecture. each layer references the one above it through $schema linkage, creating a chain of trust from meta-schema down to individual object instances. 

layer 1: yType meta-schema
  /ytype/1.0.0/schema.json
  defines what a valid type definition looks like
        │
        ▼
layer 2: yType definitions (17 types)
  /ytypes/{name}/{name}.ytype
  each validated by the meta-schema
  contains a "schema" section for validating instances
        │
        ▼
layer 3: yObj instances
  validated by the type's schema section
  concrete data objects conforming to a yType

type hierarchy

🧱

base types

foundation types from which all others inherit

  • base (abstract)
  • ibase (abstract)
🎬

media types

content and media object types

  • media (abstract)
  • imedia (abstract)
  • audio
  • video
  • image
  • document
🌐

platform types

platform-specific content types

  • platform_specific (abstract)
  • x_tweet
  • youtube_video
🗄️

data types

structured data and reference types

  • commit
  • exhibition
  • list
  • venue
  • vr_device
  • url

quick start

  1. reference the schema 
    "$schema": "https://yettagam.net/ytype/1.0.0/schema.json"
  2. browse available types

    explore the full type hierarchy to find the type you need

  3. instantiate a yObj

    use any concrete type to create typed objects — validated against the type's schema section