openwright-langfuse 0.3.0__py3-none-any.whl

openwright_langfuse/__init__.py

@@ -0,0 +1,98 @@
+"""Langfuse forwarder for OpenWright (CONN-2).
+
+The downstream-observability pattern as a :class:`Forwarder`:
+
+* ``forward``  — co-ingest a telemetry batch to Langfuse **unchanged**, injecting
+  Basic auth + ``x-langfuse-ingestion-version: 4`` (Langfuse is HTTP-only).
+* ``backlink`` — push ``openwright:<control>`` **scores** (the verdicts) onto the
+  Langfuse trace via the public API, with the reason as a comment, and return a
+  deep-link to the trace.
+* ``pull``     — read Langfuse scores/evals and yield them as ``ComplianceEvent``s
+  (evals-as-evidence).
+
+No crypto here; payloads are hashed by the source connector before they become
+events. ``config`` carries ``host``, ``public_key``, ``secret_key`` and per-call
+fields (``trace_id`` for ``backlink``). Pass ``_transport`` (an httpx transport)
+to talk to a stub in tests.
+"""
+
+from __future__ import annotations
+
+import base64
+from typing import Any, Iterable
+
+from openwright.connectors import CONTRACT_VERSION, ExportResult
+
+__all__ = ["LangfuseForwarder", "forwarder", "CONTRACT_VERSION"]
+
+
+class LangfuseForwarder:
+    name = "langfuse"
+    CONTRACT_VERSION = CONTRACT_VERSION
+
+    def _client(self, config: dict):
+        import httpx
+
+        host = str(config["host"]).rstrip("/")
+        token = base64.b64encode(
+            f"{config['public_key']}:{config['secret_key']}".encode("utf-8")
+        ).decode("ascii")
+        headers = {
+            "Authorization": f"Basic {token}",
+            "x-langfuse-ingestion-version": "4",
+        }
+        return httpx.Client(
+            base_url=host, headers=headers, timeout=config.get("timeout", 10),
+            transport=config.get("_transport"),
+        )
+
+    def forward(self, payload: Any, *, config: dict) -> ExportResult:
+        path = config.get("ingest_path", "/api/public/otel/v1/traces")
+        with self._client(config) as c:
+            if isinstance(payload, (bytes, bytearray)):
+                r = c.post(path, content=bytes(payload),
+                           headers={"Content-Type": "application/x-protobuf"})
+            else:
+                r = c.post(path, json=payload)
+        return ExportResult(ok=r.is_success, detail=f"forward -> HTTP {r.status_code}")
+
+    def backlink(self, report: dict, *, config: dict) -> ExportResult:
+        trace_id = config.get("trace_id")
+        oks: list[bool] = []
+        with self._client(config) as c:
+            for ctrl in report.get("controls", []):
+                body = {
+                    "traceId": trace_id,
+                    "name": f"openwright:{ctrl['control_id']}",
+                    "value": ctrl["status"],
+                    "dataType": "CATEGORICAL",
+                    "comment": (ctrl.get("reason") or "")[:500],
+                }
+                oks.append(c.post("/api/public/scores", json=body).is_success)
+        url = f"{str(config['host']).rstrip('/')}/trace/{trace_id}" if trace_id else None
+        ok = all(oks) if oks else True
+        return ExportResult(ok=ok, detail=f"back-linked {sum(oks)}/{len(oks)} verdict(s)", url=url)
+
+    def pull(self, *, config: dict) -> Iterable[Any]:
+        from openwright.canonical import to_rfc3339
+        from openwright.events import ComplianceEvent, EventKind
+
+        with self._client(config) as c:
+            r = c.get("/api/public/scores", params={"limit": config.get("limit", 50)})
+            r.raise_for_status()
+            for sc in r.json().get("data", []):
+                yield ComplianceEvent(
+                    timestamp=to_rfc3339(sc.get("timestamp") or "1970-01-01T00:00:00.000000000Z"),
+                    kind=EventKind.CONFORMANCE_FINDING,
+                    actor={"agent_id": "langfuse"},
+                    source={"format": "langfuse"},
+                    attributes={
+                        "score_name": sc.get("name"),
+                        "value": str(sc.get("value")),
+                        "trace_id": sc.get("traceId"),
+                    },
+                )
+
+
+#: The object the ``openwright.forwarders:langfuse`` entry point loads to.
+forwarder = LangfuseForwarder()

openwright_langfuse-0.3.0.dist-info/METADATA

@@ -0,0 +1,34 @@
+Metadata-Version: 2.4
+Name: openwright-langfuse
+Version: 0.3.0
+Summary: Langfuse forwarder for OpenWright — co-ingest + openwright:* verdict back-link + evals-as-evidence.
+License: Apache-2.0
+Keywords: evidence,forwarder,langfuse,observability,openwright
+Requires-Python: <3.15,>=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: openwright-core<0.7,>=0.6
+Provides-Extra: test
+Requires-Dist: openwright-conformance; extra == 'test'
+Requires-Dist: pytest>=8; extra == 'test'
+Description-Content-Type: text/markdown
+
+# openwright-langfuse
+
+A **Langfuse forwarder** for [OpenWright](https://github.com/allthingsN/openwright):
+keep your traces in Langfuse *and* attach the OpenWright verdicts back to them.
+
+- **forward** — co-ingest a telemetry batch to Langfuse unchanged (Basic auth +
+  `x-langfuse-ingestion-version: 4`).
+- **backlink** — push `openwright:<control>` scores (the verdicts) onto the trace,
+  with the reason as a comment; returns a deep-link.
+- **pull** — read Langfuse scores/evals back as `ComplianceEvent`s (evals-as-evidence).
+
+```python
+from openwright.connectors import load
+fwd = load("openwright.forwarders", "langfuse")
+cfg = {"host": "https://cloud.langfuse.com", "public_key": "pk-…", "secret_key": "sk-…", "trace_id": trace_id}
+fwd.backlink(report, config=cfg)   # openwright:* verdicts now on the Langfuse trace
+```
+
+No partnership or endorsement implied; built on Langfuse's public HTTP API. No
+crypto is reimplemented here.

openwright_langfuse-0.3.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+openwright_langfuse/__init__.py,sha256=-Rpbz0jYFYzhTjzGv5OrPBX5MPsbhKVohfuGfo-QWl4,4084
+openwright_langfuse-0.3.0.dist-info/METADATA,sha256=rukJgofiURlXVGM2FToagU3nRydK0KE9vsbggxbrZug,1463
+openwright_langfuse-0.3.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+openwright_langfuse-0.3.0.dist-info/entry_points.txt,sha256=2Yf_qcZsEjHtzvwkOeTXk7brLRPM5-d7Ky3WMSYrXPs,65
+openwright_langfuse-0.3.0.dist-info/RECORD,,

openwright_langfuse-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

openwright_langfuse-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[openwright.forwarders]
+langfuse = openwright_langfuse:forwarder