agento11y-openai 0.10.0__tar.gz

agento11y_openai-0.10.0/LICENSE

@@ -0,0 +1,3 @@
+SPDX-License-Identifier: Apache-2.0
+
+See /LICENSE at repository root for full license text.

agento11y_openai-0.10.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: agento11y-openai
+Version: 0.10.0
+Summary: OpenAI helper wrappers for the Grafana Agent Observability Python SDK
+License: SPDX-License-Identifier: Apache-2.0
+        
+        See /LICENSE at repository root for full license text.
+        
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agento11y>=0.10.0
+Requires-Dist: openai<3,>=1.66.0
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.3; extra == "dev"
+Dynamic: license-file
+
+# Sigil Python Provider Helper: OpenAI
+
+`agento11y-openai` exposes strict OpenAI-shaped wrappers and mappers for both Chat Completions and Responses.
+
+## Installation
+
+```bash
+pip install agento11y agento11y-openai
+```
+
+## Public API
+
+- Chat Completions namespace:
+  - `chat.completions.create(...)`
+  - `chat.completions.create_async(...)`
+  - `chat.completions.stream(...)`
+  - `chat.completions.stream_async(...)`
+  - `chat.completions.from_request_response(...)`
+  - `chat.completions.from_stream(...)`
+
+- Responses namespace:
+  - `responses.create(...)`
+  - `responses.create_async(...)`
+  - `responses.stream(...)`
+  - `responses.stream_async(...)`
+  - `responses.from_request_response(...)`
+  - `responses.from_stream(...)`
+
+- Embeddings namespace:
+  - `embeddings.create(...)`
+  - `embeddings.create_async(...)`
+  - `embeddings.from_request_response(...)`
+
+## Integration styles
+
+- Strict wrappers: call OpenAI and record in one step.
+- Manual instrumentation: call OpenAI directly, then map strict OpenAI request/response payloads with `from_request_response` or `from_stream`.
+
+## Responses-first wrapper example
+
+```python
+from openai import OpenAI
+from agento11y import Client, ClientConfig
+from agento11y_openai import OpenAIOptions, responses
+
+agento11y = Client(ClientConfig())
+provider = OpenAI()
+
+response = responses.create(
+    agento11y,
+    {
+        "model": "gpt-5",
+        "instructions": "Be concise",
+        "input": "Summarize rollout status in 3 bullets",
+        "max_output_tokens": 300,
+    },
+    lambda request: provider.responses.create(**request),
+    OpenAIOptions(conversation_id="conv-1", agent_name="assistant", agent_version="1.0.0"),
+)
+```
+
+## Chat Completions stream example
+
+```python
+from agento11y_openai import ChatCompletionsStreamSummary, chat
+
+summary = chat.completions.stream(
+    agento11y,
+    {
+        "model": "gpt-5",
+        "stream": True,
+        "messages": [{"role": "user", "content": "Stream a short status update"}],
+    },
+    lambda request: ChatCompletionsStreamSummary(events=[]),
+)
+```
+
+## Embeddings example
+
+```python
+from agento11y_openai import embeddings
+
+embedding_response = embeddings.create(
+    agento11y,
+    {
+        "model": "text-embedding-3-small",
+        "input": ["hello", "world"],
+    },
+    lambda request: provider.embeddings.create(**request),
+)
+```
+
+## Manual instrumentation example (strict mapper)
+
+```python
+from agento11y import GenerationStart, ModelRef
+from agento11y_openai import OpenAIOptions, responses
+
+request = {
+    "model": "gpt-5",
+    "instructions": "Be concise",
+    "input": "Summarize rollout status in 3 bullets",
+}
+opts = OpenAIOptions(
+    conversation_id="conv-1",
+    agent_name="assistant",
+    agent_version="1.0.0",
+)
+
+with agento11y.start_generation(
+    GenerationStart(
+        conversation_id=opts.conversation_id,
+        agent_name=opts.agent_name,
+        agent_version=opts.agent_version,
+        model=ModelRef(provider=opts.provider_name, name=request["model"]),
+    )
+) as rec:
+    try:
+        response = provider.responses.create(**request)
+        rec.set_result(responses.from_request_response(request, response, opts))
+    except Exception as exc:
+        rec.set_call_error(exc)
+        raise
+```
+
+## Raw artifacts (debug opt-in)
+
+Raw artifacts are off by default.
+
+Enable with:
+
+```python
+OpenAIOptions(raw_artifacts=True)
+```
+
+Artifact names:
+
+- Chat: `openai.chat.request`, `openai.chat.response`, `openai.chat.tools`, `openai.chat.stream_events`
+- Responses: `openai.responses.request`, `openai.responses.response`, `openai.responses.tools`, `openai.responses.stream_events`
+
+Call `client.shutdown()` during teardown to flush buffered telemetry.

