ccs-llmconnector 1.1.2__tar.gz → 1.1.4__tar.gz

{ccs_llmconnector-1.1.2/src/ccs_llmconnector.egg-info → ccs_llmconnector-1.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccs-llmconnector
-Version: 1.1.2
+Version: 1.1.4
 Summary: Lightweight wrapper around different LLM provider Python SDK Responses APIs.
 Author: CCS
 License: MIT

{ccs_llmconnector-1.1.2 → ccs_llmconnector-1.1.4}/README.md

@@ -9,49 +9,49 @@ the models available to your account with each provider.
 
 ## Installation
 
-```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
+```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.
-
-## 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
+- `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
 
@@ -321,22 +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,
-)
-
-# 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",
-# )
+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
@@ -380,20 +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. |
-| `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. |
+| 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.
@@ -410,17 +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!"
-
-# 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
+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.1.2 → ccs_llmconnector-1.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ccs-llmconnector"
-version = "1.1.2"
+version = "1.1.4"
 description = "Lightweight wrapper around different LLM provider Python SDK Responses APIs."
 readme = "README.md"
 requires-python = ">=3.8"

{ccs_llmconnector-1.1.2 → ccs_llmconnector-1.1.4/src/ccs_llmconnector.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccs-llmconnector
-Version: 1.1.2
+Version: 1.1.4
 Summary: Lightweight wrapper around different LLM provider Python SDK Responses APIs.
 Author: CCS
 License: MIT

{ccs_llmconnector-1.1.2 → ccs_llmconnector-1.1.4}/src/llmconnector/__init__.py

@@ -2,27 +2,29 @@
 
 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
-    from .gemini_client import GeminiClient
-    from .grok_client import GrokClient
-    from .openai_client import OpenAIResponsesClient
-
-__all__ = [
-    "LLMClient",
-    "OpenAIResponsesClient",
-    "GeminiClient",
-    "AnthropicClient",
-    "GrokClient",
-    "ImageInput",
-    "Message",
-    "MessageSequence",
-]
+from typing import TYPE_CHECKING, Any
+
+from .client import LLMClient
+from .types import ImageInput, LLMResponse, Message, MessageSequence, TokenUsage
+
+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",
+    "LLMResponse",
+    "ImageInput",
+    "Message",
+    "MessageSequence",
+    "TokenUsage",
+]
 
 
 def __getattr__(name: str) -> Any: