Metadata-Version: 2.5
Name: huaweicloud-opentelemetry-instrumentation-codex
Version: 1.0.0
Summary: Huawei Cloud standalone instrumentation for OpenAI Codex Agent (codex)
License-Expression: Apache-2.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
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
Requires-Python: >=3.9
Requires-Dist: opentelemetry-api==1.39.1
Requires-Dist: opentelemetry-exporter-otlp==1.39.1
Requires-Dist: opentelemetry-instrumentation==0.60b1
Requires-Dist: opentelemetry-sdk==1.39.1
Requires-Dist: opentelemetry-semantic-conventions-ai>=0.5.0
Requires-Dist: wrapt<2.0.0,>=1.0.0
Description-Content-Type: text/x-rst

HuaweiCloud OpenTelemetry Instrumentation for Codex Agent
==========================================================

Huawei Cloud standalone instrumentation probe for OpenAI Codex Agent,
providing automatic observability (traces + metrics) for Codex-based
AI agent applications.

Span Tree
---------

::

    gen_ai.chat {agent_name}      (AGENT, root)
      |-- codex.tool_call {tool}  (PLUGIN)
      +-- codex.tool_call {tool}  (PLUGIN)

Installation
------------

::

    pip install huaweicloud-opentelemetry-instrumentation-codex

Usage
-----

Standalone bootstrap via sitecustomize::

    from opentelemetry.instrumentation.huawei_codex import auto_instrument
    auto_instrument()

Or use the ``CodexInstrumentor`` directly::

    from opentelemetry.instrumentation.huawei_codex import CodexInstrumentor
    CodexInstrumentor().instrument()

Environment Variables
---------------------

See the Codex probe integration guide for full details.
