sovara 0.3.2__tar.gz → 0.3.3__tar.gz

sovara-0.3.3/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.4
+Name: sovara
+Version: 0.3.3
+Summary: Python SDK for Sovara agent observability and runtime instrumentation
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: dill
+Requires-Dist: flatten_dict
+Requires-Dist: flatten_json
+Requires-Dist: httpx
+Requires-Dist: jsonpickle>=4.1.1
+Requires-Dist: pydantic
+Requires-Dist: pyyaml
+Provides-Extra: examples
+Requires-Dist: openai; extra == "examples"
+Requires-Dist: anthropic; extra == "examples"
+Requires-Dist: openai-agents; extra == "examples"
+Requires-Dist: google-genai; extra == "examples"
+Requires-Dist: claude-agent-sdk; extra == "examples"
+
+# Sovara Python SDK
+
+The `sovara` package instruments Python agents so Sovara can record LLM calls,
+tool calls, logs, and custom trace spans.
+
+Install it in the Python environment where your agent runs:
+
+```bash
+python -m pip install sovara
+```
+
+Or with `uv`:
+
+```bash
+uv add sovara
+```
+
+Use `sovara.run(...)` for library-mode recording:
+
+```python
+import sovara
+
+with sovara.run("support-agent"):
+    run_agent()
+```
+
+The terminal command is distributed separately as the native Sovara CLI. Install
+that CLI for commands such as `sovara record`, `sovara status`, and
+`sovara probe`.

sovara-0.3.3/README.md

@@ -0,0 +1,29 @@
+# Sovara Python SDK
+
+The `sovara` package instruments Python agents so Sovara can record LLM calls,
+tool calls, logs, and custom trace spans.
+
+Install it in the Python environment where your agent runs:
+
+```bash
+python -m pip install sovara
+```
+
+Or with `uv`:
+
+```bash
+uv add sovara
+```
+
+Use `sovara.run(...)` for library-mode recording:
+
+```python
+import sovara
+
+with sovara.run("support-agent"):
+    run_agent()
+```
+
+The terminal command is distributed separately as the native Sovara CLI. Install
+that CLI for commands such as `sovara record`, `sovara status`, and
+`sovara probe`.

sovara-0.3.3/pyproject.toml

@@ -0,0 +1,40 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.package-data]
+"sovara.assets" = ["SKILL.md"]
+"sovara.common" = ["*.json"]
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["sovara*"]
+
+[project]
+name = "sovara"
+version = "0.3.3"
+description = "Python SDK for Sovara agent observability and runtime instrumentation"
+readme = "README.md"
+requires-python = ">=3.10"
+
+dependencies = [
+    "dill",
+    "flatten_dict",
+    "flatten_json",
+    "httpx",
+    "jsonpickle>=4.1.1",
+    "pydantic",
+    "pyyaml",
+]
+
+[project.optional-dependencies]
+examples = [
+    "openai",
+    "anthropic",
+    "openai-agents",
+    "google-genai",
+    "claude-agent-sdk",
+]

{sovara-0.3.2 → sovara-0.3.3}/src/sovara/__init__.py

@@ -13,11 +13,13 @@ from sovara.runner.public import (
     queue_for_annotation_async,
     run,
 )
+from sovara.runner.trace import trace
 
 apply_all_monkey_patches()
 
 __all__ = [
     "run",
+    "trace",
     "annotate",
     "queue_for_annotation",
     "queue_for_annotation_async",