Metadata-Version: 2.4
Name: respan-instrumentation-mirascope
Version: 0.1.0
Summary: Respan instrumentation plugin for Mirascope 2.x
License: Apache 2.0
Author: Respan
Author-email: team@respan.ai
Requires-Python: >=3.11,<3.14
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: mirascope (>=2.5.0,<3.0.0)
Requires-Dist: opentelemetry-api (>=1.38.0,<2.0.0)
Requires-Dist: opentelemetry-semantic-conventions-ai (>=0.4.1)
Requires-Dist: respan-sdk (>=2.6.1)
Requires-Dist: respan-tracing (>=2.17.0,<3.0.0)
Description-Content-Type: text/markdown

# Respan instrumentation for Mirascope

This package traces Mirascope 2.x model calls, context-aware calls, sync and
async streams, and toolkit execution. Model calls become canonical Respan chat
spans; toolkit executions become canonical tool spans. Streaming spans finish
when the underlying stream is consumed and preserve iterator errors.

```python
from respan_instrumentation_mirascope import MirascopeInstrumentor

instrumentor = MirascopeInstrumentor(capture_content=True)
instrumentor.activate()
```

`capture_content=False` omits messages, tool definitions, arguments, and model
outputs while retaining models, providers, usage, status, and errors. Activation
is reference-counted and safe to repeat.

Do not combine this adapter with `mirascope.ops.instrument_llm()` unless you
intentionally want two independent telemetry pipelines for each operation.

