agent-first-data 0.7.4__tar.gz → 0.8.1__tar.gz

{agent_first_data-0.7.4/agent_first_data.egg-info → agent_first_data-0.8.1}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: agent-first-data
-Version: 0.7.4
-Summary: Agent-First Data (AFDATA) — suffix-driven output formatting and protocol templates for AI agents
+Version: 0.8.1
+Summary: A naming convention that lets AI agents understand your data without being told what it means.
 License-Expression: MIT
-Project-URL: Repository, https://github.com/cmnspore/agent-first-data
+Project-URL: Repository, https://github.com/agentfirstkit/agent-first-data
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 
@@ -74,7 +74,7 @@ Plain: args.input_path=/data/backup.tar.gz code=log event=startup config.max_fil
 
 ## API Reference
 
-Total: **13 public APIs and 2 types** + **AFDATA logging** (3 protocol builders + 4 output functions + 1 internal + 1 utility + 4 CLI helpers + `OutputFormat` + `RedactionPolicy`)
+Public APIs are grouped by role: protocol builders, redaction helpers, output formatters, internal redaction tools, utility/CLI helpers, types, and AFDATA logging integration.
 
 ### Protocol Builders (returns dict)
 
@@ -91,6 +91,16 @@ build_json_error(message: str, hint: str = None, trace: Any = None) -> dict
 build_json(code: str, fields: Any, trace: Any = None) -> dict
 ```
 
+### Redaction Helpers (returns Any)
+
+Use these before raw HTTP/MCP/SSE serializers that do not call `output_json`.
+
+```python
+redacted_value(value: Any) -> Any
+redacted_value_with(value: Any, redaction_policy: RedactionPolicy) -> Any
+redacted_value_with_options(value: Any, redaction_options: RedactionOptions) -> Any
+```
+
 **Use case:** structured protocol payloads (frameworks automatically serialize)
 
 **Example:**
@@ -129,23 +139,31 @@ not_found = build_json(
 )
 ```
 
-### CLI/Log Output (returns str)
+### Output Formatters (returns str)
 
-Format values for CLI output and logs. `output_json` uses full `_secret` redaction by default. `output_json_with` supports explicit scoped policies. YAML and Plain always redact `_secret` and apply human-readable formatting.
+Format values for CLI output and logs. `output_json` uses full `_secret` redaction by default. `output_json_with` supports explicit scoped policies. Use the `*_with_options` functions to pass legacy secret names such as `api_key`. YAML and Plain always redact secrets and apply human-readable formatting.
 
 ```python
 output_json(value: Any) -> str   # Single-line JSON, original keys, for programs/logs
 output_json_with(value: Any, redaction_policy: RedactionPolicy) -> str
+output_json_with_options(value: Any, redaction_options: RedactionOptions) -> str
 output_yaml(value: Any) -> str   # Multi-line YAML, keys stripped, values formatted
+output_yaml_with_options(value: Any, redaction_options: RedactionOptions) -> str
 output_plain(value: Any) -> str  # Single-line logfmt, keys stripped, values formatted
+output_plain_with_options(value: Any, redaction_options: RedactionOptions) -> str
 ```
 
 ```python
 class RedactionPolicy(enum.Enum):
     RedactionTraceOnly = "RedactionTraceOnly"
     RedactionNone = "RedactionNone"
+    RedactionStrict = "RedactionStrict"
+
+RedactionOptions(policy: RedactionPolicy | None = None, secret_names: Sequence[str] = ())
 ```
 
+Secret names match exact field names at any nesting level; there is no trim, case folding, hyphen/underscore normalization, glob, regex, or substring matching. They do not change YAML/Plain suffix stripping.
+
 **Example:**
 ```python
 from agent_first_data import *
@@ -178,6 +196,7 @@ print(output_plain(data))
 
 ```python
 internal_redact_secrets(value: Any) -> None  # Manually redact secrets in-place
