agent-first-data 0.16.0

A naming convention that lets AI agents understand your data without being told what it means.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://agentfirstkit.org/schemas/agent-first-data/protocol-v1.schema.json",
  "title": "Agent-First Data Protocol v1 Event",
  "type": "object",
  "oneOf": [
    {"$ref": "#/$defs/resultEvent"},
    {"$ref": "#/$defs/errorEvent"},
    {"$ref": "#/$defs/progressEvent"},
    {"$ref": "#/$defs/logEvent"}
  ],
  "$defs": {
    "trace": {
      "type": "object"
    },
    "resultEvent": {
      "type": "object",
      "properties": {
        "kind": {"const": "result"},
        "result": true,
        "trace": {"$ref": "#/$defs/trace"}
      },
      "required": ["kind", "result"],
      "additionalProperties": false
    },
    "errorEvent": {
      "type": "object",
      "properties": {
        "kind": {"const": "error"},
        "error": {
          "type": "object",
          "properties": {
            "code": {"type": "string", "minLength": 1},
            "message": {"type": "string", "minLength": 1},
            "retryable": {"type": "boolean"},
            "hint": {"type": "string"}
          },
          "required": ["code", "message", "retryable"],
          "additionalProperties": true
        },
        "trace": {"$ref": "#/$defs/trace"}
      },
      "required": ["kind", "error"],
      "additionalProperties": false
    },
    "progressEvent": {
      "type": "object",
      "properties": {
        "kind": {"const": "progress"},
        "progress": {
          "type": "object",
          "properties": {
            "message": {"type": "string", "minLength": 1}
          },
          "additionalProperties": true
        },
        "trace": {"$ref": "#/$defs/trace"}
      },
      "required": ["kind", "progress"],
      "additionalProperties": false
    },
    "logEvent": {
      "type": "object",
      "properties": {
        "kind": {"const": "log"},
        "log": {
          "type": "object",
          "properties": {
            "message": {"type": "string", "minLength": 1},
            "level": {"enum": ["debug", "info", "warn", "error"]},
            "code": false
          },
          "not": {
            "required": ["code"]
          },
          "additionalProperties": true
        },
        "trace": {"$ref": "#/$defs/trace"}
      },
      "required": ["kind", "log"],
      "additionalProperties": false
    }
  }
}