projectdavid 1.32.4__py3-none-any.whl → 1.32.6__py3-none-any.whl

projectdavid/clients/synchronous_inference_wrapper.py

@@ -11,12 +11,14 @@ LOG = UtilsInterface.LoggingUtility()
 
 
 class SynchronousInferenceStream:
+    """Wrap an async streaming generator and expose it synchronously."""
+
     _GLOBAL_LOOP = asyncio.new_event_loop()
     asyncio.set_event_loop(_GLOBAL_LOOP)
 
-    # --------------------------------------------------------------
-    # ctor / setup
-    # --------------------------------------------------------------
+    # ------------------------------------------------------------------ #
+    # construction / setup
+    # ------------------------------------------------------------------ #
     def __init__(self, inference) -> None:
         self.inference_client = inference
         self.user_id: Optional[str] = None
@@ -42,9 +44,9 @@ class SynchronousInferenceStream:
         self.run_id = run_id
         self.api_key = api_key
 
-    # --------------------------------------------------------------
+    # ------------------------------------------------------------------ #
     # main streaming entry-point
-    # --------------------------------------------------------------
+    # ------------------------------------------------------------------ #
     def stream_chunks(
         self,
         provider: str,
@@ -54,6 +56,13 @@ class SynchronousInferenceStream:
         timeout_per_chunk: float = 280.0,
         suppress_fc: bool = True,
     ) -> Generator[dict, None, None]:
+        """
+        Yield provider chunks synchronously.  When *suppress_fc* is True we
+
+        1. completely drop top-level `type="function_call"` chunks, and
+        2. scrub inline `<fc> … </fc>` sections inside text using the
+           PeekGate + FunctionCallSuppressor chain.
+        """
 
         resolved_api_key = api_key or self.api_key
 
@@ -71,38 +80,36 @@ class SynchronousInferenceStream:
 
         agen = _stream_chunks_async().__aiter__()
 
-        # ---------- suppression chain ----------
+        # ---------- build inline filter --------------------------------
         if suppress_fc:
-            _suppressor = FunctionCallSuppressor()
-            _peek_gate = PeekGate(_suppressor)
+            suppressor = FunctionCallSuppressor()
+            peek_gate = PeekGate(suppressor)
 
             def _filter_text(txt: str) -> str:
-                return _peek_gate.feed(txt)
+                return peek_gate.feed(txt)
 
         else:
 
             def _filter_text(txt: str) -> str:  # no-op
                 return txt
 
-        # ---------------------------------------
-
+        # ---------- main loop ------------------------------------------
         while True:
             try:
                 chunk = self._GLOBAL_LOOP.run_until_complete(
                     asyncio.wait_for(agen.__anext__(), timeout=timeout_per_chunk)
                 )
 
-                # provider-labelled function_call
+                # ① drop provider-labelled function_call objects
                 if suppress_fc and chunk.get("type") == "function_call":
-                    LOG.debug("[SUPPRESSOR] blocked provider-labelled function_call")
+                    LOG.debug("[SUPPRESSOR] stripped top-level function_call chunk")
                     continue
 
-                # allow hot_code to bypass suppression
+                # ② never touch hot-code or code-interpreter file previews
                 if chunk.get("type") == "hot_code":
                     yield chunk
                     continue
 
