openai-sdk-helpers 0.2.0__tar.gz → 0.4.0__tar.gz

{openai_sdk_helpers-0.2.0 → openai_sdk_helpers-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openai-sdk-helpers
-Version: 0.2.0
+Version: 0.4.0
 Summary: Composable helpers for OpenAI SDK agents, prompts, and storage
 Author: openai-sdk-helpers maintainers
 License: MIT
@@ -277,14 +277,14 @@ when instantiating `OpenAISettings`.
 For more fine-grained control over API interactions, use the `response` module built on the standard `openai` SDK. This gives you direct access to message history, tool handlers, and custom response parsing:
 
 ```python
-from openai_sdk_helpers.response import BaseResponse
+from openai_sdk_helpers.response import ResponseBase
 from openai_sdk_helpers import OpenAISettings
 
 # Configure OpenAI settings
 settings = OpenAISettings.from_env()
 
 # Create a response handler with custom instructions
-response = BaseResponse(
+response = ResponseBase(
     instructions="You are a helpful code review assistant.",
     tools=None,  # Or provide custom tool definitions
     output_structure=None,  # Or a Pydantic model for structured output
@@ -311,12 +311,12 @@ response.close()
 The `response` module automatically detects file types and handles them appropriately:
 
 ```python
-from openai_sdk_helpers.response import BaseResponse
+from openai_sdk_helpers.response import ResponseBase
 from openai_sdk_helpers import OpenAISettings
 
 settings = OpenAISettings.from_env()
 
-with BaseResponse(
+with ResponseBase(
     name="analyzer",
     instructions="You are a helpful assistant that can analyze files.",
     tools=None,
@@ -550,7 +550,7 @@ These modules use the `openai-agents` SDK for high-level agent workflows with au
 
 These modules use the standard `openai` SDK for direct API interactions with fine-grained control over request/response cycles.
 
-- **`openai_sdk_helpers.response.base.BaseResponse`**  
+- **`openai_sdk_helpers.response.base.ResponseBase`**  
   Manages complete OpenAI API interaction lifecycle including input construction,
   tool execution, message history, and structured output parsing. Uses the 
   `client.responses.create()` API (from the OpenAI Responses API, distinct from 
@@ -566,7 +566,7 @@ These modules use the standard `openai` SDK for direct API interactions with fin
   Centralizes OpenAI API configuration with environment variable support.
   Creates configured OpenAI clients with consistent settings.
 
-- **`openai_sdk_helpers.structure.BaseStructure`**  
+- **`openai_sdk_helpers.structure.StructureBase`**  
   Pydantic-based foundation for all structured outputs. Provides JSON schema
   generation, validation, and serialization helpers.
 

{openai_sdk_helpers-0.2.0 → openai_sdk_helpers-0.4.0}/README.md

@@ -242,14 +242,14 @@ when instantiating `OpenAISettings`.
 For more fine-grained control over API interactions, use the `response` module built on the standard `openai` SDK. This gives you direct access to message history, tool handlers, and custom response parsing:
 
 ```python
-from openai_sdk_helpers.response import BaseResponse
+from openai_sdk_helpers.response import ResponseBase
 from openai_sdk_helpers import OpenAISettings
 
 # Configure OpenAI settings
 settings = OpenAISettings.from_env()
 
 # Create a response handler with custom instructions
-response = BaseResponse(
+response = ResponseBase(
     instructions="You are a helpful code review assistant.",
     tools=None,  # Or provide custom tool definitions
     output_structure=None,  # Or a Pydantic model for structured output
@@ -276,12 +276,12 @@ response.close()
 The `response` module automatically detects file types and handles them appropriately:
 
 ```python
-from openai_sdk_helpers.response import BaseResponse
+from openai_sdk_helpers.response import ResponseBase
 from openai_sdk_helpers import OpenAISettings
 
 settings = OpenAISettings.from_env()
 
-with BaseResponse(
+with ResponseBase(
     name="analyzer",
     instructions="You are a helpful assistant that can analyze files.",
     tools=None,
@@ -515,7 +515,7 @@ These modules use the `openai-agents` SDK for high-level agent workflows with au
 
 These modules use the standard `openai` SDK for direct API interactions with fine-grained control over request/response cycles.
 
-- **`openai_sdk_helpers.response.base.BaseResponse`**  
+- **`openai_sdk_helpers.response.base.ResponseBase`**  
   Manages complete OpenAI API interaction lifecycle including input construction,
   tool execution, message history, and structured output parsing. Uses the 
   `client.responses.create()` API (from the OpenAI Responses API, distinct from 
@@ -531,7 +531,7 @@ These modules use the standard `openai` SDK for direct API interactions with fin
   Centralizes OpenAI API configuration with environment variable support.
   Creates configured OpenAI clients with consistent settings.
 
-- **`openai_sdk_helpers.structure.BaseStructure`**  
+- **`openai_sdk_helpers.structure.StructureBase`**  
   Pydantic-based foundation for all structured outputs. Provides JSON schema
   generation, validation, and serialization helpers.
 

{openai_sdk_helpers-0.2.0 → openai_sdk_helpers-0.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openai-sdk-helpers"
-version = "0.2.0"
+version = "0.4.0"
 requires-python = ">=3.10"
 readme = "README.md"
 description = "Composable helpers for OpenAI SDK agents, prompts, and storage"

{openai_sdk_helpers-0.2.0 → openai_sdk_helpers-0.4.0}/src/openai_sdk_helpers/__init__.py

@@ -33,7 +33,7 @@ from .utils.validation import (
     validate_url_format,
 )
 from .structure import (
-    BaseStructure,
+    StructureBase,
     SchemaOptions,
     PlanStructure,
     TaskStructure,
@@ -55,7 +55,7 @@ from .files_api import FilesAPIManager, FilePurpose
 from .vector_storage import VectorStorage, VectorStorageFileInfo, VectorStorageFileStats
 from .agent import (
     AgentBase,
-    AgentConfig,
+    AgentConfiguration,
     AgentEnum,
     CoordinatorAgent,
     SummarizerAgent,
@@ -65,7 +65,7 @@ from .agent import (
     WebAgentSearch,
 )
 from .response import (
-    BaseResponse,
+    ResponseBase,
     ResponseMessage,
     ResponseMessages,
     ResponseToolCall,
@@ -134,7 +134,7 @@ __all__ = [
     "validate_choice",
     "validate_safe_path",
     # Main structure classes
-    "BaseStructure",
+    "StructureBase",
     "SchemaOptions",
     "spec_field",
     "PromptRenderer",
@@ -151,7 +151,7 @@ __all__ = [
     "PlanStructure",
     "AgentEnum",
     "AgentBase",
-    "AgentConfig",
+    "AgentConfiguration",
     "CoordinatorAgent",
     "SummarizerAgent",
     "TranslatorAgent",
@@ -162,7 +162,7 @@ __all__ = [
     "WebSearchStructure",
     "VectorSearchStructure",
     "ValidationResultStructure",
-    "BaseResponse",
+    "ResponseBase",
     "ResponseMessage",
     "ResponseMessages",
     "ResponseToolCall",

{openai_sdk_helpers-0.2.0 → openai_sdk_helpers-0.4.0}/src/openai_sdk_helpers/agent/__init__.py

@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from .base import AgentBase
-from .config import AgentConfig
+from .config import AgentConfiguration, AgentConfigurationRegistry, get_default_registry
 from ..structure.plan.enum import AgentEnum
 from .coordination import CoordinatorAgent
 from .runner import run_sync, run_async, run_streamed
@@ -17,7 +17,9 @@ from .search.web import WebAgentSearch
 
 __all__ = [
     "AgentBase",
-    "AgentConfig",
+    "AgentConfiguration",
+    "AgentConfigurationRegistry",
+    "get_default_registry",
     "AgentEnum",
     "CoordinatorAgent",
     "run_sync",