+internal_redact_secrets_with_options(value: Any, redaction_options: RedactionOptions) -> None
 ```
 
 Most users don't need this. Output functions automatically protect secrets.
@@ -513,7 +532,7 @@ All formats automatically redact `_secret` fields.
 
 ## Repository
 
-This package is part of the [agent-first-data](https://github.com/cmnspore/agent-first-data) repository, which also contains:
+This package is part of the [agent-first-data](https://github.com/agentfirstkit/agent-first-data) repository, which also contains:
 
 - **`spec/`** — Full AFDATA specification with suffix definitions, protocol format rules, and cross-language test fixtures
 - **`skills/`** — AI coding agent skill for working with AFDATA conventions
@@ -521,7 +540,7 @@ This package is part of the [agent-first-data](https://github.com/cmnspore/agent
 To run tests, clone the full repository (tests use shared cross-language fixtures from `spec/fixtures/`):
 
 ```bash
-git clone https://github.com/cmnspore/agent-first-data
+git clone https://github.com/agentfirstkit/agent-first-data
 cd agent-first-data/python
 python -m pytest
 ```

agent_first_data-0.7.4/PKG-INFO → agent_first_data-0.8.1/README.md

@@ -1,12 +1,3 @@
-Metadata-Version: 2.4
-Name: agent-first-data
-Version: 0.7.4
-Summary: Agent-First Data (AFDATA) — suffix-driven output formatting and protocol templates for AI agents
-License-Expression: MIT
-Project-URL: Repository, https://github.com/cmnspore/agent-first-data
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-
 # agent-first-data
 
 **Agent-First Data (AFDATA)** — Suffix-driven output formatting and protocol templates for AI agents.
@@ -74,7 +65,7 @@ Plain: args.input_path=/data/backup.tar.gz code=log event=startup config.max_fil
 
 ## API Reference
 
-Total: **13 public APIs and 2 types** + **AFDATA logging** (3 protocol builders + 4 output functions + 1 internal + 1 utility + 4 CLI helpers + `OutputFormat` + `RedactionPolicy`)
+Public APIs are grouped by role: protocol builders, redaction helpers, output formatters, internal redaction tools, utility/CLI helpers, types, and AFDATA logging integration.
 
 ### Protocol Builders (returns dict)
 
@@ -91,6 +82,16 @@ build_json_error(message: str, hint: str = None, trace: Any = None) -> dict
 build_json(code: str, fields: Any, trace: Any = None) -> dict
 ```
 
+### Redaction Helpers (returns Any)
+
+Use these before raw HTTP/MCP/SSE serializers that do not call `output_json`.
+
+```python
+redacted_value(value: Any) -> Any
+redacted_value_with(value: Any, redaction_policy: RedactionPolicy) -> Any
+redacted_value_with_options(value: Any, redaction_options: RedactionOptions) -> Any
+```
+
 **Use case:** structured protocol payloads (frameworks automatically serialize)
 
 **Example:**
@@ -129,23 +130,31 @@ not_found = build_json(
 )
 ```
 
-### CLI/Log Output (returns str)
+### Output Formatters (returns str)
 
-Format values for CLI output and logs. `output_json` uses full `_secret` redaction by default. `output_json_with` supports explicit scoped policies. YAML and Plain always redact `_secret` and apply human-readable formatting.
+Format values for CLI output and logs. `output_json` uses full `_secret` redaction by default. `output_json_with` supports explicit scoped policies. Use the `*_with_options` functions to pass legacy secret names such as `api_key`. YAML and Plain always redact secrets and apply human-readable formatting.
 
 ```python
 output_json(value: Any) -> str   # Single-line JSON, original keys, for programs/logs
 output_json_with(value: Any, redaction_policy: RedactionPolicy) -> str
+output_json_with_options(value: Any, redaction_options: RedactionOptions) -> str
 output_yaml(value: Any) -> str   # Multi-line YAML, keys stripped, values formatted
+output_yaml_with_options(value: Any, redaction_options: RedactionOptions) -> str
 output_plain(value: Any) -> str  # Single-line logfmt, keys stripped, values formatted
+output_plain_with_options(value: Any, redaction_options: RedactionOptions) -> str
 ```
 
 ```python
 class RedactionPolicy(enum.Enum):
     RedactionTraceOnly = "RedactionTraceOnly"
     RedactionNone = "RedactionNone"
