debug-agent-py 0.2.1__py3-none-any.whl

debug_agent_py-0.2.1.dist-info/METADATA

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: debug-agent-py
+Version: 0.2.1
+Summary: AI-powered runtime debugging agent for Python web applications
+Author-email: ggcode <noreply@ggcode.dev>
+License: MIT
+Project-URL: Homepage, https://github.com/topcheer/python-debug-agent
+Project-URL: Repository, https://github.com/topcheer/python-debug-agent
+Project-URL: Issues, https://github.com/topcheer/python-debug-agent/issues
+Keywords: debug,debugging,ai,llm,runtime,diagnostics,flask,fastapi,django,agent,observability
+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.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Debuggers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Provides-Extra: fastapi
+Requires-Dist: fastapi>=0.100; extra == "fastapi"
+Requires-Dist: starlette>=0.27; extra == "fastapi"
+Requires-Dist: uvicorn>=0.23; extra == "fastapi"
+Provides-Extra: flask
+Requires-Dist: flask>=2.3; extra == "flask"
+Provides-Extra: django
+Requires-Dist: django>=4.2; extra == "django"
+Provides-Extra: dev
+Requires-Dist: fastapi; extra == "dev"
+Requires-Dist: uvicorn; extra == "dev"
+Requires-Dist: flask; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+
+# Python Debug Agent
+
+An AI-powered runtime debugging agent that embeds directly into your Python web application. Add one dependency, configure an LLM key, and chat with your live app at `/agent` to inspect memory, threads, routes, HTTP requests, GC stats, and more.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+pip install debug-agent[fastapi]
+```
+
+### 2. Integrate (FastAPI)
+
+```python
+from fastapi import FastAPI
+from debug_agent.middleware import create_fastapi_router
+
+app = FastAPI()
+
+# One line to integrate
+app.include_router(create_fastapi_router())
+```
+
+### 3. Configure LLM
+
+```bash
+export LLM_API_KEY=your-key
+export LLM_BASE_URL=https://api.openai.com/v1  # optional
+export LLM_MODEL=gpt-4o                         # optional
+```
+
+### 4. Run and open
+
+```
+http://localhost:8000/agent
+```
+
+## Framework Integrations
+
+### FastAPI / Starlette
+
+```python
+from debug_agent.middleware import create_fastapi_router
+app.include_router(create_fastapi_router())
+```
+
+### Flask
+
+```python
+from flask import Flask
+from debug_agent.middleware import create_flask_blueprint
+app = Flask(__name__)
+app.register_blueprint(create_flask_blueprint())
+```
+
+### Any ASGI App (Starlette Mount)
+
+```python
+from starlette.routing import Mount
+from debug_agent.middleware import create_starlette_app
+routes = [Mount("/agent", app=create_starlette_app())]
+```
+
+## Built-in Tools (18+)
+
+| Tool | Description |
+|------|-------------|
+| `get_gc_stats` | GC collection counts per generation |
+| `get_memory_summary` | RSS, object counts, top types |
+| `trigger_gc` | Force GC and show before/after |
+| `get_thread_summary` | Thread count, names, daemon status |
+| `get_thread_dump` | Stack traces for all threads |
+| `get_runtime_info` | Python version, platform, PID |
+| `get_memory_allocations` | tracemalloc top allocations |
+| `get_routes` | List all web routes/endpoints |
+| `get_middleware` | List registered middleware |
+| `get_installed_packages` | Installed pip packages |
+| `get_environment_variables` | Environment variables (masked secrets) |
+| `get_recent_requests` | HTTP request ring buffer |
+| `get_slow_requests` | Slowest requests sorted by duration |
+| `get_error_requests` | Error requests (4xx/5xx) |
+| `get_request_stats` | P50/P95/P99 latency, error rate |
+| `get_process_info` | PID, CPU time, container detection |
+| `get_system_info` | OS, CPU cores, load average |
+| `get_disk_usage` | Disk usage for working directory |
+
+## Custom Tools
+
+```python
+from debug_agent import debug_tool, ToolParam
+
+@debug_tool("check_db_pool", "Check database connection pool stats")
+def check_db_pool() -> dict:
+    return {"active": 5, "idle": 10, "max": 20}
+```
+
+That's it. The tool is auto-discovered and made available to the LLM.
+
+## Configuration
+
+| Env Var | Default | Description |
+|---------|---------|-------------|
+| `DEBUG_AGENT_ENABLED` | `true` | Enable/disable |
+| `DEBUG_AGENT_BASE_PATH` | `/agent` | URL path |
+| `LLM_BASE_URL` | `https://api.openai.com/v1` | LLM endpoint |
+| `LLM_API_KEY` | (required) | API key |
+| `LLM_MODEL` | `gpt-4o` | Model name |
+| `LLM_TEMPERATURE` | `0.3` | Sampling temp |
+| `LLM_MAX_TOOL_ROUNDS` | `10` | Max tool rounds |
+
+## Run the Demo
+
+```bash
+pip install -e ".[dev]"
+export LLM_API_KEY=your-key
+python demo/app.py
+# Open http://localhost:8000/agent
+```
+
+## License
+
+MIT

