openai-sdk-helpers 0.6.6__py3-none-any.whl → 0.7.0__py3-none-any.whl

openai_sdk_helpers/response/base.py

@@ -103,6 +103,9 @@ class ResponseBase(Generic[T]):
     openai_settings : OpenAISettings or None, default None
         Fully configured OpenAI settings with API key and default model.
         Required for normal operation.
+    save_messages : bool, default True
+        Default behavior for persisting message history on response runs
+        and close calls.
 
     Attributes
     ----------
@@ -169,6 +172,7 @@ class ResponseBase(Generic[T]):
         data_path: Path | str | None = None,
         tool_handlers: dict[str, ToolHandlerRegistration] | None = None,
         openai_settings: OpenAISettings | None = None,
+        save_messages: bool = True,
     ) -> None:
         """Initialize a response session with OpenAI configuration.
 
@@ -204,6 +208,9 @@ class ResponseBase(Generic[T]):
         openai_settings : OpenAISettings or None, default None
             Fully configured OpenAI settings with API key and default model.
             Required for normal operation.
+        save_messages : bool, default True
+            Default behavior for persisting message history on response runs
+            and close calls.
 
         Raises
         ------
@@ -247,6 +254,7 @@ class ResponseBase(Generic[T]):
             self._data_path = get_data_path(self.__class__.__name__)
 
         self._instructions = instructions
+        self._save_messages = save_messages
         self._tools: list[dict[str, Any]] | None = None
         if tools is not None:
             self._tools = [
@@ -314,7 +322,7 @@ class ResponseBase(Generic[T]):
 
         self.messages = ResponseMessages()
         self.messages.add_system_message(content=system_content)
-        if self._data_path is not None:
+        if self._data_path is not None and self._save_messages:
             self.save()
 
     @property
@@ -509,7 +517,6 @@ class ResponseBase(Generic[T]):
         content: str | list[str],
         files: str | list[str] | None = None,
         use_vector_store: bool = False,
-        save_messages: bool = True,
     ) -> T | str:
         """Generate a response asynchronously from the OpenAI API.
 
@@ -532,9 +539,6 @@ class ResponseBase(Generic[T]):
         use_vector_store : bool, default False
             If True, non-image files are uploaded to a vector store
             for RAG-enabled search instead of inline base64 encoding.
-        save_messages : bool, default True
-            When True, persist the message history after each response or
-            tool call.
 
         Returns
         -------
@@ -625,7 +629,7 @@ class ResponseBase(Generic[T]):
                         self.messages.add_tool_message(
                             content=response_output, output=tool_output
                         )
-                        if save_messages:
+                        if self._save_messages:
                             self.save()
                     except Exception as exc:
                         log(
@@ -651,7 +655,7 @@ class ResponseBase(Generic[T]):
                     self.messages.add_assistant_message(
                         response_output, metadata=kwargs
                     )
-                    if save_messages:
+                    if self._save_messages:
                         self.save()
                     if hasattr(response, "output_text") and response.output_text:
                         raw_text = response.output_text
@@ -688,7 +692,6 @@ class ResponseBase(Generic[T]):
         *,
         files: str | list[str] | None = None,
         use_vector_store: bool = False,
-        save_messages: bool = True,
     ) -> T | str:
         """Execute run_async synchronously with proper event loop handling.
 
@@ -711,9 +714,6 @@ class ResponseBase(Generic[T]):
         use_vector_store : bool, default False
             If True, non-image files are uploaded to a vector store
             for RAG-enabled search instead of inline base64 encoding.
-        save_messages : bool, default True
-            When True, persist the message history after each response or
-            tool call.
 
         Returns
         -------
@@ -749,7 +749,6 @@ class ResponseBase(Generic[T]):
                 content=content,
                 files=files,
                 use_vector_store=use_vector_store,
-                save_messages=save_messages,
             )
 
         try:
@@ -1003,7 +1002,8 @@ class ResponseBase(Generic[T]):
         ...     response.close()
         """
         log(f"Closing session {self.uuid} for {self.__class__.__name__}")
-        self.save()
+        if self._save_messages:
+            self.save()
 
         # Clean up tracked Files API uploads
         try:

openai_sdk_helpers/response/configuration.py

@@ -102,6 +102,9 @@ class ResponseConfiguration(DataclassJSONSerializable, Generic[TIn, TOut]):
     system_vector_store : list[str], optional
         Optional list of vector store names to attach as system context.
         Default is None.
+    save_messages : bool, optional
+        Default behavior for persisting message history on response runs
+        and close calls. Default is True.
     add_output_instructions : bool, optional
         Whether to append output structure instructions to the prompt.
         Default is False.
@@ -114,6 +117,7 @@ class ResponseConfiguration(DataclassJSONSerializable, Generic[TIn, TOut]):
         If name is not a non-empty string.
         If instructions is not a string or Path.
         If tools is provided and is not a sequence.
+        If save_messages is not a bool.
         If input_structure or output_structure is not a class.
         If input_structure or output_structure does not subclass StructureBase.
     ValueError