agento11y_openai-0.10.0/README.md

@@ -0,0 +1,141 @@
+# Sigil Python Provider Helper: OpenAI
+
+`agento11y-openai` exposes strict OpenAI-shaped wrappers and mappers for both Chat Completions and Responses.
+
+## Installation
+
+```bash
+pip install agento11y agento11y-openai
+```
+
+## Public API
+
+- Chat Completions namespace:
+  - `chat.completions.create(...)`
+  - `chat.completions.create_async(...)`
+  - `chat.completions.stream(...)`
+  - `chat.completions.stream_async(...)`
+  - `chat.completions.from_request_response(...)`
+  - `chat.completions.from_stream(...)`
+
+- Responses namespace:
+  - `responses.create(...)`
+  - `responses.create_async(...)`
+  - `responses.stream(...)`
+  - `responses.stream_async(...)`
+  - `responses.from_request_response(...)`
+  - `responses.from_stream(...)`
+
+- Embeddings namespace:
+  - `embeddings.create(...)`
+  - `embeddings.create_async(...)`
+  - `embeddings.from_request_response(...)`
+
+## Integration styles
+
+- Strict wrappers: call OpenAI and record in one step.
+- Manual instrumentation: call OpenAI directly, then map strict OpenAI request/response payloads with `from_request_response` or `from_stream`.
+
+## Responses-first wrapper example
+
+```python
+from openai import OpenAI
+from agento11y import Client, ClientConfig
+from agento11y_openai import OpenAIOptions, responses
+
+agento11y = Client(ClientConfig())
+provider = OpenAI()
+
+response = responses.create(
+    agento11y,
+    {
+        "model": "gpt-5",
+        "instructions": "Be concise",
+        "input": "Summarize rollout status in 3 bullets",
+        "max_output_tokens": 300,
+    },
+    lambda request: provider.responses.create(**request),
+    OpenAIOptions(conversation_id="conv-1", agent_name="assistant", agent_version="1.0.0"),
+)
+```
+
+## Chat Completions stream example
+
+```python
+from agento11y_openai import ChatCompletionsStreamSummary, chat
+
+summary = chat.completions.stream(
+    agento11y,
+    {
+        "model": "gpt-5",
+        "stream": True,
+        "messages": [{"role": "user", "content": "Stream a short status update"}],
+    },
+    lambda request: ChatCompletionsStreamSummary(events=[]),
+)
+```
+
+## Embeddings example
+
+```python
+from agento11y_openai import embeddings
+
+embedding_response = embeddings.create(
+    agento11y,
+    {
+        "model": "text-embedding-3-small",
+        "input": ["hello", "world"],
+    },
+    lambda request: provider.embeddings.create(**request),
+)
+```
+
+## Manual instrumentation example (strict mapper)
+
+```python
+from agento11y import GenerationStart, ModelRef
+from agento11y_openai import OpenAIOptions, responses
+
+request = {
+    "model": "gpt-5",
+    "instructions": "Be concise",
+    "input": "Summarize rollout status in 3 bullets",
+}
+opts = OpenAIOptions(
+    conversation_id="conv-1",
+    agent_name="assistant",
+    agent_version="1.0.0",
+)
+
+with agento11y.start_generation(
+    GenerationStart(
+        conversation_id=opts.conversation_id,
+        agent_name=opts.agent_name,
+        agent_version=opts.agent_version,
+        model=ModelRef(provider=opts.provider_name, name=request["model"]),
+    )
+) as rec:
+    try:
+        response = provider.responses.create(**request)
+        rec.set_result(responses.from_request_response(request, response, opts))
+    except Exception as exc:
+        rec.set_call_error(exc)
+        raise
+```
+
+## Raw artifacts (debug opt-in)
+
+Raw artifacts are off by default.
+
+Enable with:
+
+```python
+OpenAIOptions(raw_artifacts=True)
+```
+
+Artifact names:
+
+- Chat: `openai.chat.request`, `openai.chat.response`, `openai.chat.tools`, `openai.chat.stream_events`
+- Responses: `openai.responses.request`, `openai.responses.response`, `openai.responses.tools`, `openai.responses.stream_events`
+
+Call `client.shutdown()` during teardown to flush buffered telemetry.

agento11y_openai-0.10.0/agento11y_openai/__init__.py

@@ -0,0 +1,19 @@
+"""OpenAI strict wrapper namespaces for Sigil Python SDK."""
+
+from .provider import (
+    ChatCompletionsStreamSummary,
+    OpenAIOptions,
+    ResponsesStreamSummary,
+    chat,
+    embeddings,
+    responses,
+)
+
+__all__ = [
+    "ChatCompletionsStreamSummary",
+    "OpenAIOptions",
+    "ResponsesStreamSummary",
+    "chat",
+    "embeddings",
+    "responses",
+]