Metadata-Version: 2.4
Name: good_neighbor_passport
Version: 1.0.0
Summary: Good-neighbor agent traffic passport: RFC 9421-style Ed25519 budget passport, egress governor, host metering, hash-chained compliance log
License: Apache-2.0
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: cryptography
Requires-Dist: httpx
Dynamic: license-file

# good_neighbor_passport 1.0.0

Good-neighbor passport: agent traffic governor — by TextForAgents LLC.

Budget-bearing RFC 9421-style Ed25519 passport (signed per-host budget
capped at published ceilings), egress governor (local budget refusal,
ETag etiquette, 402 billing-unit normalizer), independent host honoring
it with graduated allow/throttle/charge/block, and a hash-chained
compliance log (append-only, single-hash-linked, operator-signed
checkpoints) whose segments restore an honest fleet in a dispute by
admitted-count symmetry and fail fabricated/tampered logs.

## Quickstart
```python
from good_neighbor_passport.signing import new_keypair, pubkey_b64, sign_request
from good_neighbor_passport.log import ComplianceLog, verify_segment
from good_neighbor_passport.normalizer import decide

priv, pub = new_keypair()
print(pubkey_b64(pub))
log = ComplianceLog(max_entries=1000)  # tier-capped retention
log.append("request", "example.org", {"path": "/data", "status": 200})
assert verify_segment(log.entries, expected_first_prev="GENESIS")
print(decide({"amount_microusd": 500, "unit": "per-request"},
             {"calls": 1, "queries": 1, "est_tokens": 0, "est_mb": 0}, 1000, 10000))
```
Full governor/host/directory usage: see the hosted docs at
https://textforagents.com/products/good-neighbor-agent-traffic-passport/

## License
Original code: TextForAgents LLC, released under Apache-2.0 (LICENSE).
Vendored x402 http-message-signatures extension specification material
(http-message-signatures.md) is Apache-2.0 — its LICENSE text and NOTICE
ship in this release, per LEGAL-055 / packet 02.
