agent-first-data 0.17.3

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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

[
  {
    "name": "result",
    "type": "result",
    "args": {"result": {"hash": "abc"}},
    "expected": {"kind": "result", "result": {"hash": "abc"}, "trace": {}}
  },
  {
    "name": "result_trace",
    "type": "result_trace",
    "args": {"result": {"hash": "abc"}, "trace": {"duration_ms": 12}},
    "expected": {"kind": "result", "result": {"hash": "abc"}, "trace": {"duration_ms": 12}}
  },
  {
    "name": "error",
    "type": "error",
    "args": {"code": "not_found", "message": "not found"},
    "expected": {"kind": "error", "error": {"code": "not_found", "message": "not found", "retryable": false}, "trace": {}}
  },
  {
    "name": "error_trace",
    "type": "error_trace",
    "args": {"code": "failed", "message": "fail", "trace": {"duration_ms": 3}},
    "expected": {"kind": "error", "error": {"code": "failed", "message": "fail", "retryable": false}, "trace": {"duration_ms": 3}}
  },
  {
    "name": "error_hint",
    "type": "error_hint",
    "args": {"code": "timeout", "message": "connection timeout", "hint": "increase --timeout-s"},
    "expected": {"kind": "error", "error": {"code": "timeout", "message": "connection timeout", "hint": "increase --timeout-s", "retryable": false}, "trace": {}}
  },
  {
    "name": "error_retryable",
    "type": "error_retryable",
    "args": {"code": "network_error", "message": "connection reset", "retryable": true},
    "expected": {"kind": "error", "error": {"code": "network_error", "message": "connection reset", "retryable": true}, "trace": {}}
  },
  {
    "name": "error_extension_fields",
    "type": "error_extension_fields",
    "args": {
      "code": "validation_failed",
      "message": "invalid input",
      "fields": {"field": "email", "rule_id": "format"}
    },
    "expected": {
      "kind": "error",
      "error": {
        "code": "validation_failed",
        "message": "invalid input",
        "retryable": false,
        "field": "email",
        "rule_id": "format"
      },
      "trace": {}
    }
  },
  {
    "name": "progress",
    "type": "progress",
    "args": {"message": "working", "fields": {"current": 3, "total": 10}},
    "expected": {"kind": "progress", "progress": {"message": "working", "current": 3, "total": 10}, "trace": {}}
  },
  {
    "name": "progress_message_only",
    "type": "progress",
    "args": {"message": "uploading files"},
    "expected": {"kind": "progress", "progress": {"message": "uploading files"}, "trace": {}}
  },
  {
    "name": "log",
    "type": "log",
    "args": {"level": "info", "message": "startup"},
    "expected": {"kind": "log", "log": {"level": "info", "message": "startup"}, "trace": {}}
  },
  {
    "name": "log_extension_fields",
    "type": "log",
    "args": {"level": "warn", "message": "retrying request", "fields": {"attempt": 2, "code": "upstream_retry", "timestamp_epoch_ms": 1710000000000}},
    "expected": {"kind": "log", "log": {"level": "warn", "message": "retrying request", "attempt": 2, "code": "upstream_retry", "timestamp_epoch_ms": 1710000000000}, "trace": {}}
  },
  {
    "name": "arbitrary_json_result",
    "type": "result",
    "args": {"result": ["a", 1, true, null, {"nested": {"ok": true}}]},
    "expected": {"kind": "result", "result": ["a", 1, true, null, {"nested": {"ok": true}}], "trace": {}}
  },
  {
    "name": "kind_payload_mismatch",
    "invalid": {"kind": "result", "error": {"code": "x", "message": "wrong payload"}}
  },
  {
    "name": "illegal_top_level_field",
    "invalid": {"kind": "result", "result": {}, "extra": true}
  },
  {
    "name": "trace_must_be_object",
    "invalid": {"kind": "result", "result": {}, "trace": "duration=1ms"}
  },
  {
    "name": "error_requires_code",
    "invalid": {"kind": "error", "error": {"message": "missing code"}}
  },
  {
    "name": "error_requires_message",
    "invalid": {"kind": "error", "error": {"code": "missing_message"}}
  }
]