AtherDLP (Python) — Stage 1 HTTP Interceptor

Stage 1 intercepts outbound HTTP requests, classifies the destination (O(1) registry lookup), attaches a trace context, and emits a structured payload to a handler.

Install (dev)

cd AtherDLP-sdk/python
python -m pip install -e ".[test]"

Usage

import httpx
import atherdlp

def handler(payload: dict) -> None:
    print(payload)

atherdlp.set_handler(handler)
atherdlp.install()

httpx.get("https://api.openai.com/v1/models", headers={"authorization": "Bearer x"})

atherdlp.uninstall()

Tracing

• If the request includes a correlation header (e.g. X-Correlation-Id), it is propagated automatically (safe values only: ASCII alphanumeric + -, 1–64 chars).
• If not present or invalid, AtherDLP generates its own trace id (trace.trace_id in the payload).
• Ather-specific tracing is always added on the outbound call via x-ather-trace-id (and x-ather-span-id).

More detail: docs/SDK.md → Trace And Recursion Guards.

httpx.post(url, headers={"X-Correlation-Id": "my-route-8842"})

Output payload

{
  "request": { "method": "...", "url": "...", "headers": { }, "body": null },
  "classification": { "kind": "llm|http.out|unknown", "vendor": "...", "sensitivity": "..." },
  "trace": { "trace_id": "...", "span_id": "...", "parent_span_id": null }
}