io.github.jdhart81/green-router

green-router

Carbon-accounted agent compute: free footprints; certificates backed by real offset retirement.

Security review

Review passed

Reviewed Jan 1, 2000.

No findings.

quote_footprint
FREE: honest energy/carbon footprint for an agent workload — {backend_id? (frontier_cloud | efficient_cloud | local_small), total_tokens, output_tokens, calls?, success_score?, grid_gco2e_per_kwh?, pue?, custom_backend? {id, wh_per_1k_tokens}}. Returns joules, gCO2e, useful bits, the retirement mass a certificate would carry, every model assumption with its source, and the Landauer context (GR1/GR2).
green_route
FREE: rank compute backends by carbon for this workload — the greenest eligible path and the gCO2e saved per call. Carbon only (GR6); pair with /neurogenesis/mcp route_task for quality-floor routing.
certify
PAID ($0.50 after free tier): compute the workload footprint, then RETIRE the required verified offset mass through the fleet's own clearinghouse — Verra provenance rides into the certificate; no retirement, no certificate (GR3, fail-closed). Returns a machine-verifiable certificate anyone can check for free (GR4).
verify_green_certificate
FREE forever (GR5): recompute a certificate's footprint from its stored workload, compare against the certified numbers, and surface the clearinghouse purchase_id for the independent x402-C verify_retirement check on /offsets/mcp.
list_green_certificates
FREE: the certificate ledger — counts, total grams retired, total clearinghouse cost (honest books, GR8).
describe_agent
Return capabilities and input contract.