agenttrace-io 0.1.9__tar.gz

agenttrace_io-0.1.9/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: agenttrace-io
+Version: 0.1.9
+Summary: AgentTrace Python SDK - Drop-in tracing for any AI agent
+Author: Klepsiphron
+License: MIT
+Project-URL: Homepage, https://github.com/Klepsiphron/agenttrace
+Project-URL: Repository, https://github.com/Klepsiphron/agenttrace
+Keywords: ai,agents,observability,tracing,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+
+# agenttrace-io (Python SDK)
+
+Drop-in tracing for any AI agent. Local SQLite storage, zero dependencies, zero cloud.
+
+## Installation
+
+```bash
+pip install agenttrace-io
+```
+
+Requires Python 3.10+.
+
+## Quickstart
+
+```python
+from agenttrace import init, trace
+
+agent = init(db_path="./traces.db")
+
+# Trace a callable
+result = agent.trace("my-op", lambda: 42 * 2)
+
+# Use as decorator
+@trace("greet")
+def greet(name: str) -> str:
+    return f"Hello, {name}"
+
+# Use as context manager
+with agent.trace("context-op") as t:
+    value = "computed"
+    t.set_output(value)
+
+# Query and export
+traces = agent.get_traces()
+stats = agent.get_stats()
+agent.export("json")
+agent.close()
+```
+
+See the [full README](https://github.com/Klepsiphron/agenttrace#python-sdk) for more.
+
+## License
+
+MIT © Klepsiphron

agenttrace_io-0.1.9/README.md

@@ -0,0 +1,44 @@
+# agenttrace-io (Python SDK)
+
+Drop-in tracing for any AI agent. Local SQLite storage, zero dependencies, zero cloud.
+
+## Installation
+
+```bash
+pip install agenttrace-io
+```
+
+Requires Python 3.10+.
+
+## Quickstart
+
+```python
+from agenttrace import init, trace
+
+agent = init(db_path="./traces.db")
+
+# Trace a callable
+result = agent.trace("my-op", lambda: 42 * 2)
+
+# Use as decorator
+@trace("greet")
+def greet(name: str) -> str:
+    return f"Hello, {name}"
+
+# Use as context manager
+with agent.trace("context-op") as t:
+    value = "computed"
+    t.set_output(value)
+
+# Query and export
+traces = agent.get_traces()
+stats = agent.get_stats()
+agent.export("json")
+agent.close()
+```
+
+See the [full README](https://github.com/Klepsiphron/agenttrace#python-sdk) for more.
+
+## License
+
+MIT © Klepsiphron

agenttrace_io-0.1.9/pyproject.toml

@@ -0,0 +1,45 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agenttrace-io"
+version = "0.1.9"
+description = "AgentTrace Python SDK - Drop-in tracing for any AI agent"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+  { name = "Klepsiphron" }
+]
+keywords = ["ai", "agents", "observability", "tracing", "llm"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+  "pytest>=8.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Klepsiphron/agenttrace"
+Repository = "https://github.com/Klepsiphron/agenttrace"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = "-v --tb=short"

agenttrace_io-0.1.9/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

agenttrace_io-0.1.9/src/agenttrace/__init__.py

@@ -0,0 +1,68 @@
+"""
+AgentTrace Python SDK
+Drop-in tracing and observability for AI agents.
+"""
+
+from .core import (
+    AgentTrace,
+    AgentUsageTracker,
+    VERSION,
+    PACKAGE_NAME,
+    init,
+    get_agent_trace,
+    trace,
+    score,
+    evaluate,
+    evaluate_trace,
+)
+from .storage import TraceStorage
+from .types import (
+    AgentUsageFilter,
+    AgentUsageRecord,
+    CostBreakdown,
+    EvaluateOptions,
+    ExportFormat,
+    Run,
+    RunStatus,
+    Scorer,
+    ScorerResult,
+    TokenUsage,
+    ToolCall,
+    Trace,
+    TraceConfig,
+    TraceFilter,
+    TraceStats,
+    UsageStats,
+)
+
+__all__ = [
+    # Core public API exports
+    "AgentTrace",
+    "TraceStorage",
+    "Run",
+    "Trace",
+    "TokenUsage",
+    "ToolCall",
+    "TraceConfig",
+    "TraceFilter",
+    "TraceStats",
+    "ExportFormat",
+    "Scorer",
+    "ScorerResult",
+    "CostBreakdown",
+    "AgentUsageRecord",
+    "AgentUsageFilter",
+    "UsageStats",
+    "RunStatus",
+    # Additional public surface (module helpers + tracker)
+    "AgentUsageTracker",
+    "init",
+    "trace",
+    "get_agent_trace",
+    "score",
+    "evaluate",
+    "evaluate_trace",
+    "VERSION",
+    "PACKAGE_NAME",
+    "EvaluateOptions",
+]