agentdna-sdk 0.2.0__tar.gz

agentdna_sdk-0.2.0/.gitignore

@@ -0,0 +1,37 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+venv/
+env/
+
+# Node
+node_modules/
+*.tsbuildinfo
+dist/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Env
+.env
+.env.local
+.env.*.local
+
+# AgentDNA
+agentdna.db
+*.log

agentdna_sdk-0.2.0/PKG-INFO

@@ -0,0 +1,197 @@
+Metadata-Version: 2.4
+Name: agentdna-sdk
+Version: 0.2.0
+Summary: Sentry for AI Agents — one-line observability with local SQLite persistence
+Project-URL: Homepage, https://github.com/mamoor123/agentdna
+Project-URL: Documentation, https://github.com/mamoor123/agentdna#readme
+Project-URL: Repository, https://github.com/mamoor123/agentdna
+Project-URL: Issues, https://github.com/mamoor123/agentdna/issues
+Author: mamoor123
+License: Apache-2.0
+Keywords: a2a,agents,ai,decorator,langchain,llm,mcp,monitoring,observability,openai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software 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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: discovery
+Requires-Dist: httpx>=0.27.0; extra == 'discovery'
+Requires-Dist: pyyaml>=6.0; extra == 'discovery'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.110.0; extra == 'server'
+Requires-Dist: uvicorn>=0.29.0; extra == 'server'
+Description-Content-Type: text/markdown
+
+# 🧬 AgentDNA — Sentry for AI Agents
+
+**One-line observability for any Python agent.** No framework required. No API key. No network calls.
+
+```bash
+pip install agentdna
+```
+
+## Quick Start
+
+```python
+from agentdna import observe, get_stats
+
+@observe
+def my_agent(prompt):
+    # your existing agent code
+    return llm.call(prompt)
+
+my_agent("hello world")
+
+# View stats (persists across restarts)
+print(get_stats())
+```
+
+That's it. One decorator. Full observability.
+
+## What You Get
+
+```
+📊 Stats: my_agent
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Health:           ✅ Healthy
+  Total calls:      42
+  Success rate:     97.6%
+  Failed calls:     1
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Avg latency:      1250.5 ms
+  P50 latency:      980.0 ms
+  P95 latency:      2100.0 ms
+  P99 latency:      3500.0 ms
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Errors:
+    Timeout: 1
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Features
+
+- **📊 Call tracking** — total calls, success/failure rates
+- **⏱️ Latency** — avg, p50, p95, p99 percentiles
+- **❌ Error tracking** — error types and frequency
+- **💾 SQLite persistence** — data survives restarts
+- **🔒 100% local** — no network calls, no API key
+- **🐍 Sync & async** — works with both
+- **🖥️ CLI included** — `agentdna stats`
+
+## CLI
+
+```bash
+agentdna stats                    # overview of all observed functions
+agentdna stats my_agent           # detailed view
+agentdna stats --export json      # export as JSON
+agentdna stats --export csv       # export as CSV
+agentdna stats --reset            # clear all data
+```
+
+## Usage
+
+### Basic
+
+```python
+from agentdna import observe
+
+@observe
+def my_agent(prompt):
+    return llm.call(prompt)
+```
+
+### With Options
+
+```python
+@observe(name="transcriber", tags={"version": "2.0", "model": "whisper"})
+def transcribe(audio_path):
+    return whisper.transcribe(audio_path)
+```
+
+### Async Support
+
+```python
+@observe
+async def my_async_agent(prompt):
+    result = await llm.acall(prompt)
+    return result
+```
+
+### Get Stats Programmatically
+
+```python
+from agentdna import get_stats
+
+stats = get_stats("my_agent")
+print(f"Success rate: {stats['success_rate']:.1%}")
+print(f"P95 latency: {stats['p95_latency_ms']:.0f}ms")
+
+# All functions
+all_stats = get_stats()
+for name, s in all_stats.items():
+    print(f"{name}: {s['total_calls']} calls")
+```
+
+### Export Stats
+
+```python
+from agentdna import export_stats
+
+json_str = export_stats(format="json")
+csv_str = export_stats(format="csv")
+```
+
+## How It Works
+
+1. Decorator wraps your function
+2. Each call logs: timestamp, success/failure, latency, input/output sizes, errors
+3. Data batches to `~/.agentdna/observe.db` (SQLite, WAL mode)
+4. Read stats anytime via `get_stats()` or `agentdna stats`
+
+**No dependencies** beyond Python stdlib. `click` is only needed for the CLI.
+
+## Data Location
+
+Default: `~/.agentdna/observe.db`
+
+Custom path:
+```python
+import os
+os.environ["AGENTDNA_DB_PATH"] = "/path/to/my/observe.db"
+```
+
+## Why AgentDNA?
+
+| Without AgentDNA | With AgentDNA |
+|-----------------|---------------|
+| `print("done!")` | Track every call with latency + errors |
+| Hope nothing breaks | Know exactly when and what breaks |
+| Debug blind | P95 latency, error breakdown, trends |
+| Lose data on restart | SQLite persistence |
+
+## Installation
+
+```bash
+pip install agentdna
+```
+
+Optional features:
+```bash
+pip install agentdna[discovery]   # agent discovery (httpx, PyYAML)
+pip install agentdna[server]      # run registry server (FastAPI)
+```
+
+## License
+
+Apache 2.0

agentdna_sdk-0.2.0/README.md

@@ -0,0 +1,162 @@
+# 🧬 AgentDNA — Sentry for AI Agents
+
+**One-line observability for any Python agent.** No framework required. No API key. No network calls.
+
+```bash
+pip install agentdna
+```
+
+## Quick Start
+
+```python
+from agentdna import observe, get_stats
+
+@observe
+def my_agent(prompt):
+    # your existing agent code
+    return llm.call(prompt)
+
+my_agent("hello world")
+
+# View stats (persists across restarts)
+print(get_stats())
+```
+
+That's it. One decorator. Full observability.
+
+## What You Get
+
+```
+📊 Stats: my_agent
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Health:           ✅ Healthy
+  Total calls:      42
+  Success rate:     97.6%
+  Failed calls:     1
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Avg latency:      1250.5 ms
+  P50 latency:      980.0 ms
+  P95 latency:      2100.0 ms
+  P99 latency:      3500.0 ms
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Errors:
+    Timeout: 1
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Features
+
+- **📊 Call tracking** — total calls, success/failure rates
+- **⏱️ Latency** — avg, p50, p95, p99 percentiles
+- **❌ Error tracking** — error types and frequency
+- **💾 SQLite persistence** — data survives restarts
+- **🔒 100% local** — no network calls, no API key
+- **🐍 Sync & async** — works with both
+- **🖥️ CLI included** — `agentdna stats`
+
+## CLI
+
+```bash
+agentdna stats                    # overview of all observed functions
+agentdna stats my_agent           # detailed view
+agentdna stats --export json      # export as JSON
+agentdna stats --export csv       # export as CSV
+agentdna stats --reset            # clear all data
+```
+
+## Usage
+
+### Basic
+
+```python
+from agentdna import observe
+
+@observe
+def my_agent(prompt):
+    return llm.call(prompt)
+```
+
+### With Options
+
+```python
+@observe(name="transcriber", tags={"version": "2.0", "model": "whisper"})
+def transcribe(audio_path):
+    return whisper.transcribe(audio_path)
+```
+
+### Async Support
+
+```python
+@observe
+async def my_async_agent(prompt):
+    result = await llm.acall(prompt)
+    return result
+```
+
+### Get Stats Programmatically
+
+```python
+from agentdna import get_stats
+
+stats = get_stats("my_agent")
+print(f"Success rate: {stats['success_rate']:.1%}")
+print(f"P95 latency: {stats['p95_latency_ms']:.0f}ms")
+
+# All functions
+all_stats = get_stats()
+for name, s in all_stats.items():
+    print(f"{name}: {s['total_calls']} calls")
+```
+
+### Export Stats
+
+```python
+from agentdna import export_stats
+
+json_str = export_stats(format="json")
+csv_str = export_stats(format="csv")
+```
+
+## How It Works
+
+1. Decorator wraps your function
+2. Each call logs: timestamp, success/failure, latency, input/output sizes, errors
+3. Data batches to `~/.agentdna/observe.db` (SQLite, WAL mode)
+4. Read stats anytime via `get_stats()` or `agentdna stats`
+
+**No dependencies** beyond Python stdlib. `click` is only needed for the CLI.
+
+## Data Location
+
+Default: `~/.agentdna/observe.db`
+
+Custom path:
+```python
+import os
+os.environ["AGENTDNA_DB_PATH"] = "/path/to/my/observe.db"
+```
+
+## Why AgentDNA?
+
+| Without AgentDNA | With AgentDNA |
+|-----------------|---------------|
+| `print("done!")` | Track every call with latency + errors |
+| Hope nothing breaks | Know exactly when and what breaks |
+| Debug blind | P95 latency, error breakdown, trends |
+| Lose data on restart | SQLite persistence |
+
+## Installation
+
+```bash
+pip install agentdna
+```
+
+Optional features:
+```bash
+pip install agentdna[discovery]   # agent discovery (httpx, PyYAML)
+pip install agentdna[server]      # run registry server (FastAPI)
+```
+
+## License
+
+Apache 2.0