debug_agent_py-0.2.1.dist-info/RECORD

@@ -0,0 +1,25 @@
+debug_agent/__init__.py,sha256=xrPMN77ZcadWnb-_Wl52mGGb9Yp69pImU_I5I8ujxS8,1037
+debug_agent/chat_session.py,sha256=W8xp6xv0QCgO-uyBiOng3lqRz93MMQuVfChLgudzgoY,1447
+debug_agent/config.py,sha256=s8QMootNpvDEZXNVWwG1-9chbmrLBgdg8VWtb6h1w8o,1812
+debug_agent/context_compressor.py,sha256=dqg5B0ZKvBkbceFxexGil3cP8soT0G2N6GopwdN2AdQ,5930
+debug_agent/engine.py,sha256=FHyJsyixU8PeIGw_APJY-kEW9-lbBBEgXX_NpS5CxqE,7181
+debug_agent/llm_client.py,sha256=5Fa0tQ4WKRSbyyL4nmi49AXWIzBFMqPY012RVxRZkG8,7058
+debug_agent/middleware.py,sha256=vxmqPbUABxlvshRunI0rsAcXDRruxaSUXxD9z_C1abU,6609
+debug_agent/system_prompt_builder.py,sha256=MW7reak_hpUBhvpCzhsfCJ6OjbnasiRV6gcEHJlVrPI,3760
+debug_agent/tool_registry.py,sha256=7GzjxQv4MRB37q6KCaBBZp3q2lKpBGeru8ZdyVkrlDU,3423
+debug_agent/inspectors/__init__.py,sha256=OeMjuhCqSYWPRzQs-kn3pzEa-U1KnWmeWbb8bUa9ckc,262
+debug_agent/inspectors/async_tasks.py,sha256=qonpDa0ZXTX-rEFumkO8ivf5hZGNsAzY8LlXh-m3Eg8,2939
+debug_agent/inspectors/database.py,sha256=0es21X_Zy9QD8F1GaXoTVq1CCFzmd9w3BQW7_p0fVBU,3882
+debug_agent/inspectors/framework.py,sha256=PcyDFUC_qJUkGP2lrHVHB_MTi21I9TeO-U2FhMXjpr0,4591
+debug_agent/inspectors/http_tracker.py,sha256=p24IstULxWqczbtpXD4Pqfb2PHXrIj-Juia4K6nt6nI,2957
+debug_agent/inspectors/memory.py,sha256=BGCQVP06czts_sqX65-6mEbGmK9vSFcIkwR1FgLi3fw,3634
+debug_agent/inspectors/modules.py,sha256=6anC5sZD1HruLZf20ItOd_7HhdfzXSnQj34CnFPG6p0,3920
+debug_agent/inspectors/runtime.py,sha256=afIrYqxxDlIaiiLVI7voWJGsNpt4c1UM1hbP_nT-nGM,4063
+debug_agent/inspectors/system.py,sha256=i9EKH6zrDoqPeLYwKaoloTkbnJsnLNojEAMp5vHFRTQ,2331
+debug_agent/inspectors/threads.py,sha256=WIuV4UcNY8ZrhEl1Yfh2nIZxyFKIyN8PzonswZ88JVw,2820
+debug_agent/web/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+debug_agent/web/chat_page.py,sha256=g12-zvBDcueyRBvFKFmVhfu2Q1XttkZS9Y1FpLKHSBI,21901
+debug_agent_py-0.2.1.dist-info/METADATA,sha256=JkXdAjOBX0jsQGWvRJ_pTmE-UftLvgDYz5EGmDPmRzg,4875
+debug_agent_py-0.2.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+debug_agent_py-0.2.1.dist-info/top_level.txt,sha256=S6pzX1gCx6nMIK2Gm-FXOyTk0R2Wp0GWPzkZLxoNnQg,12
+debug_agent_py-0.2.1.dist-info/RECORD,,

debug_agent_py-0.2.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

debug_agent_py-0.2.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+debug_agent