ccs-llmconnector 1.0.6__tar.gz → 1.1.1__tar.gz

{ccs_llmconnector-1.0.6 → ccs_llmconnector-1.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccs-llmconnector
-Version: 1.0.6
+Version: 1.1.1
 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
@@ -326,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",
@@ -373,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.
@@ -399,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.6/src/ccs_llmconnector.egg-info/PKG-INFO → ccs_llmconnector-1.1.1/README.md

@@ -1,19 +1,3 @@
-Metadata-Version: 2.4
-Name: ccs-llmconnector
-Version: 1.0.6
-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,
@@ -29,16 +13,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 +40,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
@@ -326,6 +329,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",
@@ -373,10 +385,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.
@@ -399,6 +416,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.6 → ccs_llmconnector-1.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ccs-llmconnector"
-version = "1.0.6"
+version = "1.1.1"
 description = "Lightweight wrapper around different LLM provider Python SDK Responses APIs."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -14,11 +14,14 @@ authors = [
 ]
 dependencies = [
     "openai>=1.0.0",
-    "google-genai",
-    "anthropic",
-    "xai-sdk",
 ]
 
+[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.6/README.md → ccs_llmconnector-1.1.1/src/ccs_llmconnector.egg-info/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.4
+Name: ccs-llmconnector
+Version: 1.1.1
+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
@@ -310,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",
@@ -357,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.
@@ -383,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.6 → ccs_llmconnector-1.1.1}/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.1/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.6 → ccs_llmconnector-1.1.1}/src/llmconnector/__init__.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 from typing import TYPE_CHECKING, Any
 
 from .client import LLMClient
+from .types import ImageInput, Message, MessageSequence
 
 if TYPE_CHECKING:
     from .anthropic_client import AnthropicClient
@@ -12,7 +13,16 @@ if TYPE_CHECKING:
     from .grok_client import GrokClient
     from .openai_client import OpenAIResponsesClient
 
-__all__ = ["LLMClient", "OpenAIResponsesClient", "GeminiClient", "AnthropicClient", "GrokClient"]
+__all__ = [
+    "LLMClient",
+    "OpenAIResponsesClient",
+    "GeminiClient",
+    "AnthropicClient",
+    "GrokClient",
+    "ImageInput",
+    "Message",
+    "MessageSequence",
+]
 
 
 def __getattr__(name: str) -> Any: