ghost-tracer 0.1.0__tar.gz

ghost_tracer-0.1.0/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: ghost-tracer
+Version: 0.1.0
+Summary: Professional observability for your AI agent. Trace every tool call locally.
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: cyclopts>=4
+Requires-Dist: rich>=15
+
+# Ghost Trace
+
+Professional observability for your AI agent.
+
+Ghost Trace is a lightweight, local-first CLI that intercepts your agent's tool calls and logs them to a SQLite database. No cloud accounts, no API keys, no heavy infrastructure. Just a beautiful trace of what your agent is doing.
+
+## Why use it?
+
+Debugging AI agents with print() statements is painful. When an agent fails on step 4 of a 10-step task, you need to know exactly which tool failed, what arguments it received, and how long it took.
+
+Ghost Trace gives you a clean, color-coded table of every tool call.
+
+## Installation
+
+pip install ghost-trace
+
+## Usage
+
+1. Wrap your tools:
+
+from ghost_trace.tracer import GhostTracer
+tracer = GhostTracer()
+
+@tracer.trace
+def get_weather(city: str):
+    return f"Sunny in {city}"
+
+2. View the trace:
+
+ghost-trace view
+
+This will print a table of all recent tool calls, including errors and execution times.
+
+## License
+
+MIT

ghost_tracer-0.1.0/README.md

@@ -0,0 +1,36 @@
+# Ghost Trace
+
+Professional observability for your AI agent.
+
+Ghost Trace is a lightweight, local-first CLI that intercepts your agent's tool calls and logs them to a SQLite database. No cloud accounts, no API keys, no heavy infrastructure. Just a beautiful trace of what your agent is doing.
+
+## Why use it?
+
+Debugging AI agents with print() statements is painful. When an agent fails on step 4 of a 10-step task, you need to know exactly which tool failed, what arguments it received, and how long it took.
+
+Ghost Trace gives you a clean, color-coded table of every tool call.
+
+## Installation
+
+pip install ghost-trace
+
+## Usage
+
+1. Wrap your tools:
+
+from ghost_trace.tracer import GhostTracer
+tracer = GhostTracer()
+
+@tracer.trace
+def get_weather(city: str):
+    return f"Sunny in {city}"
+
+2. View the trace:
+
+ghost-trace view
+
+This will print a table of all recent tool calls, including errors and execution times.
+
+## License
+
+MIT

ghost_tracer-0.1.0/ghost_trace/cli.py

@@ -0,0 +1,37 @@
+import cyclopts
+from rich.console import Console
+from rich.table import Table
+from ghost_trace.tracer import GhostTracer
+
+app = cyclopts.App(help="Ghost Trace: Professional observability for your AI agent.")
+console = Console()
+
+@app.command
+def view(limit: int = 20, db: str = "ghost_trace.db"):
+    """View the latest agent execution traces."""
+    tracer = GhostTracer(db)
+    traces = tracer.get_traces(limit)
+    
+    if not traces:
+        console.print("[yellow]No traces found. Wrap your agent tools with GhostTracer.trace() first.[/yellow]")
+        return
+
+    table = Table(title="Ghost Agent Traces")
+    table.add_column("Status", style="bold")
+    table.add_column("Tool", style="cyan")
+    table.add_column("Arguments", style="magenta")
+    table.add_column("Result", style="green")
+    table.add_column("Time (s)", justify="right")
+
+    for t in traces:
+        status = "[red]ERROR[/red]" if t["error"] else "[green]OK[/green]"
+        # Truncate long strings for the table
+        args = (t["arguments"][:40] + "...") if len(t["arguments"]) > 40 else t["arguments"]
+        result = (t["result"][:40] + "...") if t["result"] and len(t["result"]) > 40 else (t["result"] or "")
+        
+        table.add_row(status, t["tool_name"], args, result, f"{t['duration']:.2f}")
+
+    console.print(table)
+
+if __name__ == "__main__":
+    app()

ghost_tracer-0.1.0/ghost_trace/tracer.py

