Data Types

{
  "type": "text",
  "default": "..." // Optional
}

{
  "type": "text",
  "text": "The quick brown fox" 
}

{
  "type": "integer", // or "float"
  "default": 10,
  "range": { 
    "from": 0,
    "to": 100,
    "step": 1
  }
}

{
  "type": "integer",
  "integer": 42 
}

{
  "type": "boolean",
  "label": "Enable Feature XYZ",
  "default": false
}

{
  "type": "boolean",
  "flag": true
}

{
  "type": "choice", 
  "default": "model-a",
  "options": [
    {
      "id": "model-a",
      "label": "Fast Model"
    },
    {
      "id": "model-b",
      "label": "Slow Model"
    }
  ]   
}

{
  "type": "choice", 
  "id": "model-a"
}

{
  "type": "message"
}

{
  "type": "message",
  "message": {
    "role": "user", // "system", "user", or "assistant"
    "content": [
      {
        "type": "text",
        "text": "What is the capital of France?" 
      },    
      {
        "type": "vector",
        "values": [0.12, -0.44, 0.99]                
      },
      {
        "type": "file",
        "file": {
          "alias": "meeting_recording",
          "name": "meeting.mp4",
          "content_type": "video/mp4",
          "size": 245123
        }
      }
    ],
    "attributes": {
      "id": "uuid-for-tracking",
      "created_at": "2026-05-28T12:00:00.000000Z",
      "syntax_mode": "text" 
    },
    "providers": [
      {
        "interface": "genai.chat",
        "ports": [
          {
            "route": "temperature",
            "value": {
              "type": "integer",
              "integer": 0
            }
          }
        ]
      }
    ],
    "metadata": {
      // Free-form arbitrary JSON
    }
  }
}

{
  "type": "messages"
}

{
  "type": "messages",
  "messages": [
    {
      "type": "message",
      "message": { ... }
    },
    {
      "type": "message",
      "message": { ... }
    }
  ]
}

{
  "type": "credential",
  "credential_type": "openai" 
}

{
  "type": "credential",
  "alias": "production_openai_key" 
}