ccs-llmconnector 1.0.5__tar.gz → 1.1.0__tar.gz

{ccs_llmconnector-1.0.5 → ccs_llmconnector-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccs-llmconnector
-Version: 1.0.5
+Version: 1.1.0
 Summary: Lightweight wrapper around different LLM provider Python SDK Responses APIs.
 Author: CCS
 License: MIT
@@ -9,9 +9,16 @@ Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: openai>=1.0.0
-Requires-Dist: google-genai
-Requires-Dist: anthropic
-Requires-Dist: xai-sdk
+Provides-Extra: gemini
+Requires-Dist: google-genai; extra == "gemini"
+Provides-Extra: anthropic
+Requires-Dist: anthropic; extra == "anthropic"
+Provides-Extra: xai
+Requires-Dist: xai-sdk; extra == "xai"
+Provides-Extra: all
+Requires-Dist: google-genai; extra == "all"
+Requires-Dist: anthropic; extra == "all"
+Requires-Dist: xai-sdk; extra == "all"
 Dynamic: license-file
 
 # ccs-llmconnector
@@ -29,16 +36,24 @@ the models available to your account with each provider.
 # from PyPI (normalized project name)
 pip install ccs-llmconnector
 
+# install additional providers
+pip install "ccs-llmconnector[gemini]"
+pip install "ccs-llmconnector[anthropic]"
+pip install "ccs-llmconnector[xai]"
+pip install "ccs-llmconnector[all]"
+
 # or from source (this repository)
 pip install .
 ```
 
 ### Requirements
 
-- `openai` (installed automatically with the package)
-- `google-genai` (installed automatically with the package)
-- `anthropic` (installed automatically with the package)
-- `xai-sdk` (installed automatically with the package; requires Python 3.10+)
+- `openai` (installed automatically with the base package)
+- Optional extras:
+  - `ccs-llmconnector[gemini]` -> `google-genai`
+  - `ccs-llmconnector[anthropic]` -> `anthropic`
+  - `ccs-llmconnector[xai]` -> `xai-sdk` (Python 3.10+)
+  - `ccs-llmconnector[all]` -> all providers
 
 ## Components
 
@@ -48,6 +63,17 @@ pip install .
 - `GrokClient` - wrapper around the xAI Grok chat API, usable when `xai-sdk` is installed. Includes a model discovery helper.
 - `LLMClient` - provider router that delegates to registered clients (OpenAI included by default) so additional vendors can be added without changing call sites.
 
+## Common Options
+
+All clients expose the same optional controls:
+
+- `messages`: list of `{role, content}` entries (e.g., `system`, `user`, `assistant`). If both `prompt` and `messages` are provided, `prompt` is appended as the last user message.
+- `request_id`: free-form request identifier for tracing/logging.
+- `timeout_s`: optional timeout in seconds (best-effort depending on provider).
+- `max_retries` and `retry_backoff_s`: retry count and exponential backoff base delay.
+
+Async counterparts are available as `async_generate_response`, `async_generate_image`, and `async_list_models`.
+
 ## GeminiClient
 
 ### Usage
@@ -104,6 +130,7 @@ image_bytes = client.generate_image(
     prompt="Generate an infographic of the current weather in Tokyo.",
     model="gemini-3-pro-image-preview",
     image_size="2K",  # Optional, defaults to "2K"
+    aspect_ratio="16:9",  # Optional, e.g. "16:9", "4:3"
 )
 
 with open("weather_tokyo.png", "wb") as f:
@@ -325,6 +352,15 @@ response_via_router = llm_client.generate_response(
     max_tokens=1500,
 )
 
+# async usage
+# response_via_router = await llm_client.async_generate_response(
+#     provider="openai",
+#     api_key="sk-your-api-key",
+#     messages=[{"role": "system", "content": "You are concise."}],
+#     prompt="Summarize the plan.",
+#     model="gpt-4o-mini",
+# )
+
 gemini_response = llm_client.generate_response(
     provider="gemini",                         # google-genai is installed with llmconnector
     api_key="your-gemini-api-key",
@@ -351,6 +387,7 @@ image_bytes = llm_client.generate_image(
     api_key="your-gemini-api-key",
     prompt="A futuristic city",
     model="gemini-3-pro-image-preview",
+    aspect_ratio="16:9",
 )
 ```
 
@@ -371,10 +408,15 @@ for model in llm_client.list_models(provider="openai", api_key="sk-your-api-key"
 | `provider` | `str` | Yes | Registered provider key (default registry includes `'openai'`, `'gemini'`, `'anthropic'`, `'grok'`/`'xai'`). |
 | `api_key` | `str` | Yes | Provider-specific API key. |
 | `prompt` | `Optional[str]` | Conditional | Plain-text prompt. Required unless `images` is supplied. |
+| `messages` | `Optional[Sequence[dict]]` | No | Chat-style messages (`role`, `content`). |
 | `model` | `str` | Yes | Provider-specific model identifier. |
 | `max_tokens` | `int` | No | Defaults to `32000`. |
 | `reasoning_effort` | `Optional[str]` | No | Reasoning hint forwarded when supported. |
 | `images` | `Optional[Sequence[str \| Path]]` | No | Image references forwarded to the provider implementation. |
+| `request_id` | `Optional[str]` | No | Request identifier for tracing/logging. |
+| `timeout_s` | `Optional[float]` | No | Timeout in seconds (best-effort). |
+| `max_retries` | `Optional[int]` | No | Retry count for transient failures. |
+| `retry_backoff_s` | `Optional[float]` | No | Base delay (seconds) for exponential backoff. |
 
 Use `LLMClient.register_provider(name, client)` to add additional providers that implement
 `generate_response` with the same signature.
@@ -397,6 +439,9 @@ Examples:
 # Generate a response
 client_cli respond --provider openai --model gpt-4o --prompt "Hello!"
 
+# Generate with retry/timeout controls
+client_cli respond --provider openai --model gpt-4o --prompt "Hello!" --timeout-s 30 --max-retries 2
+
 # List models for one provider (human-readable)
 client_cli models --provider gemini
 

ccs_llmconnector-1.0.5/src/ccs_llmconnector.egg-info/PKG-INFO → ccs_llmconnector-1.1.0/README.md

@@ -1,19 +1,3 @@
-Metadata-Version: 2.4
-Name: ccs-llmconnector
-Version: 1.0.5
-Summary: Lightweight wrapper around different LLM provider Python SDK Responses APIs.
-Author: CCS
-License: MIT
-Project-URL: Homepage, https://cleancodesolutions.de
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: openai>=1.0.0
-Requires-Dist: google-genai
-Requires-Dist: anthropic
-Requires-Dist: xai-sdk
-Dynamic: license-file
-
 # ccs-llmconnector
 
 `ccs-llmconnector` is a thin Python wrapper around leading large-language-model SDKs,
@@ -25,30 +9,49 @@ the models available to your account with each provider.
 
 ## Installation
 
-```bash
-# from PyPI (normalized project name)
-pip install ccs-llmconnector
-
-# or from source (this repository)
-pip install .
-```
-
-### Requirements
-
-- `openai` (installed automatically with the package)
-- `google-genai` (installed automatically with the package)
-- `anthropic` (installed automatically with the package)
-- `xai-sdk` (installed automatically with the package; requires Python 3.10+)
-
-## Components
+```bash
+# from PyPI (normalized project name)
+pip install ccs-llmconnector
+
+# install additional providers
+pip install "ccs-llmconnector[gemini]"
+pip install "ccs-llmconnector[anthropic]"
+pip install "ccs-llmconnector[xai]"
+pip install "ccs-llmconnector[all]"
+
+# or from source (this repository)
+pip install .
+```
+
+### Requirements
+
+- `openai` (installed automatically with the base package)
+- Optional extras:
+  - `ccs-llmconnector[gemini]` -> `google-genai`
+  - `ccs-llmconnector[anthropic]` -> `anthropic`
+  - `ccs-llmconnector[xai]` -> `xai-sdk` (Python 3.10+)
+  - `ccs-llmconnector[all]` -> all providers
+
+## Components
 
 - `OpenAIResponsesClient` - direct wrapper around the OpenAI Responses API, ideal when your project only targets OpenAI models. Includes a model discovery helper.
 - `GeminiClient` - thin wrapper around the Google Gemini SDK, usable when `google-genai` is installed. Includes a model discovery helper.
 - `AnthropicClient` - lightweight wrapper around the Anthropic Claude Messages API, usable when `anthropic` is installed. Includes a model discovery helper.
 - `GrokClient` - wrapper around the xAI Grok chat API, usable when `xai-sdk` is installed. Includes a model discovery helper.
-- `LLMClient` - provider router that delegates to registered clients (OpenAI included by default) so additional vendors can be added without changing call sites.
-
-## GeminiClient
+- `LLMClient` - provider router that delegates to registered clients (OpenAI included by default) so additional vendors can be added without changing call sites.
+
+## Common Options
+
+All clients expose the same optional controls:
+
+- `messages`: list of `{role, content}` entries (e.g., `system`, `user`, `assistant`). If both `prompt` and `messages` are provided, `prompt` is appended as the last user message.
+- `request_id`: free-form request identifier for tracing/logging.
+- `timeout_s`: optional timeout in seconds (best-effort depending on provider).
+- `max_retries` and `retry_backoff_s`: retry count and exponential backoff base delay.
+
+Async counterparts are available as `async_generate_response`, `async_generate_image`, and `async_list_models`.
+
+## GeminiClient
 
 ### Usage
 
@@ -104,6 +107,7 @@ image_bytes = client.generate_image(
     prompt="Generate an infographic of the current weather in Tokyo.",
     model="gemini-3-pro-image-preview",
     image_size="2K",  # Optional, defaults to "2K"
+    aspect_ratio="16:9",  # Optional, e.g. "16:9", "4:3"
 )
 
 with open("weather_tokyo.png", "wb") as f:
@@ -317,13 +321,22 @@ from llmconnector import LLMClient
 
 llm_client = LLMClient()
 
-response_via_router = llm_client.generate_response(
-    provider="openai",                         # selects the OpenAI wrapper
-    api_key="sk-your-api-key",
-    prompt="List three advantages of integration testing.",
-    model="gpt-4o",
-    max_tokens=1500,
-)
+response_via_router = llm_client.generate_response(
+    provider="openai",                         # selects the OpenAI wrapper
+    api_key="sk-your-api-key",
+    prompt="List three advantages of integration testing.",
+    model="gpt-4o",
+    max_tokens=1500,
+)
+
+# async usage
+# response_via_router = await llm_client.async_generate_response(
+#     provider="openai",
+#     api_key="sk-your-api-key",
+#     messages=[{"role": "system", "content": "You are concise."}],
+#     prompt="Summarize the plan.",
+#     model="gpt-4o-mini",
+# )
 
 gemini_response = llm_client.generate_response(
     provider="gemini",                         # google-genai is installed with llmconnector
@@ -351,6 +364,7 @@ image_bytes = llm_client.generate_image(
     api_key="your-gemini-api-key",
     prompt="A futuristic city",
     model="gemini-3-pro-image-preview",
+    aspect_ratio="16:9",
 )
 ```
 
@@ -366,15 +380,20 @@ for model in llm_client.list_models(provider="openai", api_key="sk-your-api-key"
 
 ### Parameters
 
-| Parameter | Type | Required | Description |
-|-----------|------|----------|-------------|
-| `provider` | `str` | Yes | Registered provider key (default registry includes `'openai'`, `'gemini'`, `'anthropic'`, `'grok'`/`'xai'`). |
-| `api_key` | `str` | Yes | Provider-specific API key. |
-| `prompt` | `Optional[str]` | Conditional | Plain-text prompt. Required unless `images` is supplied. |
-| `model` | `str` | Yes | Provider-specific model identifier. |
-| `max_tokens` | `int` | No | Defaults to `32000`. |
-| `reasoning_effort` | `Optional[str]` | No | Reasoning hint forwarded when supported. |
-| `images` | `Optional[Sequence[str \| Path]]` | No | Image references forwarded to the provider implementation. |
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `provider` | `str` | Yes | Registered provider key (default registry includes `'openai'`, `'gemini'`, `'anthropic'`, `'grok'`/`'xai'`). |
+| `api_key` | `str` | Yes | Provider-specific API key. |
+| `prompt` | `Optional[str]` | Conditional | Plain-text prompt. Required unless `images` is supplied. |
+| `messages` | `Optional[Sequence[dict]]` | No | Chat-style messages (`role`, `content`). |
+| `model` | `str` | Yes | Provider-specific model identifier. |
+| `max_tokens` | `int` | No | Defaults to `32000`. |
+| `reasoning_effort` | `Optional[str]` | No | Reasoning hint forwarded when supported. |
+| `images` | `Optional[Sequence[str \| Path]]` | No | Image references forwarded to the provider implementation. |
+| `request_id` | `Optional[str]` | No | Request identifier for tracing/logging. |
+| `timeout_s` | `Optional[float]` | No | Timeout in seconds (best-effort). |
+| `max_retries` | `Optional[int]` | No | Retry count for transient failures. |
+| `retry_backoff_s` | `Optional[float]` | No | Base delay (seconds) for exponential backoff. |
 
 Use `LLMClient.register_provider(name, client)` to add additional providers that implement
 `generate_response` with the same signature.
@@ -391,14 +410,17 @@ listing models.
   - Anthropic: `ANTHROPIC_API_KEY`
   - Grok/xAI: `GROK_API_KEY` or `XAI_API_KEY` (either works)
 
-Examples:
-
-```bash
-# Generate a response
-client_cli respond --provider openai --model gpt-4o --prompt "Hello!"
-
-# List models for one provider (human-readable)
-client_cli models --provider gemini
+Examples:
+
+```bash
+# Generate a response
+client_cli respond --provider openai --model gpt-4o --prompt "Hello!"
+
+# Generate with retry/timeout controls
+client_cli respond --provider openai --model gpt-4o --prompt "Hello!" --timeout-s 30 --max-retries 2
+
+# List models for one provider (human-readable)
+client_cli models --provider gemini
 
 # List models for one provider (JSON)
 client_cli models --provider anthropic --json

{ccs_llmconnector-1.0.5 → ccs_llmconnector-1.1.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ccs-llmconnector"
-version = "1.0.5"
+version = "1.1.0"
 description = "Lightweight wrapper around different LLM provider Python SDK Responses APIs."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -12,12 +12,15 @@ license = {text = "MIT"}
 authors = [
     {name = "CCS"},
 ]
-dependencies = [
-    "openai>=1.0.0",
-    "google-genai",
-    "anthropic",
-    "xai-sdk",
-]
+dependencies = [
+    "openai>=1.0.0",
+]
+
+[project.optional-dependencies]
+gemini = ["google-genai"]
+anthropic = ["anthropic"]
+xai = ["xai-sdk"]
+all = ["google-genai", "anthropic", "xai-sdk"]
 
 [project.urls]
 Homepage = "https://cleancodesolutions.de"

ccs_llmconnector-1.0.5/README.md → ccs_llmconnector-1.1.0/src/ccs_llmconnector.egg-info/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.4
+Name: ccs-llmconnector
+Version: 1.1.0
+Summary: Lightweight wrapper around different LLM provider Python SDK Responses APIs.
+Author: CCS
+License: MIT
+Project-URL: Homepage, https://cleancodesolutions.de
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai>=1.0.0
+Provides-Extra: gemini
+Requires-Dist: google-genai; extra == "gemini"
+Provides-Extra: anthropic
+Requires-Dist: anthropic; extra == "anthropic"
+Provides-Extra: xai
+Requires-Dist: xai-sdk; extra == "xai"
+Provides-Extra: all
+Requires-Dist: google-genai; extra == "all"
+Requires-Dist: anthropic; extra == "all"
+Requires-Dist: xai-sdk; extra == "all"
+Dynamic: license-file
+
 # ccs-llmconnector
 
 `ccs-llmconnector` is a thin Python wrapper around leading large-language-model SDKs,
@@ -13,16 +36,24 @@ the models available to your account with each provider.
 # from PyPI (normalized project name)
 pip install ccs-llmconnector
 
+# install additional providers
+pip install "ccs-llmconnector[gemini]"
+pip install "ccs-llmconnector[anthropic]"
+pip install "ccs-llmconnector[xai]"
+pip install "ccs-llmconnector[all]"
+
 # or from source (this repository)
 pip install .
 ```
 
 ### Requirements
 
-- `openai` (installed automatically with the package)
-- `google-genai` (installed automatically with the package)
-- `anthropic` (installed automatically with the package)
-- `xai-sdk` (installed automatically with the package; requires Python 3.10+)
+- `openai` (installed automatically with the base package)
+- Optional extras:
+  - `ccs-llmconnector[gemini]` -> `google-genai`
+  - `ccs-llmconnector[anthropic]` -> `anthropic`
+  - `ccs-llmconnector[xai]` -> `xai-sdk` (Python 3.10+)
+  - `ccs-llmconnector[all]` -> all providers
 
 ## Components
 
@@ -32,6 +63,17 @@ pip install .
 - `GrokClient` - wrapper around the xAI Grok chat API, usable when `xai-sdk` is installed. Includes a model discovery helper.
 - `LLMClient` - provider router that delegates to registered clients (OpenAI included by default) so additional vendors can be added without changing call sites.
 
+## Common Options
+
+All clients expose the same optional controls:
+
+- `messages`: list of `{role, content}` entries (e.g., `system`, `user`, `assistant`). If both `prompt` and `messages` are provided, `prompt` is appended as the last user message.
+- `request_id`: free-form request identifier for tracing/logging.
+- `timeout_s`: optional timeout in seconds (best-effort depending on provider).
+- `max_retries` and `retry_backoff_s`: retry count and exponential backoff base delay.
+
+Async counterparts are available as `async_generate_response`, `async_generate_image`, and `async_list_models`.
+
 ## GeminiClient
 
 ### Usage
@@ -88,6 +130,7 @@ image_bytes = client.generate_image(
     prompt="Generate an infographic of the current weather in Tokyo.",
     model="gemini-3-pro-image-preview",
     image_size="2K",  # Optional, defaults to "2K"
+    aspect_ratio="16:9",  # Optional, e.g. "16:9", "4:3"
 )
 
 with open("weather_tokyo.png", "wb") as f:
@@ -309,6 +352,15 @@ response_via_router = llm_client.generate_response(
     max_tokens=1500,
 )
 
+# async usage
+# response_via_router = await llm_client.async_generate_response(
+#     provider="openai",
+#     api_key="sk-your-api-key",
+#     messages=[{"role": "system", "content": "You are concise."}],
+#     prompt="Summarize the plan.",
+#     model="gpt-4o-mini",
+# )
+
 gemini_response = llm_client.generate_response(
     provider="gemini",                         # google-genai is installed with llmconnector
     api_key="your-gemini-api-key",
@@ -335,6 +387,7 @@ image_bytes = llm_client.generate_image(
     api_key="your-gemini-api-key",
     prompt="A futuristic city",
     model="gemini-3-pro-image-preview",
+    aspect_ratio="16:9",
 )
 ```
 
@@ -355,10 +408,15 @@ for model in llm_client.list_models(provider="openai", api_key="sk-your-api-key"
 | `provider` | `str` | Yes | Registered provider key (default registry includes `'openai'`, `'gemini'`, `'anthropic'`, `'grok'`/`'xai'`). |
 | `api_key` | `str` | Yes | Provider-specific API key. |
 | `prompt` | `Optional[str]` | Conditional | Plain-text prompt. Required unless `images` is supplied. |
+| `messages` | `Optional[Sequence[dict]]` | No | Chat-style messages (`role`, `content`). |
 | `model` | `str` | Yes | Provider-specific model identifier. |
 | `max_tokens` | `int` | No | Defaults to `32000`. |
 | `reasoning_effort` | `Optional[str]` | No | Reasoning hint forwarded when supported. |
 | `images` | `Optional[Sequence[str \| Path]]` | No | Image references forwarded to the provider implementation. |
+| `request_id` | `Optional[str]` | No | Request identifier for tracing/logging. |
+| `timeout_s` | `Optional[float]` | No | Timeout in seconds (best-effort). |
+| `max_retries` | `Optional[int]` | No | Retry count for transient failures. |
+| `retry_backoff_s` | `Optional[float]` | No | Base delay (seconds) for exponential backoff. |
 
 Use `LLMClient.register_provider(name, client)` to add additional providers that implement
 `generate_response` with the same signature.
@@ -381,6 +439,9 @@ Examples:
 # Generate a response
 client_cli respond --provider openai --model gpt-4o --prompt "Hello!"
 
+# Generate with retry/timeout controls
+client_cli respond --provider openai --model gpt-4o --prompt "Hello!" --timeout-s 30 --max-retries 2
+
 # List models for one provider (human-readable)
 client_cli models --provider gemini
 

{ccs_llmconnector-1.0.5 → ccs_llmconnector-1.1.0}/src/ccs_llmconnector.egg-info/SOURCES.txt

@@ -15,4 +15,6 @@ src/llmconnector/client_cli.py
 src/llmconnector/gemini_client.py
 src/llmconnector/grok_client.py
 src/llmconnector/openai_client.py
-src/llmconnector/py.typed
+src/llmconnector/py.typed
+src/llmconnector/types.py
+src/llmconnector/utils.py

ccs_llmconnector-1.1.0/src/ccs_llmconnector.egg-info/requires.txt

@@ -0,0 +1,15 @@
+openai>=1.0.0
+
+[all]
+google-genai
+anthropic
+xai-sdk
+
+[anthropic]
+anthropic
+
+[gemini]
+google-genai
+
+[xai]
+xai-sdk

{ccs_llmconnector-1.0.5 → ccs_llmconnector-1.1.0}/src/llmconnector/__init__.py

@@ -2,17 +2,27 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
-
-from .client import LLMClient
-
-if TYPE_CHECKING:
-    from .anthropic_client import AnthropicClient
-    from .gemini_client import GeminiClient
-    from .grok_client import GrokClient
-    from .openai_client import OpenAIResponsesClient
-
-__all__ = ["LLMClient", "OpenAIResponsesClient", "GeminiClient", "AnthropicClient", "GrokClient"]
+from typing import TYPE_CHECKING, Any
+
+from .client import LLMClient
+from .types import ImageInput, Message, MessageSequence
+
+if TYPE_CHECKING:
+    from .anthropic_client import AnthropicClient
+    from .gemini_client import GeminiClient
+    from .grok_client import GrokClient
+    from .openai_client import OpenAIResponsesClient
+
+__all__ = [
+    "LLMClient",
+    "OpenAIResponsesClient",
+    "GeminiClient",
+    "AnthropicClient",
+    "GrokClient",
+    "ImageInput",
+    "Message",
+    "MessageSequence",
+]
 
 
 def __getattr__(name: str) -> Any: