Metadata-Version: 2.4
Name: utopia-runtime
Version: 0.2.0
Summary: Production probes + self-healing functions for Utopia — gives AI coding agents real-time visibility and auto-fixes errors at runtime
License: MIT
Project-URL: Homepage, https://github.com/vaulpann/utopia
Project-URL: Repository, https://github.com/vaulpann/utopia
Keywords: utopia,probes,observability,production-context,ai-agents,self-healing,decorator,openai
Classifier: Development Status :: 3 - Alpha
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 :: Libraries
Classifier: Topic :: System :: Monitoring
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# utopia-runtime

Zero-impact production probe runtime for [Utopia](https://github.com/paulvann/utopia).

Captures errors, API calls, database queries, function behavior, and infrastructure context — sending it to the Utopia data service so AI coding agents can understand how your code runs in production.

## Installation

```bash
pip install utopia-runtime
```

## Usage

Probes are added by `utopia instrument` — you don't typically import this directly. The runtime auto-initializes from `.utopia/config.json` in your project root.

```python
import utopia_runtime

# Reports are non-blocking and never raise
utopia_runtime.report_function(
    file="app/routes.py",
    line=25,
    function_name="get_user",
    args=[{"user_id": 123}],
    return_value={"found": True},
    duration=15,
    call_stack=[],
)
```

## Zero dependencies

Uses only the Python standard library. No external packages required.
