openai-sdk-helpers 0.4.2__py3-none-any.whl → 0.5.0__py3-none-any.whl

openai_sdk_helpers/utils/registry.py

@@ -4,13 +4,17 @@ from __future__ import annotations
 
 import warnings
 from pathlib import Path
-from typing import Generic, Protocol, TypeVar
-from typing_extensions import Self
+from typing import Generic, TypeVar
+from typing import Protocol
 
+try:
+    from typing import Self  # Python 3.11+
+except ImportError:
+    from typing_extensions import Self  # type: ignore[no-redef]
 from .path_utils import ensure_directory
 
 
-class RegistrySerializable(Protocol):
+class RegistryProtocol(Protocol):
     """Protocol describing serializable registry entries.
 
     Methods
@@ -31,12 +35,12 @@ class RegistrySerializable(Protocol):
         ...
 
     @classmethod
-    def from_json_file(cls, filepath: Path | str) -> Self:
+    def from_json_file(cls, filepath: Path | str) -> "Self":
         """Load an instance from a JSON file."""
         ...
 
 
-T = TypeVar("T", bound=RegistrySerializable)
+T = TypeVar("T", bound=RegistryProtocol)
 
 
 class RegistryBase(Generic[T]):
@@ -53,7 +57,7 @@ class RegistryBase(Generic[T]):
 
     Methods
     -------
-    register(config)
+    register(configuration)
         Add a configuration to the registry.
     get(name)
         Retrieve a configuration by name.
@@ -82,12 +86,12 @@ class RegistryBase(Generic[T]):
         """
         return self._configs
 
-    def register(self, config: T) -> None:
+    def register(self, configuration: T) -> None:
         """Add a configuration to the registry.
 
         Parameters
         ----------
-        config : T
+        configuration : T
             Configuration to register. Must have a 'name' attribute.
 
         Raises
@@ -95,13 +99,13 @@ class RegistryBase(Generic[T]):
         ValueError
             If a configuration with the same name is already registered.
         """
-        name = getattr(config, "name")
+        name = getattr(configuration, "name")
         if name in self._configs:
             raise ValueError(
                 f"Configuration '{name}' is already registered. "
                 "Use a unique name or clear the registry first."
             )
-        self._configs[name] = config
+        self._configs[name] = configuration
 
     def get(self, name: str) -> T:
         """Retrieve a configuration by name.
@@ -166,10 +170,10 @@ class RegistryBase(Generic[T]):
             return
 
         for config_name in config_names:
-            config = self.get(config_name)
+            configuration = self.get(config_name)
             filename = f"{config_name}.json"
-            filepath = dir_path / config.__class__.__name__ / filename
-            config.to_json_file(filepath)
+            filepath = dir_path / configuration.__class__.__name__ / filename
+            configuration.to_json_file(filepath)
 
     def load_from_directory(self, path: Path | str, *, config_class: type[T]) -> int:
         """Load all configurations from JSON files in a directory.
@@ -208,8 +212,8 @@ class RegistryBase(Generic[T]):
         count = 0
         for json_file in sorted(dir_path.glob("*.json")):
             try:
-                config = config_class.from_json_file(json_file)
-                self.register(config)
+                configuration = config_class.from_json_file(json_file)
+                self.register(configuration)
                 count += 1
             except Exception as exc:
                 # Log warning but continue processing other files

openai_sdk_helpers/vector_storage/storage.py

@@ -21,7 +21,7 @@ from openai.types.vector_store import VectorStore
 from openai.types.vector_store_search_response import VectorStoreSearchResponse
 from tqdm import tqdm
 
-from ..config import OpenAISettings
+from ..settings import OpenAISettings
 from ..errors import ConfigurationError, VectorStorageError
 from ..types import OpenAIClient
 from ..utils import ensure_list, ensure_directory, log