-                # allow code_interpreter_stream to bypass suppression
                 if (
                     chunk.get("stream_type") == "code_execution"
                     and chunk.get("chunk", {}).get("type") == "code_interpreter_stream"
@@ -110,18 +117,12 @@ class SynchronousInferenceStream:
                     yield chunk
                     continue
 
-                # inline content
+                # ③ filter inline text (<fc> blocks) *only* when content is str
                 if isinstance(chunk.get("content"), str):
                     chunk["content"] = _filter_text(chunk["content"])
                     if chunk["content"] == "":
-                        continue  # fully suppressed (or still peeking)
-
-                    if (
-                        suppress_fc
-                        and '"name": "code_interpreter"' in chunk["content"]
-                        and '"arguments": {"code"' in chunk["content"]
-                    ):
-                        LOG.debug("[SUPPRESSOR] inline code_interpreter match blocked")
+                        # Either the text is still in PeekGate’s buffer
+                        # or it was fully suppressed – skip for now.
                         continue
 
                 yield chunk
@@ -130,15 +131,17 @@ class SynchronousInferenceStream:
                 LOG.info("Stream completed normally.")
                 break
             except asyncio.TimeoutError:
-                LOG.error("[TimeoutError] Timeout occurred, stopping stream.")
+                LOG.error(
+                    "[Timeout] chunk wait exceeded %.1f s – aborting", timeout_per_chunk
+                )
                 break
-            except Exception as e:
-                LOG.error("Unexpected error during streaming completions: %s", e)
+            except Exception as exc:  # pylint: disable=broad-except
+                LOG.error("Unexpected streaming error: %s", exc, exc_info=True)
                 break
 
-    # --------------------------------------------------------------
+    # ------------------------------------------------------------------ #
     # housekeeping
-    # --------------------------------------------------------------
+    # ------------------------------------------------------------------ #
     @classmethod
     def shutdown_loop(cls) -> None:
         if cls._GLOBAL_LOOP and not cls._GLOBAL_LOOP.is_closed():

{projectdavid-1.32.4.dist-info → projectdavid-1.32.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: projectdavid
-Version: 1.32.4
+Version: 1.32.6
 Summary: Python SDK for interacting with the Entities Assistant API.
 Author-email: Francis Neequaye Armah <francis.neequaye@projectdavid.co.uk>
 License: PolyForm Noncommercial License 1.0.0

{projectdavid-1.32.4.dist-info → projectdavid-1.32.6.dist-info}/RECORD

@@ -15,7 +15,7 @@ projectdavid/clients/files_client.py,sha256=XkIDzbQFGDrd88taf0Kouc_4YJOPIYEHiIyW
 projectdavid/clients/inference_client.py,sha256=xz4ACPv5Tkis604QxO5mJX1inH_TGDfQP-31geETYpE,6609
 projectdavid/clients/messages_client.py,sha256=467xeIt3VYs6cG8-bl-eDRi_auWOPmfd5tSJDmQSJUI,17232
 projectdavid/clients/runs.py,sha256=-fXOq5L9w2efDPmZkNxb0s2yjl6oN0XN4_aLXqaeceo,25270
-projectdavid/clients/synchronous_inference_wrapper.py,sha256=Ztax5IwGRVHWtftkzUxp0WWvYsUBAPIpjzmmpkFYIoY,5147
+projectdavid/clients/synchronous_inference_wrapper.py,sha256=msshrx_sJxi0Zn-RJpLTPF1HImK7FFHNBTF9m-g2kKE,5463
 projectdavid/clients/threads_client.py,sha256=ekzU5w14zftmtmFkiec3NC90Of-_KVSUY1qH9cmfSFg,6771
 projectdavid/clients/tools_client.py,sha256=GkCVOmwpAoPqVt6aYmH0G1HIFha3iEwR9IIf9teR0j8,11487
 projectdavid/clients/users_client.py,sha256=eCuUb9qvyH1GUFhZu6TRL9zdoK-qzHSs8-Vmrk_0mmg,13729
@@ -34,8 +34,8 @@ projectdavid/utils/monitor_launcher.py,sha256=3YAgJdeuaUvq3JGvpA4ymqFsAnk29nH5q9
 projectdavid/utils/peek_gate.py,sha256=5whMRnDOQjATRpThWDJkvY9ScXuJ7Sd_-9rvGgXeTAQ,2532
 projectdavid/utils/run_monitor.py,sha256=F_WkqIP-qnWH-4llIbileWWLfRj2Q1Cg-ni23SR1rec,3786
 projectdavid/utils/vector_search_formatter.py,sha256=YTe3HPGec26qGY7uxY8_GS8lc4QaN6aNXMzkl29nZpI,1735
-projectdavid-1.32.4.dist-info/licenses/LICENSE,sha256=_8yjiEGttpS284BkfhXxfERqTRZW_tUaHiBB0GTJTMg,4563
-projectdavid-1.32.4.dist-info/METADATA,sha256=KG9pPIwsYqTLam-7-euWCqtAIBUxcnvSNj6QWaIum60,10781
-projectdavid-1.32.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-projectdavid-1.32.4.dist-info/top_level.txt,sha256=kil8GU4s7qYRfNnzGnFHhZnSNRSxgNG-J4HLgQMmMtw,13
-projectdavid-1.32.4.dist-info/RECORD,,
+projectdavid-1.32.6.dist-info/licenses/LICENSE,sha256=_8yjiEGttpS284BkfhXxfERqTRZW_tUaHiBB0GTJTMg,4563
+projectdavid-1.32.6.dist-info/METADATA,sha256=pz7BV3J79Ot0hDnTo0jEBPSARuUo-ohc3FAVEZh2-3Q,10781
+projectdavid-1.32.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+projectdavid-1.32.6.dist-info/top_level.txt,sha256=kil8GU4s7qYRfNnzGnFHhZnSNRSxgNG-J4HLgQMmMtw,13
+projectdavid-1.32.6.dist-info/RECORD,,