@@ -0,0 +1,51 @@
+import sqlite3
+import json
+import time
+import functools
+
+class GhostTracer:
+    def __init__(self, db_path="ghost_trace.db"):
+        self.db_path = db_path
+        self._init_db()
+
+    def _init_db(self):
+        with sqlite3.connect(self.db_path) as conn:
+            conn.execute("""
+                CREATE TABLE IF NOT EXISTS traces (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    timestamp REAL,
+                    tool_name TEXT,
+                    arguments TEXT,
+                    result TEXT,
+                    error TEXT,
+                    duration REAL
+                )
+            """)
+
+    def trace(self, func):
+        @functools.wraps(func)
+        def wrapper(*args, **kwargs):
+            start = time.time()
+            error = None
+            result = None
+            try:
+                result = func(*args, **kwargs)
+                return result
+            except Exception as e:
+                error = str(e)
+                raise
+            finally:
+                duration = time.time() - start
+                with sqlite3.connect(self.db_path) as conn:
+                    conn.execute(
+                        "INSERT INTO traces (timestamp, tool_name, arguments, result, error, duration) VALUES (?, ?, ?, ?, ?, ?)",
+                        (start, func.__name__, json.dumps(kwargs), str(result), error, duration)
+                    )
+        return wrapper
+
+    def get_traces(self, limit=20):
+        with sqlite3.connect(self.db_path) as conn:
+            conn.row_factory = sqlite3.Row
+            return conn.execute(
+                "SELECT * FROM traces ORDER BY timestamp DESC LIMIT ?", (limit,)
+            ).fetchall()

ghost_tracer-0.1.0/ghost_tracer.egg-info/PKG-INFO

@@ -0,0 +1,45 @@
+Metadata-Version: 2.4
+Name: ghost-tracer
+Version: 0.1.0
+Summary: Professional observability for your AI agent. Trace every tool call locally.
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: cyclopts>=4
+Requires-Dist: rich>=15
+
+# Ghost Trace
+
+Professional observability for your AI agent.
+
+Ghost Trace is a lightweight, local-first CLI that intercepts your agent's tool calls and logs them to a SQLite database. No cloud accounts, no API keys, no heavy infrastructure. Just a beautiful trace of what your agent is doing.
+
+## Why use it?
+
+Debugging AI agents with print() statements is painful. When an agent fails on step 4 of a 10-step task, you need to know exactly which tool failed, what arguments it received, and how long it took.
+
+Ghost Trace gives you a clean, color-coded table of every tool call.
+
+## Installation
+
+pip install ghost-trace
+
+## Usage
+
+1. Wrap your tools:
+
+from ghost_trace.tracer import GhostTracer
+tracer = GhostTracer()
+
+@tracer.trace
+def get_weather(city: str):
+    return f"Sunny in {city}"
+
+2. View the trace:
+
+ghost-trace view
+
+This will print a table of all recent tool calls, including errors and execution times.
+
+## License
+
+MIT

ghost_tracer-0.1.0/ghost_tracer.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+ghost_trace/cli.py
+ghost_trace/tracer.py
+ghost_tracer.egg-info/PKG-INFO
+ghost_tracer.egg-info/SOURCES.txt
+ghost_tracer.egg-info/dependency_links.txt
+ghost_tracer.egg-info/entry_points.txt
+ghost_tracer.egg-info/requires.txt
+ghost_tracer.egg-info/top_level.txt

ghost_tracer-0.1.0/ghost_tracer.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

ghost_tracer-0.1.0/ghost_tracer.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ghost-trace = ghost_trace.cli:app

ghost_tracer-0.1.0/ghost_tracer.egg-info/requires.txt

@@ -0,0 +1,2 @@
+cyclopts>=4
+rich>=15

ghost_tracer-0.1.0/ghost_tracer.egg-info/top_level.txt

@@ -0,0 +1 @@
+ghost_trace

ghost_tracer-0.1.0/pyproject.toml

@@ -0,0 +1,17 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ghost-tracer"
+version = "0.1.0"
+description = "Professional observability for your AI agent. Trace every tool call locally."
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "cyclopts>=4",
+    "rich>=15",
+]
+
+[project.scripts]
+ghost-trace = "ghost_trace.cli:app"

ghost_tracer-0.1.0/setup.cfg

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