{openai_sdk_helpers-0.4.2.dist-info → openai_sdk_helpers-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openai-sdk-helpers
-Version: 0.4.2
+Version: 0.5.0
 Summary: Composable helpers for OpenAI SDK agents, prompts, and storage
 Author: openai-sdk-helpers maintainers
 License: MIT
@@ -17,6 +17,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.10
 Requires-Dist: jinja2
+Requires-Dist: langextract
 Requires-Dist: openai-agents<1.0.0,>=0.6.4
 Requires-Dist: openai<3.0.0,>=2.14.0
 Requires-Dist: pydantic<3,>=2.7
@@ -31,6 +32,8 @@ Requires-Dist: pyright; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: pytest-asyncio; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
+Provides-Extra: extract
+Requires-Dist: langextract; extra == 'extract'
 Description-Content-Type: text/markdown
 
 <div align="center">
@@ -78,7 +81,7 @@ structures, configuration helpers, and orchestration utilities—while leaving
 application-specific prompts and tools to the consuming project.
 
 **Important**: This library integrates with **two distinct OpenAI SDKs**:
-- **`openai-agents`** - Used by the `agent` module for high-level agent workflows with automatic tool handling and streaming
+- **`openai-agents`** - Used by the `agent` module for high-level agent workflows with automatic tool handling
 - **`openai`** - Used by the `response` module for direct API interactions with fine-grained control over responses
 
 The `agent` module provides a higher-level abstraction for building agents, while the `response` module offers lower-level control for custom response handling workflows.
@@ -193,10 +196,11 @@ report = vector_search.run_agent_sync("Explain quantum entanglement for beginner
 print(report.report)
 ```
 
-**Note**: The vector search workflow requires prompt templates for each agent
-(`vector_planner.jinja`, `vector_search.jinja`, and `vector_writer.jinja`). 
-If your `prompt_dir` doesn't contain these files, agent construction will fail 
-with a `FileNotFoundError`.
+**Note**: The vector search workflow ships with default prompt templates
+(`vector_planner.jinja`, `vector_search.jinja`, and `vector_writer.jinja`).
+You only need to pass a `prompt_dir` when you want to override them; if the
+directory you supply is missing any of the templates, agent construction will
+fail with a `FileNotFoundError`.
 
 ### Text utilities
 
@@ -301,7 +305,7 @@ response.close()
 ```
 
 **Key Differences:**
-- **Agent Module**: Higher-level abstraction with built-in streaming, automatic tool handling, and agent-specific workflows
+- **Agent Module**: Higher-level abstraction with automatic tool handling and agent-specific workflows
 - **Response Module**: Lower-level control with manual message management, custom tool handlers, and direct API access
 
 ## Advanced Usage
@@ -510,7 +514,7 @@ src/openai_sdk_helpers/
 │   ├── summary.py     # Summary output structures
 │   └── validation.py  # Validation result structures
 ├── vector_storage/     # Vector store abstraction layer
-├── config.py          # OpenAI settings and configuration
+├── configuration.py          # OpenAI settings and configuration
 └── utils/             # JSON serialization, logging, and helpers
 
 tests/                  # Comprehensive unit test suite
@@ -522,7 +526,7 @@ The package is organized around cohesive, reusable building blocks:
 
 ### Agent Modules (Built on `openai-agents` SDK)
 
-These modules use the `openai-agents` SDK for high-level agent workflows with automatic streaming, tool handling, and conversation management.
+These modules use the `openai-agents` SDK for high-level agent workflows with automatic tool handling and conversation management.
 
 - **`openai_sdk_helpers.agent.base.AgentBase`**  
   Base class for all agents with synchronous and asynchronous execution support.
@@ -562,7 +566,7 @@ These modules use the standard `openai` SDK for direct API interactions with fin
 
 ### Configuration and Data Structures (Shared)
 
-- **`openai_sdk_helpers.config.OpenAISettings`**  
+- **`openai_sdk_helpers.settings.OpenAISettings`**  
   Centralizes OpenAI API configuration with environment variable support.
   Creates configured OpenAI clients with consistent settings.
 
@@ -584,6 +588,17 @@ These modules use the standard `openai` SDK for direct API interactions with fin
 - **`openai_sdk_helpers.utils`**  
   JSON serialization helpers, logging utilities, and common validation functions.
 
+- **`openai_sdk_helpers.utils.langextract`**  
+  Adapter helpers for running LangExtract-style extractors and validating the
+  results into Pydantic models.
+
+## Related Projects
+
+- **[LangExtract](https://github.com/google/langextract)**  
+  Google-maintained toolkit for extracting structured data from language model
+  outputs, which can complement the validation and response utilities in
+  `openai-sdk-helpers`.
+
 ## Contributing
 
 Contributions are welcome! We appreciate functional changes accompanied by
@@ -696,4 +711,3 @@ recognizing types:
 - Check the [Key Modules](#key-modules) section for API documentation
 - Review examples in the [Quickstart](#quickstart) and [Advanced Usage](#advanced-usage) sections
 - Open an issue on GitHub for bugs or feature requests
-

openai_sdk_helpers-0.5.0.dist-info/RECORD

@@ -0,0 +1,95 @@
+openai_sdk_helpers/__init__.py,sha256=8I469KuzrbAjhNX2A5UnYt_kSmjXqQbfHectTeUx7TI,5163
+openai_sdk_helpers/cli.py,sha256=BDc08NqWVfL4GBekxMfN5IPPB4pmN1Od9sVpKtIJRZk,8025
+openai_sdk_helpers/environment.py,sha256=mNoswzIdv37tTRhFwA2B6_Onxsm7vhfjPArfwhYuL7g,1825
+openai_sdk_helpers/errors.py,sha256=ZclLp94o08fSsFNjFn_yrX9yTjw1RE0v7A5T1hBChUc,2925
+openai_sdk_helpers/files_api.py,sha256=uMKHvGg1Od0J95Izl3AG9ofQYq8EDJXEty7zP0oKjJM,12569
+openai_sdk_helpers/logging.py,sha256=JcR0FTWht1tYdwD-bXH835pr0JV0RwHfY3poruiZGHM,795
+openai_sdk_helpers/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+openai_sdk_helpers/settings.py,sha256=xK_u0YNKgtPrLrZrVr4F4k0CvSuYbsmkqqw9mCMdyF8,10932
+openai_sdk_helpers/tools.py,sha256=8hhcytpmDfoXV16UQbDmDVV0rhLOn8c_VjXO8XaTFLQ,19000
+openai_sdk_helpers/types.py,sha256=ejCG0rYqJhjOQvKLoNnzq-TzcKCFt69GVfi7y805NkU,1451
+openai_sdk_helpers/agent/__init__.py,sha256=SRz8WupyS89c7sYML2hkwZLkIu6zczyI9MVyDWAHK1w,1040
+openai_sdk_helpers/agent/base.py,sha256=y2LEkg4AVqNZQ_OPAn5yTy4x8lREq8tJPaUwAYTNHQY,24065
+openai_sdk_helpers/agent/configuration.py,sha256=FU3xnb8-8qoezLW47WwxZg7z2AxNXRW1Svl0FMsk8kc,14244
+openai_sdk_helpers/agent/coordinator.py,sha256=lVjA0yI-GhGKlqbNR_k9GOCrUjFoZ0QoqRaafHckyME,18052
+openai_sdk_helpers/agent/runner.py,sha256=l2NPS9VA9d4RISuBfanFfKxXNYSHQ7MTjRsuzx4APls,3473
+openai_sdk_helpers/agent/summarizer.py,sha256=-yVm-KdTvGRXGj1MlEikTAFYVlPoovLNIL3Tc_WYIzs,3653
+openai_sdk_helpers/agent/translator.py,sha256=6Gj1cqT-W5j32F14sY9kOCFQenq_odceu2fi8hud_Z0,5970
+openai_sdk_helpers/agent/utils.py,sha256=DTD5foCqGYfXf13F2bZMYIQROl7SbDSy5GDPGi0Zl-0,1089
+openai_sdk_helpers/agent/validator.py,sha256=krktzjaHhEprn76F7hD4cH6H2CwucmFN1KWJ_vjl01g,4774
+openai_sdk_helpers/agent/search/__init__.py,sha256=LXXzEcX2MU7_htHRdRCGPw0hsr9CrZn0ESii7GZJMBw,806
+openai_sdk_helpers/agent/search/base.py,sha256=BonbNL7yAQyImhPTrsxZs5axLmaTbwjVGdADNYQaEvY,9764
+openai_sdk_helpers/agent/search/vector.py,sha256=7GoDwvarwyIJIYlP-JpMyH1XokInNalRUJT0HNdQMBk,14130
+openai_sdk_helpers/agent/search/web.py,sha256=vwBKmLNhE6PGswQPjr-sTOPfPURLlwlX7Wm1ysY6w7U,11502
+openai_sdk_helpers/enums/__init__.py,sha256=aFf79C4JBeLC3kMlJfSpehyjx5uNCtW6eK5rD6ZFfhM,322
+openai_sdk_helpers/enums/base.py,sha256=cNllDtzcgI0_eZYXxFko14yhxwicX6xbeDfz9gFE3qo,2753
+openai_sdk_helpers/extract/__init__.py,sha256=T8xtBEm_Mlu5SeXVn4Qv87uGDXed9L0JQaY_gryR1CQ,734
+openai_sdk_helpers/extract/extractor.py,sha256=vmRJyhKDEYAVfRk0KMgLH5hTqUfDAUyWBug5gR3yzcc,5313
+openai_sdk_helpers/extract/generator.py,sha256=K9Euq0IaWs82oe5aRm73_18DelLKYyuH8VhfZ1_ZCEU,14695
+openai_sdk_helpers/prompt/__init__.py,sha256=MOqgKwG9KLqKudoKRlUfLxiSmdOi2aD6hNrWDFqLHkk,418
+openai_sdk_helpers/prompt/base.py,sha256=6X0zeopEvO0ba8207O8Nnj1QvFZEZier7kNNh4qkcmE,7782
+openai_sdk_helpers/prompt/extractor_config_agent_instructions.jinja,sha256=vCrsoUnsgHWSr7OS_ojMUjmPtHfbyv9bzKfaMaCJ99E,329
+openai_sdk_helpers/prompt/extractor_config_generator.jinja,sha256=9rZ1PZdoQtnxDxFUlKRb0SooIEfNw4_Em99n9xvFyyU,960
+openai_sdk_helpers/prompt/extractor_config_generator_instructions.jinja,sha256=GqV3DrGObyER_Fa-GMGGqhWBrQIH9FFlyKdgTjidyzg,534
+openai_sdk_helpers/prompt/extractor_prompt_optimizer_agent_instructions.jinja,sha256=vDCXs1segU-9w9f5Fjp2PfWoXUeOeYw8SBLkAKS8plo,129
+openai_sdk_helpers/prompt/extractor_prompt_optimizer_request.jinja,sha256=YC5uY18CeEXwlnWXOD-vke0npd7Mk-BHRBLjvQzq5lk,280
+openai_sdk_helpers/prompt/summarizer.jinja,sha256=jliSetWDISbql1EkWi1RB8-L_BXUg8JMkRRsPRHuzbY,309
+openai_sdk_helpers/prompt/translator.jinja,sha256=SZhW8ipEzM-9IA4wyS_r2wIMTAclWrilmk1s46njoL0,291
+openai_sdk_helpers/prompt/validator.jinja,sha256=6t8q_IdxFd3mVBGX6SFKNOert1Wo3YpTOji2SNEbbtE,547
+openai_sdk_helpers/prompt/vector_planner.jinja,sha256=szzuJu6ZawYWuARgQn4DykBLigHfCd0lKYM-GRgoR30,282
+openai_sdk_helpers/prompt/vector_search.jinja,sha256=KPEYQDRKsUesadSyQcBBiqYQEDL1NLN6BQsqw-GcKMA,249
+openai_sdk_helpers/prompt/vector_writer.jinja,sha256=q5osfexGvt1xn8ZPtBWUP36n_1HK_Ziu8dkmCZDVamc,342
+openai_sdk_helpers/response/__init__.py,sha256=YFrGpnMIfatnLWXAZgZDMvDx7Yjsqjat8W9INxKuPxY,1728
+openai_sdk_helpers/response/base.py,sha256=pZYc2YpIzg9fYP98XqVN_sTDGRpgqd-UvrBZLfUw0KQ,34791
+openai_sdk_helpers/response/configuration.py,sha256=jxneKd7oj08D40ceOWETB3TeUHd7Cnz-ooQp0akI9fA,10465
+openai_sdk_helpers/response/files.py,sha256=zv5MpYZYHDBum4q9RJH_mVdnKHKOB72EB4nZwTwnlbU,13295
+openai_sdk_helpers/response/messages.py,sha256=qX3sW79rLuJEys28zyv5MovZikwGOaLevzdVN0VYMRE,10104
+openai_sdk_helpers/response/planner.py,sha256=AuNMZkd4TGnvybSJaf2iMbvfPINbusrWucWBk2uQN_g,340
+openai_sdk_helpers/response/prompter.py,sha256=TLRLmNwPcxaaB_X76BbvwXlphducPKYVbn-afTqN2Rk,344
+openai_sdk_helpers/response/runner.py,sha256=3VmWY5du5iBwjVU9D0n2hexu61f561m2iTvhkmq30rc,2932
+openai_sdk_helpers/response/tool_call.py,sha256=Y0ub14WJyuVyj9gRdnHFH2e-ezkfhJ9nnMlkubMKdug,2938
+openai_sdk_helpers/response/vector_store.py,sha256=HClp6O_g20uklQTY7trC4age3rtDmrt3tuvrl93xIf4,3222
+openai_sdk_helpers/streamlit_app/__init__.py,sha256=3yAkl6qV71cqtT5YFZuC9Bkqit0NtffDV6jmMWpT1k4,812
+openai_sdk_helpers/streamlit_app/app.py,sha256=YbCMOOjrC4rxqQP09WcFnHnfpIYYXn-9Tn-NBRGjFJI,17502
+openai_sdk_helpers/streamlit_app/configuration.py,sha256=0KeJ4HqCNFthBHsedV6ptqHluAcTPBb5_TujFOGkIUU,16685
+openai_sdk_helpers/structure/__init__.py,sha256=JRdhEFPLDwty8tuAzCmep59RSknorZ4Dd7cyqonOi4Q,3891
+openai_sdk_helpers/structure/agent_blueprint.py,sha256=VyJWkgPNzAYKRDMeR1M4kE6qqQURnwqtrrEn0TRJf0g,9698
+openai_sdk_helpers/structure/base.py,sha256=nYViUME9pvzMRFIvNORTgwNFcjJdCjd4R1mLMo0nMSM,24822
+openai_sdk_helpers/structure/extraction.py,sha256=wODP0iLAhhsdQkMWRYPYTiLUMU8bFMKiBjPl3PKUleg,37335
+openai_sdk_helpers/structure/prompt.py,sha256=ZfsaHdA0hj5zmZDrOdpXjCsC8U-jjzwFG4JBsWYiaH4,1535
+openai_sdk_helpers/structure/responses.py,sha256=WUwh0DhXj24pkvgqH1FMkdx5V2ArdvdtrDN_fuMBtDU,4882
+openai_sdk_helpers/structure/summary.py,sha256=iP1uffqve18B9HXceP4rV0Ho5AaDZXMmC66tRKDNx3c,3143
+openai_sdk_helpers/structure/translation.py,sha256=rBSzGBX6hGaETD43340z9MbKGsxWekjRD4xEZz67SnI,712
+openai_sdk_helpers/structure/validation.py,sha256=D03rlyBDn22qNjTGaGsjhsk3g50oPmzYMFqycYF2_CU,2409
+openai_sdk_helpers/structure/vector_search.py,sha256=XNQsG6_-c7X6TpXjqWOdKCmqXatX1gwd0zq-hII3cz4,5782
+openai_sdk_helpers/structure/web_search.py,sha256=cPqjwip0xS3OHf7yQ3B_t4VJSlviqgqzPpOkT8_qLvY,4330
+openai_sdk_helpers/structure/plan/__init__.py,sha256=IGr0Tk4inN_8o7fT2N02_FTi6U6l2T9_npcQHAlBwKA,1076
+openai_sdk_helpers/structure/plan/enum.py,sha256=seESSwH-IeeW-9BqIMUQyk3qjtchfU3TDhF9HPDB1OM,3079
+openai_sdk_helpers/structure/plan/helpers.py,sha256=Vc6dBTMFrNWlsaCTpEImEIKjfFq4BSSxNjB4K8dywOQ,5139
+openai_sdk_helpers/structure/plan/plan.py,sha256=yRBx0Z7tog4sGyq7s1kJHvqQOzLpKT8JJ9Ur5j-lhtk,9130
+openai_sdk_helpers/structure/plan/task.py,sha256=DAfgJIa3Yq2AMEzaX20o8SdOs2AlM28pPE9GfbmXk3o,3547
+openai_sdk_helpers/structure/plan/types.py,sha256=7y9QEVdZreQUXV7n-R4RoNZzw5HeOVbJGWx9QkSfuNY,418
+openai_sdk_helpers/utils/__init__.py,sha256=TO8VoKlxCNnrdsLT9iMA5hFwF2mT5SEoTsJzYnLdDKs,3669
+openai_sdk_helpers/utils/async_utils.py,sha256=9KbPEVfi6IXdbwkTUE0h5DleK8TI7I6P_VPL8UgUv98,3689
+openai_sdk_helpers/utils/coercion.py,sha256=Pq1u7tAbD7kTZ84lK-7Fb9CyYKKKQt4fypG5BlSI6oQ,3774
+openai_sdk_helpers/utils/encoding.py,sha256=oDtlNGZ5p-edXiHW76REs-0-8NXkQNReKJdj6sHLkt8,4615
+openai_sdk_helpers/utils/instructions.py,sha256=trbjxjxv2otQR9VmBsPFk1_CJj8nA85Sgtj_5QmQOKI,942
+openai_sdk_helpers/utils/langextract.py,sha256=wkEGbNHDiSX5WVURwCZZZDi23EpHsnO4JR_jJht99C0,5245
+openai_sdk_helpers/utils/output_validation.py,sha256=3DC6Hr6vAFx_bQGaLsxkGN_LuKe_MugLpVogMBgG9tc,12621
+openai_sdk_helpers/utils/path_utils.py,sha256=NOSX7553cc8LqxbnvmdYjgDBi5Le2W2LuMINwFsTzyM,1969
+openai_sdk_helpers/utils/registry.py,sha256=FJvQEZ19vmgfhd1QR5JHb-jIite5fB-bSEOMTGkY7iQ,6680
+openai_sdk_helpers/utils/validation.py,sha256=ZjnZNOy5AoFlszRxarNol6YZwfgw6LnwPtkCekZmwAU,7826
+openai_sdk_helpers/utils/json/__init__.py,sha256=wBm1DBgfy_n1uSUcnCPyqBn_cCq41mijjPigSMZJZqg,2118
+openai_sdk_helpers/utils/json/base_model.py,sha256=DXxKT3CuTNrzUDc9zq7c32EQ18WLyifXG33XOWZxiBk,14122
+openai_sdk_helpers/utils/json/data_class.py,sha256=Bobc5yCZPMh093-0fiWaYNcEH7gUXUV2Itd-tPXH15w,6476
+openai_sdk_helpers/utils/json/ref.py,sha256=FqBIRWIw33Up3rFyTlLYljcuUjg43f6Nu5wX3tOXn54,2809
+openai_sdk_helpers/utils/json/utils.py,sha256=iyc25tnObqXQJWPKLZMVts932GArdKer59KuC8aQKsY,5948
+openai_sdk_helpers/vector_storage/__init__.py,sha256=L5LxO09puh9_yBB9IDTvc1CvVkARVkHqYY1KX3inB4c,975
+openai_sdk_helpers/vector_storage/cleanup.py,sha256=ImWIE-9lli-odD8qIARvmeaa0y8ZD4pYYP-kT0O3178,3552
+openai_sdk_helpers/vector_storage/storage.py,sha256=CcpATTNdeppmMfbQLnhv29hdEfE3wtAVsyKHNCrL-cI,23657
+openai_sdk_helpers/vector_storage/types.py,sha256=jTCcOYMeOpZWvcse0z4T3MVs-RBOPC-fqWTBeQrgafU,1639
+openai_sdk_helpers-0.5.0.dist-info/METADATA,sha256=DoveMw25xYYVHQpPcj8FZjz4oEDvwPPbMALwVeU-fwI,24106
+openai_sdk_helpers-0.5.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+openai_sdk_helpers-0.5.0.dist-info/entry_points.txt,sha256=gEOD1ZeXe8d2OP-KzUlG-b_9D9yUZTCt-GFW3EDbIIY,63
+openai_sdk_helpers-0.5.0.dist-info/licenses/LICENSE,sha256=CUhc1NrE50bs45tcXF7OcTQBKEvkUuLqeOHgrWQ5jaA,1067
+openai_sdk_helpers-0.5.0.dist-info/RECORD,,

openai_sdk_helpers/agent/prompt_utils.py

@@ -1,15 +0,0 @@
-"""Shared helpers for locating bundled prompt templates.
-
-Attributes
-----------
-DEFAULT_PROMPT_DIR : Path
-    Default directory containing bundled prompt templates.
-"""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-DEFAULT_PROMPT_DIR = Path(__file__).resolve().parent.parent / "prompt"
-
-__all__ = ["DEFAULT_PROMPT_DIR"]

openai_sdk_helpers/context_manager.py

@@ -1,241 +0,0 @@
-"""Context manager utilities for resource cleanup.
-
-Provides base classes and utilities for proper resource management
-with guaranteed cleanup on exit or exception.
-"""
-
-from __future__ import annotations
-
-import asyncio
-from contextlib import asynccontextmanager
-from types import TracebackType
-from typing import Any, AsyncIterator, Generic, Optional, TypeVar
-
-from openai_sdk_helpers.logging_config import log
-
-T = TypeVar("T")
-
-
-class ManagedResource(Generic[T]):
-    """Base class for resources that need cleanup.
-
-    Provides context manager support for guaranteed resource cleanup
-    even when exceptions occur.
-
-    Examples
-    --------
-    >>> class DatabaseConnection(ManagedResource[Connection]):
-    ...     def __init__(self, connection):
-    ...         self.connection = connection
-    ...
-    ...     def close(self) -> None:
-    ...         if self.connection:
-    ...             self.connection.close()
-
-    >>> with DatabaseConnection(connect()) as db:
-    ...     db.query("SELECT ...")
-    """
-
-    def __enter__(self) -> T:
-        """Enter context manager.
-
-        Returns
-        -------
-        T
-            The resource instance (self cast appropriately).
-        """
-        return self  # type: ignore
-
-    def __exit__(
-        self,
-        exc_type: Optional[type[BaseException]],
-        exc_val: Optional[BaseException],
-        exc_tb: Optional[TracebackType],
-    ) -> bool:
-        """Exit context manager with cleanup.
-
-        Parameters
-        ----------
-        exc_type : type[BaseException] | None
-            Type of exception if one was raised, None otherwise.
-        exc_val : BaseException | None
-            Exception instance if one was raised, None otherwise.
-        exc_tb : TracebackType | None
-            Traceback if exception was raised, None otherwise.
-
-        Returns
-        -------
-        bool
-            False to re-raise exceptions, True to suppress them.
-        """
-        try:
-            self.close()
-        except Exception as exc:
-            log(f"Error during cleanup: {exc}", level=30)  # logging.WARNING
-            # Don't suppress cleanup errors
-            if exc_type is None:
-                raise
-
-        return False  # Re-raise exceptions
-
-    def close(self) -> None:
-        """Close and cleanup the resource.
-
-        Should be overridden by subclasses to perform actual cleanup.
-        Should not raise exceptions, but may log them.
-
-        Raises
-        ------
-        Exception
-            May raise if cleanup fails catastrophically.
-        """
-        pass
-
-
-class AsyncManagedResource(Generic[T]):
-    """Base class for async resources that need cleanup.
-
-    Provides async context manager support for guaranteed resource cleanup
-    even when exceptions occur.
-
-    Examples
-    --------
-    >>> class AsyncDatabaseConnection(AsyncManagedResource[AsyncConnection]):
-    ...     def __init__(self, connection):
-    ...         self.connection = connection
-    ...
-    ...     async def close(self) -> None:
-    ...         if self.connection:
-    ...             await self.connection.close()
-
-    >>> async with AsyncDatabaseConnection(await connect()) as db:
-    ...     await db.query("SELECT ...")
-    """
-
-    async def __aenter__(self) -> T:
-        """Enter async context manager.
-
-        Returns
-        -------
-        T
-            The resource instance (self cast appropriately).
-        """
-        return self  # type: ignore
-
-    async def __aexit__(
-        self,
-        exc_type: Optional[type[BaseException]],
-        exc_val: Optional[BaseException],
-        exc_tb: Optional[TracebackType],
-    ) -> bool:
-        """Exit async context manager with cleanup.
-
-        Parameters
-        ----------
-        exc_type : type[BaseException] | None
-            Type of exception if one was raised, None otherwise.
-        exc_val : BaseException | None
-            Exception instance if one was raised, None otherwise.
-        exc_tb : TracebackType | None
-            Traceback if exception was raised, None otherwise.
-
-        Returns
-        -------
-        bool
-            False to re-raise exceptions, True to suppress them.
-        """
-        try:
-            await self.close()
-        except Exception as exc:
-            log(f"Error during async cleanup: {exc}", level=30)  # logging.WARNING
-            # Don't suppress cleanup errors
-            if exc_type is None:
-                raise
-
-        return False  # Re-raise exceptions
-
-    async def close(self) -> None:
-        """Close and cleanup the resource asynchronously.
-
-        Should be overridden by subclasses to perform actual cleanup.
-        Should not raise exceptions, but may log them.
-
-        Raises
-        ------
-        Exception
-            May raise if cleanup fails catastrophically.
-        """
-        pass
-
-
-def ensure_closed(resource: Any) -> None:
-    """Safely close a resource if it has a close method.
-
-    Logs errors but doesn't raise them.
-
-    Parameters
-    ----------
-    resource : Any
-        Object that may have a close() method.
-    """
-    if resource is None:
-        return
-
-    close_method = getattr(resource, "close", None)
-    if callable(close_method):
-        try:
-            close_method()
-        except Exception as exc:
-            log(f"Error closing {type(resource).__name__}: {exc}", level=30)
-
-
-async def ensure_closed_async(resource: Any) -> None:
-    """Safely close a resource asynchronously if it has an async close method.
-
-    Logs errors but doesn't raise them.
-
-    Parameters
-    ----------
-    resource : Any
-        Object that may have an async close() method.
-    """
-    if resource is None:
-        return
-
-    close_method = getattr(resource, "close", None)
-    if callable(close_method):
-        try:
-            if asyncio.iscoroutinefunction(close_method):
-                await close_method()
-            else:
-                close_method()
-        except Exception as exc:
-            log(
-                f"Error closing async {type(resource).__name__}: {exc}",
-                level=30,
-            )
-
-
-@asynccontextmanager
-async def async_context(resource: AsyncManagedResource[T]) -> AsyncIterator[T]:
-    """Context manager for async resources.
-
-    Parameters
-    ----------
-    resource : AsyncManagedResource
-        Async resource to manage.
-
-    Yields
-    ------
-    T
-        The resource instance.
-
-    Examples
-    --------
-    >>> async with async_context(my_resource) as resource:
-    ...     await resource.do_something()
-    """
-    try:
-        yield await resource.__aenter__()
-    finally:
-        await resource.__aexit__(None, None, None)