agent-first-data 0.23.0

A naming convention that lets AI agents understand your data without being told what it means, plus a CLI and library for reading and safely editing structured JSON, TOML, YAML, dotenv, and INI documents.
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

{
  "redaction_cases": [
    {
      "name": "nested arrays custom names env url and free text",
      "options": {
        "secret_names": [
          "API_TOKEN",
          "legacy_key"
        ]
      },
      "input": {
        "records": [
          {
            "api_key_secret": "sk-nested",
            "nested": {
              "legacy_key": "legacy-secret",
              "name": "alice"
            }
          }
        ],
        "env": {
          "API_TOKEN": "tok-env",
          "HOME": "/tmp/agent"
        },
        "callback_url": "https://user:pass@example.com/cb?api_key=visible&token_secret=hidden&legacy_key=hidden2",
        "message": "free text keeps api_key_secret=sk-free and https://user:pass@example.com/?token_secret=free"
      },
      "expected": {
        "records": [
          {
            "api_key_secret": "***",
            "nested": {
              "legacy_key": "***",
              "name": "alice"
            }
          }
        ],
        "env": {
          "API_TOKEN": "***",
          "HOME": "/tmp/agent"
        },
        "callback_url": "https://user:***@example.com/cb?api_key=visible&token_secret=***&legacy_key=***",
        "message": "free text keeps api_key_secret=sk-free and https://user:pass@example.com/?token_secret=free"
      },
      "must_contain": [
        "***",
        "/tmp/agent",
        "api_key=visible",
        "sk-free"
      ],
      "must_not_contain": [
        "sk-nested",
        "legacy-secret",
        "tok-env",
        "pass@example.com/cb",
        "token_secret=hidden"
      ]
    }
  ],
  "argv_cases": [
    {
      "name": "inline and space separated secret argv",
      "options": {
        "secret_names": [
          "legacy-key"
        ]
      },
      "input": [
        "--api-key-secret=sk-inline",
        "--legacy-key",
        "legacy-space",
        "free text api_key_secret=visible"
      ],
      "expected": [
        "--api-key-secret=***",
        "--legacy-key",
        "***",
        "free text api_key_secret=visible"
      ]
    }
  ],
  "help_default_cases": [
    {
      "name": "secret help default",
      "flag": "--api-key-secret",
      "field_name": "api_key_secret",
      "default": "sk-help-default",
      "expected": "***"
    }
  ]
}