agent-first-data 0.2.1__tar.gz → 0.2.3__tar.gz

{agent_first_data-0.2.1 → agent_first_data-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-first-data
-Version: 0.2.1
+Version: 0.2.3
 Summary: Agent-First Data (AFD) — suffix-driven output formatting and protocol templates for AI agents
 License-Expression: MIT
 Project-URL: Repository, https://github.com/cmnspore/agent-first-data
@@ -19,6 +19,44 @@ The field name is the schema. Agents read `latency_ms` and know milliseconds, `a
 pip install agent-first-data
 ```
 
+## Quick Example
+
+A backup tool invoked from the CLI — flags, env vars, and config all use the same suffixes:
+
+```bash
+API_KEY_SECRET=sk-1234 cloudback --timeout-s 30 --max-file-size-bytes 10737418240 /data/backup.tar.gz
+```
+
+The tool reads env vars, flags, and config — all with AFD suffixes — and emits a startup message:
+
+```python
+from agent_first_data import *
+import os
+
+startup = build_json_startup(
+    {"timeout_s": 30, "max_file_size_bytes": 10737418240},
+    {"input_path": "/data/backup.tar.gz"},
+    {"API_KEY_SECRET": os.environ.get("API_KEY_SECRET")},
+)
+```
+
+Three output formats, same data:
+
+```
+JSON:  {"code":"startup","args":{"input_path":"/data/backup.tar.gz"},"config":{"max_file_size_bytes":10737418240,"timeout_s":30},"env":{"API_KEY_SECRET":"***"}}
+YAML:  code: "startup"
+       args:
+         input_path: "/data/backup.tar.gz"
+       config:
+         max_file_size: "10.0GB"
+         timeout: "30s"
+       env:
+         API_KEY: "***"
+Plain: args.input_path=/data/backup.tar.gz code=startup config.max_file_size=10.0GB config.timeout=30s env.API_KEY=***
+```
+
+`--timeout-s` → `timeout_s` → `timeout: 30s`. `API_KEY_SECRET` → `API_KEY: "***"`. The suffix is the schema.
+
 ## API Reference
 
 Total: **9 public APIs** + **AFD logging** (4 protocol builders + 3 output functions + 1 internal + 1 utility)

{agent_first_data-0.2.1 → agent_first_data-0.2.3}/README.md

@@ -10,6 +10,44 @@ The field name is the schema. Agents read `latency_ms` and know milliseconds, `a
 pip install agent-first-data
 ```
 
+## Quick Example
+
+A backup tool invoked from the CLI — flags, env vars, and config all use the same suffixes:
+
+```bash
+API_KEY_SECRET=sk-1234 cloudback --timeout-s 30 --max-file-size-bytes 10737418240 /data/backup.tar.gz
+```
+
+The tool reads env vars, flags, and config — all with AFD suffixes — and emits a startup message:
+
+```python
+from agent_first_data import *
+import os
+
+startup = build_json_startup(
+    {"timeout_s": 30, "max_file_size_bytes": 10737418240},
+    {"input_path": "/data/backup.tar.gz"},
+    {"API_KEY_SECRET": os.environ.get("API_KEY_SECRET")},
+)
+```
+
+Three output formats, same data:
+
+```
+JSON:  {"code":"startup","args":{"input_path":"/data/backup.tar.gz"},"config":{"max_file_size_bytes":10737418240,"timeout_s":30},"env":{"API_KEY_SECRET":"***"}}
+YAML:  code: "startup"
+       args:
+         input_path: "/data/backup.tar.gz"
+       config:
+         max_file_size: "10.0GB"
+         timeout: "30s"
+       env:
+         API_KEY: "***"
+Plain: args.input_path=/data/backup.tar.gz code=startup config.max_file_size=10.0GB config.timeout=30s env.API_KEY=***
+```
+
+`--timeout-s` → `timeout_s` → `timeout: 30s`. `API_KEY_SECRET` → `API_KEY: "***"`. The suffix is the schema.
+
 ## API Reference
 
 Total: **9 public APIs** + **AFD logging** (4 protocol builders + 3 output functions + 1 internal + 1 utility)

{agent_first_data-0.2.1 → agent_first_data-0.2.3}/agent_first_data.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-first-data
-Version: 0.2.1
+Version: 0.2.3
 Summary: Agent-First Data (AFD) — suffix-driven output formatting and protocol templates for AI agents
 License-Expression: MIT
 Project-URL: Repository, https://github.com/cmnspore/agent-first-data
@@ -19,6 +19,44 @@ The field name is the schema. Agents read `latency_ms` and know milliseconds, `a
 pip install agent-first-data
 ```
 
+## Quick Example
+
+A backup tool invoked from the CLI — flags, env vars, and config all use the same suffixes:
+
+```bash
+API_KEY_SECRET=sk-1234 cloudback --timeout-s 30 --max-file-size-bytes 10737418240 /data/backup.tar.gz
+```
+
+The tool reads env vars, flags, and config — all with AFD suffixes — and emits a startup message:
+
+```python
+from agent_first_data import *
+import os
+
+startup = build_json_startup(
+    {"timeout_s": 30, "max_file_size_bytes": 10737418240},
+    {"input_path": "/data/backup.tar.gz"},
+    {"API_KEY_SECRET": os.environ.get("API_KEY_SECRET")},
+)
+```
+
+Three output formats, same data:
+
+```
+JSON:  {"code":"startup","args":{"input_path":"/data/backup.tar.gz"},"config":{"max_file_size_bytes":10737418240,"timeout_s":30},"env":{"API_KEY_SECRET":"***"}}
+YAML:  code: "startup"
+       args:
+         input_path: "/data/backup.tar.gz"
+       config:
+         max_file_size: "10.0GB"
+         timeout: "30s"
+       env:
+         API_KEY: "***"
+Plain: args.input_path=/data/backup.tar.gz code=startup config.max_file_size=10.0GB config.timeout=30s env.API_KEY=***
+```
+
+`--timeout-s` → `timeout_s` → `timeout: 30s`. `API_KEY_SECRET` → `API_KEY: "***"`. The suffix is the schema.
+
 ## API Reference
 
 Total: **9 public APIs** + **AFD logging** (4 protocol builders + 3 output functions + 1 internal + 1 utility)

{agent_first_data-0.2.1 → agent_first_data-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agent-first-data"
-version = "0.2.1"
+version = "0.2.3"
 description = "Agent-First Data (AFD) — suffix-driven output formatting and protocol templates for AI agents"
 license = "MIT"
 readme = "README.md"