@@ -158,6 +162,7 @@ class ResponseConfiguration(DataclassJSONSerializable, Generic[TIn, TOut]):
     input_structure: Optional[Type[TIn]]
     output_structure: Optional[Type[TOut]]
     system_vector_store: Optional[list[str]] = None
+    save_messages: bool = True
     add_output_instructions: bool = False
     add_web_search_tool: bool = False
 
@@ -204,6 +209,8 @@ class ResponseConfiguration(DataclassJSONSerializable, Generic[TIn, TOut]):
 
         if self.tools is not None and not isinstance(self.tools, Sequence):
             raise TypeError("Configuration.tools must be a Sequence or None")
+        if not isinstance(self.save_messages, bool):
+            raise TypeError("Configuration.save_messages must be a bool")
 
     @property
     def get_resolved_instructions(self) -> str:
@@ -274,6 +281,7 @@ class ResponseConfiguration(DataclassJSONSerializable, Generic[TIn, TOut]):
             data_path=data_path,
             tool_handlers=tool_handlers,
             openai_settings=openai_settings,
+            save_messages=self.save_messages,
         )
 
 

{openai_sdk_helpers-0.6.6.dist-info → openai_sdk_helpers-0.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openai-sdk-helpers
-Version: 0.6.6
+Version: 0.7.0
 Summary: Composable helpers for OpenAI SDK agents, prompts, and storage
 Author: openai-sdk-helpers maintainers
 License: MIT

{openai_sdk_helpers-0.6.6.dist-info → openai_sdk_helpers-0.7.0.dist-info}/RECORD

@@ -43,8 +43,8 @@ openai_sdk_helpers/prompt/vector_planner.jinja,sha256=szzuJu6ZawYWuARgQn4DykBLig
 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=tR_COd8VziI7y8bEtL6LysjQgpZQfeBNEUwswzp0QxU,38719
-openai_sdk_helpers/response/configuration.py,sha256=jxneKd7oj08D40ceOWETB3TeUHd7Cnz-ooQp0akI9fA,10465
+openai_sdk_helpers/response/base.py,sha256=8_dMff2qoAKQQVh-kaVAUFX52NcV-KUM3XsBp8_nA90,38760
+openai_sdk_helpers/response/configuration.py,sha256=dfM21mAf-m7jX-kgTIHoDzWg72USWJj7JxTIk2hPbZ0,10859
 openai_sdk_helpers/response/files.py,sha256=O--boEPdFGsf9pHXPuNtG0aVJG2ZzwR4L1CZDW0hBP4,14450
 openai_sdk_helpers/response/messages.py,sha256=qX3sW79rLuJEys28zyv5MovZikwGOaLevzdVN0VYMRE,10104
 openai_sdk_helpers/response/planner.py,sha256=AuNMZkd4TGnvybSJaf2iMbvfPINbusrWucWBk2uQN_g,340
@@ -92,8 +92,8 @@ openai_sdk_helpers/vector_storage/__init__.py,sha256=L5LxO09puh9_yBB9IDTvc1CvVkA
 openai_sdk_helpers/vector_storage/cleanup.py,sha256=sZ4ZSTlnjF52o9Cc8A9dTX37ZYXXDxS_fdIpoOBWvrg,3666
 openai_sdk_helpers/vector_storage/storage.py,sha256=t_ukacaXRa9EXE4-3BxsrB4Rjhu6nTu7NA9IjCJBIpQ,24259
 openai_sdk_helpers/vector_storage/types.py,sha256=jTCcOYMeOpZWvcse0z4T3MVs-RBOPC-fqWTBeQrgafU,1639
-openai_sdk_helpers-0.6.6.dist-info/METADATA,sha256=cyg4hIimWHNrkSxsEwWZGOOmaBFAWtSHfL9JkGQXHxw,24622
-openai_sdk_helpers-0.6.6.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-openai_sdk_helpers-0.6.6.dist-info/entry_points.txt,sha256=gEOD1ZeXe8d2OP-KzUlG-b_9D9yUZTCt-GFW3EDbIIY,63
-openai_sdk_helpers-0.6.6.dist-info/licenses/LICENSE,sha256=CUhc1NrE50bs45tcXF7OcTQBKEvkUuLqeOHgrWQ5jaA,1067
-openai_sdk_helpers-0.6.6.dist-info/RECORD,,
+openai_sdk_helpers-0.7.0.dist-info/METADATA,sha256=jNBRE-vvRrvRlg4hBF3ar-vYNhBMDNSWLaOB41PjoPw,24622
+openai_sdk_helpers-0.7.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+openai_sdk_helpers-0.7.0.dist-info/entry_points.txt,sha256=gEOD1ZeXe8d2OP-KzUlG-b_9D9yUZTCt-GFW3EDbIIY,63
+openai_sdk_helpers-0.7.0.dist-info/licenses/LICENSE,sha256=CUhc1NrE50bs45tcXF7OcTQBKEvkUuLqeOHgrWQ5jaA,1067
+openai_sdk_helpers-0.7.0.dist-info/RECORD,,