Metadata-Version: 2.1
Name: respan-instrumentation-watson-orchestrate-adk
Version: 0.1.0
Summary: Respan instrumentation plugin for IBM watsonx Orchestrate ADK
License: Apache 2.0
Author: Respan
Author-email: team@respan.ai
Requires-Python: >=3.11,<3.15
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: ibm-watsonx-orchestrate (>=2.12.0,<3.0.0)
Requires-Dist: opentelemetry-semantic-conventions (>=0.59b0)
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-watson-orchestrate-adk

Respan instrumentation plugin for the IBM watsonx Orchestrate ADK
(`ibm-watsonx-orchestrate`).

The package uses native patching because no mature upstream OpenTelemetry or
OpenInference Watson Orchestrate ADK instrumentor is available. It traces:

- local `PythonTool` execution as tool spans
- generated `RunClient` run submission/completion methods as agent spans
- ADK chat and watsonx.ai autodiscover client calls as chat spans when those
  client modules are installed

## Installation

```bash
pip install respan-ai respan-instrumentation-watson-orchestrate-adk ibm-watsonx-orchestrate
```

## Usage

```python
from respan import Respan
from respan_instrumentation_watson_orchestrate_adk import (
    WatsonOrchestrateADKInstrumentor,
)

respan = Respan(
    instrumentations=[WatsonOrchestrateADKInstrumentor()],
)
```

Initialize Respan before invoking Watson Orchestrate ADK tools, run clients, or
chat clients. The instrumentor does not require the ADK package at import time;
missing optional client surfaces are skipped during activation.