agentdna_sdk-0.2.0/agentdna/__init__.py

@@ -0,0 +1,85 @@
+"""
+🧬 AgentDNA — Sentry for AI Agents
+
+One-line observability for any Python agent.
+No framework required. No API key. No network calls.
+
+Usage:
+    from agentdna import observe, get_stats
+
+    @observe
+    def my_agent(prompt):
+        return llm.call(prompt)
+
+    # Check stats anytime (persists across restarts)
+    print(get_stats())
+
+    # Or use the CLI:
+    #   agentdna stats
+    #   agentdna stats my_agent
+"""
+
+__version__ = "0.2.0"
+
+# ⭐ Primary exports — zero dependencies (uses only stdlib sqlite3)
+from agentdna.plugins.observe import observe, get_stats, reset_stats, export_stats
+
+# Everything else is lazy-imported to avoid requiring httpx/PyYAML
+# for users who only want observability.
+
+
+def __getattr__(name: str):
+    """Lazy imports — only load when actually used."""
+    _lazy = {
+        # Models
+        "Agent": ("agentdna.models", "Agent"),
+        "AgentSearchResult": ("agentdna.models", "AgentSearchResult"),
+        "Capability": ("agentdna.models", "Capability"),
+        "Pricing": ("agentdna.models", "Pricing"),
+        "TrustScore": ("agentdna.models", "TrustScore"),
+        "TaskResult": ("agentdna.models", "TaskResult"),
+        # Registry
+        "register_agent": ("agentdna.registry", "register_agent"),
+        "load_agent_card": ("agentdna.registry", "load_agent_card"),
+        "generate_agent_card": ("agentdna.registry", "generate_agent_card"),
+        # Discovery
+        "find_agent": ("agentdna.discovery", "find_agent"),
+        "search_agents": ("agentdna.discovery", "search_agents"),
+        # Marketplace
+        "hire_agent": ("agentdna.marketplace", "hire_agent"),
+        "hire_agent_sync": ("agentdna.marketplace", "hire_agent_sync"),
+        # Client
+        "AgentDNAClient": ("agentdna.client", "AgentDNAClient"),
+    }
+
+    if name in _lazy:
+        module_path, attr_name = _lazy[name]
+        from importlib import import_module
+        mod = import_module(module_path)
+        return getattr(mod, attr_name)
+
+    raise AttributeError(f"module 'agentdna' has no attribute {name!r}")
+
+
+__all__ = [
+    # ⭐ Core — observability (zero dependencies)
+    "observe",
+    "get_stats",
+    "reset_stats",
+    "export_stats",
+    # Everything else (lazy, requires httpx/PyYAML)
+    "AgentDNAClient",
+    "Agent",
+    "AgentSearchResult",
+    "Capability",
+    "Pricing",
+    "TrustScore",
+    "TaskResult",
+    "register_agent",
+    "load_agent_card",
+    "generate_agent_card",
+    "find_agent",
+    "search_agents",
+    "hire_agent",
+    "hire_agent_sync",
+]