+    RedactionStrict = "RedactionStrict"
+
+RedactionOptions(policy: RedactionPolicy | None = None, secret_names: Sequence[str] = ())
 ```
 
+Secret names match exact field names at any nesting level; there is no trim, case folding, hyphen/underscore normalization, glob, regex, or substring matching. They do not change YAML/Plain suffix stripping.
+
 **Example:**
 ```python
 from agent_first_data import *
@@ -178,6 +187,7 @@ print(output_plain(data))
 
 ```python
 internal_redact_secrets(value: Any) -> None  # Manually redact secrets in-place
+internal_redact_secrets_with_options(value: Any, redaction_options: RedactionOptions) -> None
 ```
 
 Most users don't need this. Output functions automatically protect secrets.
@@ -513,7 +523,7 @@ All formats automatically redact `_secret` fields.
 
 ## Repository
 
-This package is part of the [agent-first-data](https://github.com/cmnspore/agent-first-data) repository, which also contains:
+This package is part of the [agent-first-data](https://github.com/agentfirstkit/agent-first-data) repository, which also contains:
 
 - **`spec/`** — Full AFDATA specification with suffix definitions, protocol format rules, and cross-language test fixtures
 - **`skills/`** — AI coding agent skill for working with AFDATA conventions
@@ -521,7 +531,7 @@ This package is part of the [agent-first-data](https://github.com/cmnspore/agent
 To run tests, clone the full repository (tests use shared cross-language fixtures from `spec/fixtures/`):
 
 ```bash
-git clone https://github.com/cmnspore/agent-first-data
+git clone https://github.com/agentfirstkit/agent-first-data
 cd agent-first-data/python
 python -m pytest
 ```

{agent_first_data-0.7.4 → agent_first_data-0.8.1}/agent_first_data/__init__.py

@@ -5,11 +5,19 @@ from agent_first_data.format import (
     build_json_error,
     build_json,
     RedactionPolicy,
+    RedactionOptions,
     output_json,
     output_json_with,
+    output_json_with_options,
     output_yaml,
+    output_yaml_with_options,
     output_plain,
+    output_plain_with_options,
     internal_redact_secrets,
+    internal_redact_secrets_with_options,
+    redacted_value,
+    redacted_value_with,
+    redacted_value_with_options,
     parse_size,
 )
 
@@ -36,11 +44,19 @@ __all__ = [
     "build_json_error",
     "build_json",
     "RedactionPolicy",
+    "RedactionOptions",
     "output_json",
     "output_json_with",
+    "output_json_with_options",
     "output_yaml",
+    "output_yaml_with_options",
     "output_plain",
+    "output_plain_with_options",
     "internal_redact_secrets",
+    "internal_redact_secrets_with_options",
+    "redacted_value",
+    "redacted_value_with",
+    "redacted_value_with_options",
     "parse_size",
     "AfdataHandler",
     "AfdataJsonHandler",

{agent_first_data-0.7.4 → agent_first_data-0.8.1}/agent_first_data/format.py

@@ -1,15 +1,17 @@
 """AFDATA output formatting and protocol templates.
 
-9 public APIs and 1 type: 3 protocol builders + 4 output formatters + 1 redaction + 1 utility + RedactionPolicy.
+16 public APIs and 2 types: protocol builders, redacted value helpers,
+output formatters, redaction, parse_size, RedactionPolicy, and RedactionOptions.
 """
 
 from __future__ import annotations
 
 import json
 import math
+from dataclasses import dataclass
 from datetime import datetime, timezone
 from enum import Enum
-from typing import Any
+from typing import Any, Sequence
 
 
 # ═══════════════════════════════════════════
@@ -51,25 +53,48 @@ def build_json(code: str, fields: Any, trace: Any = None) -> dict:
 class RedactionPolicy(str, Enum):
     RedactionTraceOnly = "RedactionTraceOnly"
     RedactionNone = "RedactionNone"
+    RedactionStrict = "RedactionStrict"
+
+
+@dataclass(frozen=True)
+class RedactionOptions:
+    """Redaction options for legacy secret field names."""
+
+    policy: RedactionPolicy | None = None
+    # Exact field-name matches at any nesting level.
+    secret_names: Sequence[str] = ()
 
 
 def output_json(value: Any) -> str:
     """Format as single-line JSON. Secrets redacted, original keys, raw values."""
-    v = _sanitize_for_json(value)
-    _redact_secrets(v)
-    return json.dumps(v, ensure_ascii=False, separators=(",", ":"))
+    return json.dumps(redacted_value(value), ensure_ascii=False, separators=(",", ":"))
 
 
 def output_json_with(value: Any, redaction_policy: RedactionPolicy) -> str:
     """Format as single-line JSON with explicit redaction policy."""
-    v = _sanitize_for_json(value)
-    _apply_redaction_policy(v, redaction_policy)
-    return json.dumps(v, ensure_ascii=False, separators=(",", ":"))
+    return json.dumps(redacted_value_with(value, redaction_policy), ensure_ascii=False, separators=(",", ":"))
+
+
+def output_json_with_options(value: Any, redaction_options: RedactionOptions) -> str:
+    """Format as single-line JSON with explicit redaction options."""
+    return json.dumps(
+        redacted_value_with_options(value, redaction_options),
+        ensure_ascii=False,
+        separators=(",", ":"),
+    )
 
 
 def output_yaml(value: Any) -> str:
     """Format as multi-line YAML. Keys stripped, values formatted, secrets redacted."""
-    value = _sanitize_for_json(value)
+    value = redacted_value(value)
+    lines = ["---"]
+    _render_yaml_processed(value, 0, lines)
+    return "\n".join(lines)
+
+
+def output_yaml_with_options(value: Any, redaction_options: RedactionOptions) -> str:
+    """Format as multi-line YAML with explicit redaction options."""
+    value = redacted_value_with_options(value, redaction_options)
     lines = ["---"]
     _render_yaml_processed(value, 0, lines)
     return "\n".join(lines)
@@ -77,16 +102,25 @@ def output_yaml(value: Any) -> str:
 
 def output_plain(value: Any) -> str:
     """Format as single-line logfmt. Keys stripped, values formatted, secrets redacted."""
-    value = _sanitize_for_json(value)
+    value = redacted_value(value)
     pairs: list[tuple[str, str]] = []
     _collect_plain_pairs(value, "", pairs)
     pairs.sort(key=lambda p: p[0].encode("utf-16-be"))
     parts = []
     for k, v in pairs:
-        if " " in v:
-            parts.append(f'{k}="{v}"')
-        else:
-            parts.append(f"{k}={v}")
+        parts.append(f"{k}={_quote_logfmt_value(v)}")
+    return " ".join(parts)
+
+
+def output_plain_with_options(value: Any, redaction_options: RedactionOptions) -> str:
+    """Format as single-line logfmt with explicit redaction options."""
+    value = redacted_value_with_options(value, redaction_options)
+    pairs: list[tuple[str, str]] = []
+    _collect_plain_pairs(value, "", pairs)
+    pairs.sort(key=lambda p: p[0].encode("utf-16-be"))
+    parts = []
+    for k, v in pairs:
+        parts.append(f"{k}={_quote_logfmt_value(v)}")
     return " ".join(parts)
 
 
@@ -100,15 +134,57 @@ def internal_redact_secrets(value: Any) -> None:
     _redact_secrets(value)
 
 
+def internal_redact_secrets_with_options(value: Any, redaction_options: RedactionOptions) -> None:
+    """Redact secret fields in-place using explicit redaction options."""
+    _apply_redaction_options(value, redaction_options)
+
+
+def redacted_value(value: Any) -> Any:
+    """Return a JSON-safe copy with default _secret redaction applied."""
+    v = _sanitize_for_json(value)
+    _redact_secrets(v)
+    return v
+
+
+def redacted_value_with(value: Any, redaction_policy: RedactionPolicy) -> Any:
+    """Return a JSON-safe copy with an explicit redaction policy applied."""
+    v = _sanitize_for_json(value)
+    _apply_redaction_policy(v, redaction_policy)
+    return v
+
+
+def redacted_value_with_options(value: Any, redaction_options: RedactionOptions) -> Any:
+    """Return a JSON-safe copy with explicit redaction options applied."""
+    v = _sanitize_for_json(value)
+    _apply_redaction_options(v, redaction_options)
+    return v
+
+
 def _apply_redaction_policy(value: Any, redaction_policy: RedactionPolicy) -> None:
+    _apply_redaction_policy_with_names(value, redaction_policy, frozenset())
+
+
+def _apply_redaction_options(value: Any, redaction_options: RedactionOptions) -> None:
+    secret_names = _secret_name_set(redaction_options.secret_names)
+    _apply_redaction_policy_with_names(value, redaction_options.policy, secret_names)
+
+
+def _apply_redaction_policy_with_names(
+    value: Any,
+    redaction_policy: RedactionPolicy | None,
+    secret_names: frozenset[str],
+) -> None:
     if redaction_policy == RedactionPolicy.RedactionTraceOnly:
         if isinstance(value, dict) and "trace" in value:
-            _redact_secrets(value["trace"])
+            _redact_secrets(value["trace"], secret_names)
         return
     if redaction_policy == RedactionPolicy.RedactionNone:
         return
-    # Safety fallback for unknown values.
-    _redact_secrets(value)
+    if redaction_policy == RedactionPolicy.RedactionStrict:
+        _redact_secrets_strict(value, secret_names)
+        return
+    # Empty/unknown policy falls back to default full redaction.
+    _redact_secrets(value, secret_names)
 
 
 def parse_size(s: str) -> int | None:
@@ -196,19 +272,43 @@ def _sanitize_for_json(value: Any, stack: set[int] | None = None) -> Any:
     return f"<unsupported:{type(value).__name__}>"
 
 
-def _redact_secrets(value: Any) -> None:
+def _secret_name_set(secret_names: Sequence[str]) -> frozenset[str]:
+    return frozenset(secret_names)
+
+
+def _key_has_secret_suffix(key: str) -> bool:
+    return key.endswith("_secret") or key.endswith("_SECRET")
+
+
+def _is_secret_key(key: str, secret_names: frozenset[str]) -> bool:
+    return _key_has_secret_suffix(key) or key in secret_names
+
+
+def _redact_secrets(value: Any, secret_names: frozenset[str] = frozenset()) -> None:
     if isinstance(value, dict):
         for k in list(value.keys()):
-            if k.endswith("_secret") or k.endswith("_SECRET"):
+            if _is_secret_key(k, secret_names):
                 if isinstance(value[k], (dict, list)):
-                    _redact_secrets(value[k])
+                    _redact_secrets(value[k], secret_names)
                 else:
                     value[k] = "***"
             else:
-                _redact_secrets(value[k])
+                _redact_secrets(value[k], secret_names)
+    elif isinstance(value, list):
+        for item in value:
+            _redact_secrets(item, secret_names)
+
+
+def _redact_secrets_strict(value: Any, secret_names: frozenset[str] = frozenset()) -> None:
+    if isinstance(value, dict):
+        for k in list(value.keys()):
+            if _is_secret_key(k, secret_names):
+                value[k] = "***"
+            else:
+                _redact_secrets_strict(value[k], secret_names)
     elif isinstance(value, list):
         for item in value:
-            _redact_secrets(item)
+            _redact_secrets_strict(item, secret_names)
 
 
 # ═══════════════════════════════════════════
@@ -572,3 +672,19 @@ def _plain_scalar(value: Any) -> str:
     if isinstance(value, (int, float)):
         return str(value)
     return str(value)
+
+
+def _quote_logfmt_value(value: str) -> str:
+    if value == "":
+        return ""
+    needs_quote = any(c.isspace() or c in '="\\"' for c in value)
+    if not needs_quote:
+        return value
+    escaped = (
+        value.replace("\\", "\\\\")
+        .replace('"', '\\"')
+        .replace("\n", "\\n")
+        .replace("\r", "\\r")
+        .replace("\t", "\\t")
+    )
+    return f'"{escaped}"'

agent_first_data-0.7.4/README.md → agent_first_data-0.8.1/agent_first_data.egg-info/PKG-INFO

@@ -1,3 +1,12 @@
+Metadata-Version: 2.4
+Name: agent-first-data
+Version: 0.8.1
+Summary: A naming convention that lets AI agents understand your data without being told what it means.
+License-Expression: MIT
+Project-URL: Repository, https://github.com/agentfirstkit/agent-first-data
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
 # agent-first-data
 
 **Agent-First Data (AFDATA)** — Suffix-driven output formatting and protocol templates for AI agents.
@@ -65,7 +74,7 @@ Plain: args.input_path=/data/backup.tar.gz code=log event=startup config.max_fil
 
 ## API Reference
 
-Total: **13 public APIs and 2 types** + **AFDATA logging** (3 protocol builders + 4 output functions + 1 internal + 1 utility + 4 CLI helpers + `OutputFormat` + `RedactionPolicy`)
+Public APIs are grouped by role: protocol builders, redaction helpers, output formatters, internal redaction tools, utility/CLI helpers, types, and AFDATA logging integration.
 
 ### Protocol Builders (returns dict)
 
@@ -82,6 +91,16 @@ build_json_error(message: str, hint: str = None, trace: Any = None) -> dict
 build_json(code: str, fields: Any, trace: Any = None) -> dict
 ```
 
+### Redaction Helpers (returns Any)
+
+Use these before raw HTTP/MCP/SSE serializers that do not call `output_json`.
+
+```python
+redacted_value(value: Any) -> Any
+redacted_value_with(value: Any, redaction_policy: RedactionPolicy) -> Any
+redacted_value_with_options(value: Any, redaction_options: RedactionOptions) -> Any
+```
+
 **Use case:** structured protocol payloads (frameworks automatically serialize)
 
 **Example:**
@@ -120,23 +139,31 @@ not_found = build_json(
 )
 ```
 
-### CLI/Log Output (returns str)
+### Output Formatters (returns str)
 
-Format values for CLI output and logs. `output_json` uses full `_secret` redaction by default. `output_json_with` supports explicit scoped policies. YAML and Plain always redact `_secret` and apply human-readable formatting.
+Format values for CLI output and logs. `output_json` uses full `_secret` redaction by default. `output_json_with` supports explicit scoped policies. Use the `*_with_options` functions to pass legacy secret names such as `api_key`. YAML and Plain always redact secrets and apply human-readable formatting.
 
 ```python
 output_json(value: Any) -> str   # Single-line JSON, original keys, for programs/logs
 output_json_with(value: Any, redaction_policy: RedactionPolicy) -> str
+output_json_with_options(value: Any, redaction_options: RedactionOptions) -> str
 output_yaml(value: Any) -> str   # Multi-line YAML, keys stripped, values formatted
+output_yaml_with_options(value: Any, redaction_options: RedactionOptions) -> str
 output_plain(value: Any) -> str  # Single-line logfmt, keys stripped, values formatted
+output_plain_with_options(value: Any, redaction_options: RedactionOptions) -> str
 ```
 
 ```python
 class RedactionPolicy(enum.Enum):
     RedactionTraceOnly = "RedactionTraceOnly"
     RedactionNone = "RedactionNone"
+    RedactionStrict = "RedactionStrict"
+
+RedactionOptions(policy: RedactionPolicy | None = None, secret_names: Sequence[str] = ())
 ```
 
+Secret names match exact field names at any nesting level; there is no trim, case folding, hyphen/underscore normalization, glob, regex, or substring matching. They do not change YAML/Plain suffix stripping.
+
 **Example:**
 ```python
 from agent_first_data import *
@@ -169,6 +196,7 @@ print(output_plain(data))
 
 ```python
 internal_redact_secrets(value: Any) -> None  # Manually redact secrets in-place
+internal_redact_secrets_with_options(value: Any, redaction_options: RedactionOptions) -> None
 ```
 
 Most users don't need this. Output functions automatically protect secrets.
@@ -504,7 +532,7 @@ All formats automatically redact `_secret` fields.
 
 ## Repository
 
-This package is part of the [agent-first-data](https://github.com/cmnspore/agent-first-data) repository, which also contains:
+This package is part of the [agent-first-data](https://github.com/agentfirstkit/agent-first-data) repository, which also contains:
 
 - **`spec/`** — Full AFDATA specification with suffix definitions, protocol format rules, and cross-language test fixtures
 - **`skills/`** — AI coding agent skill for working with AFDATA conventions
@@ -512,7 +540,7 @@ This package is part of the [agent-first-data](https://github.com/cmnspore/agent
 To run tests, clone the full repository (tests use shared cross-language fixtures from `spec/fixtures/`):
 
 ```bash
-git clone https://github.com/cmnspore/agent-first-data
+git clone https://github.com/agentfirstkit/agent-first-data
 cd agent-first-data/python
 python -m pytest
 ```

{agent_first_data-0.7.4 → agent_first_data-0.8.1}/pyproject.toml

@@ -1,14 +1,14 @@
 [project]
 name = "agent-first-data"
-version = "0.7.4"
-description = "Agent-First Data (AFDATA) — suffix-driven output formatting and protocol templates for AI agents"
+version = "0.8.1"
+description = "A naming convention that lets AI agents understand your data without being told what it means."
 license = "MIT"
 readme = "README.md"
 requires-python = ">=3.9"
 dependencies = []
 
 [project.urls]
-Repository = "https://github.com/cmnspore/agent-first-data"
+Repository = "https://github.com/agentfirstkit/agent-first-data"
 
 [build-system]
 requires = ["setuptools>=68"]

{agent_first_data-0.7.4 → agent_first_data-0.8.1}/tests/test_format.py

@@ -8,11 +8,19 @@ from agent_first_data import (
     build_json_error,
     build_json,
     RedactionPolicy,
+    RedactionOptions,
     internal_redact_secrets,
+    internal_redact_secrets_with_options,
+    redacted_value,
+    redacted_value_with,
+    redacted_value_with_options,
     output_json,
     output_json_with,
+    output_json_with_options,
     output_yaml,
+    output_yaml_with_options,
     output_plain,
+    output_plain_with_options,
 )
 from agent_first_data.format import (
     _format_bytes_human,
@@ -29,6 +37,12 @@ def _load(name):
         return json.load(f)
 
 
+def _redaction_options(case):
+    opts = case.get("options", {})
+    policy = RedactionPolicy(opts["policy"]) if "policy" in opts else None
+    return RedactionOptions(policy=policy, secret_names=opts.get("secret_names", ()))
+
+
 # --- Redact fixtures ---
 
 
@@ -40,6 +54,30 @@ def test_redact_fixtures():
         assert inp == case["expected"], f"[redact/{name}] got {inp}"
 
 
+def test_redaction_options_fixtures():
+    for case in _load("redaction_options.json"):
+        name = case["name"]
+        options = _redaction_options(case)
+        expected = case["expected"]
+
+        got = redacted_value_with_options(case["input"], options)
+        assert got == expected, f"[redaction_options/{name}] value mismatch: {got}"
+
+        inp = json.loads(json.dumps(case["input"]))
+        internal_redact_secrets_with_options(inp, options)
+        assert inp == expected, f"[redaction_options/{name}] in-place mismatch: {inp}"
+
+        got_json = json.loads(output_json_with_options(case["input"], options))
+        assert got_json == expected, f"[redaction_options/{name}] json mismatch: {got_json}"
+
+        if "expected_yaml" in case:
+            got_yaml = output_yaml_with_options(case["input"], options)
+            assert got_yaml == case["expected_yaml"], f"[redaction_options/{name}] yaml mismatch: {got_yaml!r}"
+        if "expected_plain" in case:
+            got_plain = output_plain_with_options(case["input"], options)
+            assert got_plain == case["expected_plain"], f"[redaction_options/{name}] plain mismatch: {got_plain!r}"
+
+
 # --- Protocol fixtures ---
 
 
@@ -156,3 +194,20 @@ def test_output_json_with_none_keeps_secrets():
     )
     parsed = json.loads(out)
     assert parsed["api_key_secret"] == "sk-live-123"
+
+
+def test_redacted_value_returns_safe_copy():
+    inp = {"api_key_secret": "sk-live-123", "nested": {"token_secret": "tok"}}
+    got = redacted_value(inp)
+    assert got["api_key_secret"] == "***"
+    assert got["nested"]["token_secret"] == "***"
+    assert inp["api_key_secret"] == "sk-live-123"
+
+
+def test_redacted_value_with_strict_redacts_secret_subtree():
+    inp = {"db_secret": {"password_secret": "real", "host": "localhost"}}
+    default = redacted_value(inp)
+    strict = redacted_value_with(inp, RedactionPolicy.RedactionStrict)
+    assert default["db_secret"]["password_secret"] == "***"
+    assert default["db_secret"]["host"] == "localhost"
+    assert strict["db_secret"] == "***"