agentledger-langfuse 1.2.3__tar.gz

agentledger_langfuse-1.2.3/.gitignore

@@ -0,0 +1,64 @@
+.agentledger/
+go/.agentledger-go/
+rust/.agentledger-rust/
+*.db
+*.sqlite
+*.sqlite3
+
+__pycache__/
+**/__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+$py.class
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+dist/
+build/
+*.egg-info/
+.venv/
+venv/
+.env
+.DS_Store
+**/.DS_Store
+node_modules/
+**/node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Local notes, research dumps, and generated reports that should not ship.
+.claude/
+AI_Agent_Runtime_开源项目构想.md
+*.pdf
+*.docx
+*.pptx
+*.pages
+*.key
+evidence/
+evidence*.html
+time-travel*.html
+
+# Local external installer/download artifacts.
+rce
+
+# Rust build outputs.
+target/
+**/target/
+rust/crates/*/Cargo.lock
+# Local transient files
+*.tmp
+*.log
+*.bak
+*.swp
+*.swo
+*.orig
+
+# Python/pytest leftovers not always covered by tool output
+.coverage.*
+htmlcov/
+.ipynb_checkpoints/

agentledger_langfuse-1.2.3/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: agentledger-langfuse
+Version: 1.2.3
+Summary: Langfuse evidence and trace export adapter package for AgentLedger
+Project-URL: Homepage, https://github.com/yaogdu/AgentLedger
+Project-URL: Repository, https://github.com/yaogdu/AgentLedger
+Project-URL: Documentation, https://github.com/yaogdu/AgentLedger/tree/main/docs
+Project-URL: Issues, https://github.com/yaogdu/AgentLedger/issues
+Author: AgentLedger Contributors
+License: Apache-2.0
+Keywords: agents,evidence,langfuse,runtime,tracing
+Requires-Python: >=3.11
+Requires-Dist: agentledger-runtime<2,>=1.2
+Description-Content-Type: text/markdown
+
+# agentledger-langfuse
+
+Langfuse evidence and trace export adapter package for AgentLedger.
+
+```bash
+pip install agentledger-langfuse
+pip install "agentledger-runtime[langfuse]"
+```
+
+```python
+from agentledger_langfuse import LangfuseTraceExporter
+
+payload = LangfuseTraceExporter().to_ingestion_payload(evidence_bundle)
+```
+
+This adapter is intentionally thin. It converts AgentLedger evidence spans into Langfuse-style ingestion records and can POST JSON to a user-provided endpoint. It does not replace Langfuse, own project/key management, or import the Langfuse SDK in runtime-core.
+
+Certification:
+
+```bash
+python3 -m agentledger adapter certify --kind langfuse --adapter-version 1.2.3
+```

agentledger_langfuse-1.2.3/README.md

@@ -0,0 +1,22 @@
+# agentledger-langfuse
+
+Langfuse evidence and trace export adapter package for AgentLedger.
+
+```bash
+pip install agentledger-langfuse
+pip install "agentledger-runtime[langfuse]"
+```
+
+```python
+from agentledger_langfuse import LangfuseTraceExporter
+
+payload = LangfuseTraceExporter().to_ingestion_payload(evidence_bundle)
+```
+
+This adapter is intentionally thin. It converts AgentLedger evidence spans into Langfuse-style ingestion records and can POST JSON to a user-provided endpoint. It does not replace Langfuse, own project/key management, or import the Langfuse SDK in runtime-core.
+
+Certification:
+
+```bash
+python3 -m agentledger adapter certify --kind langfuse --adapter-version 1.2.3
+```

agentledger_langfuse-1.2.3/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentledger-langfuse"
+version = "1.2.3"
+description = "Langfuse evidence and trace export adapter package for AgentLedger"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "Apache-2.0"}
+authors = [{name = "AgentLedger Contributors"}]
+keywords = ["agents", "runtime", "langfuse", "tracing", "evidence"]
+dependencies = ["agentledger-runtime>=1.2,<2"]
+
+[project.urls]
+Homepage = "https://github.com/yaogdu/AgentLedger"
+Repository = "https://github.com/yaogdu/AgentLedger"
+Documentation = "https://github.com/yaogdu/AgentLedger/tree/main/docs"
+Issues = "https://github.com/yaogdu/AgentLedger/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentledger_langfuse"]

agentledger_langfuse-1.2.3/src/agentledger_langfuse/__init__.py

@@ -0,0 +1,96 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass
+from typing import Any
+from urllib.request import Request, urlopen
+
+from agentledger.trace import TraceExporter, TraceSpan
+
+__version__ = "1.2.3"
+
+
+@dataclass(frozen=True)
+class LangfuseProject:
+    public_key: str | None = None
+    project: str | None = None
+    environment: str | None = None
+    release: str | None = None
+    tags: tuple[str, ...] = ()
+
+
+class LangfuseTraceExporter:
+    """Convert AgentLedger evidence spans into Langfuse-style ingestion records.
+
+    The exporter is dependency-free and SDK-neutral. Applications that already
+    use the Langfuse SDK can consume `to_ingestion_payload(...)`; deployments
+    that prefer HTTP can call `post_json(...)` with their own endpoint and auth
+    headers. Runtime-core does not own Langfuse project/key management.
+    """
+
+    def __init__(self, *, project: LangfuseProject | None = None, trace_exporter: TraceExporter | None = None) -> None:
+        self.project = project or LangfuseProject()
+        self.trace_exporter = trace_exporter or TraceExporter()
+
+    def to_ingestion_payload(self, evidence: Any) -> dict[str, Any]:
+        spans = self.trace_exporter.spans(evidence)
+        return {
+            "batch": [self._span_record(span) for span in spans],
+            "metadata": {
+                "source": "agentledger",
+                "project": self.project.project,
+                "environment": self.project.environment,
+                "release": self.project.release,
+                "tags": list(self.project.tags),
+            },
+        }
+
+    def to_json(self, evidence: Any) -> str:
+        return json.dumps(self.to_ingestion_payload(evidence), ensure_ascii=False, indent=2, sort_keys=True)
+
+    def post_json(
+        self,
+        evidence: Any,
+        endpoint: str,
+        *,
+        secret_key: str | None = None,
+        timeout: float = 10.0,
+        opener: Any | None = None,
+        headers: dict[str, str] | None = None,
+    ) -> dict[str, Any]:
+        body = self.to_json(evidence).encode("utf-8")
+        request_headers = {"Content-Type": "application/json", **(headers or {})}
+        if self.project.public_key:
+            request_headers["X-Langfuse-Public-Key"] = self.project.public_key
+        if secret_key:
+            request_headers["Authorization"] = f"Bearer {secret_key}"
+        request = Request(endpoint, data=body, headers=request_headers, method="POST")
+        sender = opener or urlopen
+        response = sender(request, timeout=timeout)
+        status = getattr(response, "status", getattr(response, "code", None))
+        response_body = response.read().decode("utf-8", errors="replace") if hasattr(response, "read") else ""
+        if status is not None and int(status) >= 400:
+            raise RuntimeError(f"Langfuse endpoint returned HTTP {status}: {response_body}")
+        return {"endpoint": endpoint, "status": status, "bytes_sent": len(body), "response": response_body}
+
+    def _span_record(self, span: TraceSpan) -> dict[str, Any]:
+        return {
+            "type": "trace-span",
+            "traceId": span.trace_id,
+            "id": span.span_id,
+            "parentObservationId": span.parent_span_id,
+            "name": span.name,
+            "startTime": span.start_time,
+            "endTime": span.end_time,
+            "metadata": {
+                **span.attributes,
+                "agentledger.exporter": "langfuse",
+                "agentledger.project": self.project.project,
+                "agentledger.environment": self.project.environment,
+                "agentledger.release": self.project.release,
+            },
+            "tags": list(self.project.tags),
+        }
+
+
+__all__ = ["LangfuseProject", "LangfuseTraceExporter", "__version__"]

agentledger_langfuse-1.2.3/tests/test_import.py

@@ -0,0 +1,5 @@
+def test_imports() -> None:
+    from agentledger_langfuse import LangfuseProject, LangfuseTraceExporter
+
+    assert LangfuseProject.__name__ == "LangfuseProject"
+    assert LangfuseTraceExporter.__name__ == "LangfuseTraceExporter"