agento11y-gemini 0.10.0__tar.gz

agento11y_gemini-0.10.0/LICENSE

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

agento11y_gemini-0.10.0/PKG-INFO

@@ -0,0 +1,127 @@
+Metadata-Version: 2.4
+Name: agento11y-gemini
+Version: 0.10.0
+Summary: Gemini 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: google-genai<2,>=1.63.0
+Provides-Extra: dev
+Requires-Dist: pytest>=9.0.3; extra == "dev"
+Dynamic: license-file
+
+# Sigil Python Provider Helper: Gemini
+
+`agento11y-gemini` provides strict Gemini Models wrappers and mappers for Sigil.
+
+## Installation
+
+```bash
+pip install agento11y agento11y-gemini google-genai
+```
+
+## Public API
+
+- Wrappers:
+  - `models.generate_content(...)`
+  - `models.generate_content_async(...)`
+  - `models.generate_content_stream(...)`
+  - `models.generate_content_stream_async(...)`
+  - `models.embed_content(...)`
+  - `models.embed_content_async(...)`
+- Mappers:
+  - `models.from_request_response(...)`
+  - `models.from_stream(...)`
+  - `models.embedding_from_response(...)`
+
+## Wrapper Mode (Sync)
+
+```python
+from google.genai import types as genai_types
+from agento11y import Client, ClientConfig
+from agento11y_gemini import GeminiOptions, models
+
+client = Client(ClientConfig())
+
+model = "gemini-2.5-pro"
+contents = [genai_types.Content(role="user", parts=[genai_types.Part(text="Hello")])]
+config = genai_types.GenerateContentConfig(max_output_tokens=256)
+
+response = models.generate_content(
+    client,
+    model,
+    contents,
+    config,
+    lambda req_model, req_contents, req_config: gemini_client.models.generate_content(
+        model=req_model,
+        contents=req_contents,
+        config=req_config,
+    ),
+    GeminiOptions(conversation_id="conv-1", agent_name="assistant", agent_version="1.0.0"),
+)
+```
+
+## Wrapper Mode (Stream)
+
+```python
+from agento11y_gemini import GeminiStreamSummary, models
+
+summary = models.generate_content_stream(
+    client,
+    model,
+    contents,
+    config,
+    lambda req_model, req_contents, req_config: GeminiStreamSummary(
+        responses=list(gemini_client.models.generate_content_stream(
+            model=req_model,
+            contents=req_contents,
+            config=req_config,
+        ))
+    ),
+)
+```
+
+## Mapper Mode
+
+```python
+generation = models.from_request_response(model, contents, config, response)
+stream_generation = models.from_stream(model, contents, config, summary)
+```
+
+## Embedding example
+
+```python
+embedding_response = models.embed_content(
+    client,
+    "gemini-embedding-001",
+    contents,
+    None,
+    lambda req_model, req_contents, req_config: gemini_client.models.embed_content(
+        model=req_model,
+        contents=req_contents,
+        config=req_config,
+    ),
+)
+```
+
+## Raw Provider Artifacts (Opt-In)
+
+```python
+options = GeminiOptions(raw_artifacts=True)
+```
+
+Raw artifacts are default OFF and should only be enabled for diagnostics.
+
+## Provider metadata mapping
+
+Gemini-specific fields are mapped as follows:
+
+- `usage.thoughts_token_count` -> normalized `usage.reasoning_tokens`
+- `usage.tool_use_prompt_token_count` -> metadata `agento11y.gen_ai.usage.tool_use_prompt_tokens`
+- `config.thinking_config.thinking_budget` -> metadata `agento11y.gen_ai.request.thinking.budget_tokens`
+- `config.thinking_config.thinking_level` -> metadata `agento11y.gen_ai.request.thinking.level`

agento11y_gemini-0.10.0/README.md

@@ -0,0 +1,110 @@
+# Sigil Python Provider Helper: Gemini
+
+`agento11y-gemini` provides strict Gemini Models wrappers and mappers for Sigil.
+
+## Installation
+
+```bash
+pip install agento11y agento11y-gemini google-genai
+```
+
+## Public API
+
+- Wrappers:
+  - `models.generate_content(...)`
+  - `models.generate_content_async(...)`
+  - `models.generate_content_stream(...)`
+  - `models.generate_content_stream_async(...)`
+  - `models.embed_content(...)`
+  - `models.embed_content_async(...)`
+- Mappers:
+  - `models.from_request_response(...)`
+  - `models.from_stream(...)`
+  - `models.embedding_from_response(...)`
+
+## Wrapper Mode (Sync)
+
+```python
+from google.genai import types as genai_types
+from agento11y import Client, ClientConfig
+from agento11y_gemini import GeminiOptions, models
+
+client = Client(ClientConfig())
+
+model = "gemini-2.5-pro"
+contents = [genai_types.Content(role="user", parts=[genai_types.Part(text="Hello")])]
+config = genai_types.GenerateContentConfig(max_output_tokens=256)
+
+response = models.generate_content(
+    client,
+    model,
+    contents,
+    config,
+    lambda req_model, req_contents, req_config: gemini_client.models.generate_content(
+        model=req_model,
+        contents=req_contents,
+        config=req_config,
+    ),
+    GeminiOptions(conversation_id="conv-1", agent_name="assistant", agent_version="1.0.0"),
+)
+```
+
+## Wrapper Mode (Stream)
+
+```python
+from agento11y_gemini import GeminiStreamSummary, models
+
+summary = models.generate_content_stream(
+    client,
+    model,
+    contents,
+    config,
+    lambda req_model, req_contents, req_config: GeminiStreamSummary(
+        responses=list(gemini_client.models.generate_content_stream(
+            model=req_model,
+            contents=req_contents,
+            config=req_config,
+        ))
+    ),
+)
+```
+
+## Mapper Mode
+
+```python
+generation = models.from_request_response(model, contents, config, response)
+stream_generation = models.from_stream(model, contents, config, summary)
+```
+
+## Embedding example
+
+```python
+embedding_response = models.embed_content(
+    client,
+    "gemini-embedding-001",
+    contents,
+    None,
+    lambda req_model, req_contents, req_config: gemini_client.models.embed_content(
+        model=req_model,
+        contents=req_contents,
+        config=req_config,
+    ),
+)
+```
+
+## Raw Provider Artifacts (Opt-In)
+
+```python
+options = GeminiOptions(raw_artifacts=True)
+```
+
+Raw artifacts are default OFF and should only be enabled for diagnostics.
+
+## Provider metadata mapping
+
+Gemini-specific fields are mapped as follows:
+
+- `usage.thoughts_token_count` -> normalized `usage.reasoning_tokens`
+- `usage.tool_use_prompt_token_count` -> metadata `agento11y.gen_ai.usage.tool_use_prompt_tokens`
+- `config.thinking_config.thinking_budget` -> metadata `agento11y.gen_ai.request.thinking.budget_tokens`
+- `config.thinking_config.thinking_level` -> metadata `agento11y.gen_ai.request.thinking.level`

agento11y_gemini-0.10.0/agento11y_gemini/__init__.py

@@ -0,0 +1,13 @@
+"""Gemini strict wrapper namespace for Sigil Python SDK."""
+
+from .provider import (
+    GeminiOptions,
+    GeminiStreamSummary,
+    models,
+)
+
+__all__ = [
+    "GeminiOptions",
+    "GeminiStreamSummary",
+    "models",
+]