lucidicai 1.2.13__py3-none-any.whl → 1.2.14__py3-none-any.whl

lucidicai/__init__.py

@@ -130,15 +130,12 @@ def init(
         agent_id = os.getenv("LUCIDIC_AGENT_ID", None)
         if agent_id is None:
             raise APIKeyVerificationError("Lucidic agent ID not specified. Make sure to either pass your agent ID into lai.init() or set the LUCIDIC_AGENT_ID environment variable.")
-    try:
-        client = Client()
-        if client.initialized:
-            raise InvalidOperationError("[Lucidic] Session already in progress. Please call lai.reset() between sessions.")
-    except LucidicNotInitializedError:
-        client = Client(
-            lucidic_api_key=lucidic_api_key,
-            agent_id=agent_id,
-        )
+
+    # get current client which will be NullClient if never lai is never initialized
+    client = Client()
+    # ff not yet initialized or still the NullClient -> creaet a real client when init is called
+    if not getattr(client, 'initialized', False):
+        client = Client(lucidic_api_key=lucidic_api_key, agent_id=agent_id)
     
     # Set up providers
     _setup_providers(client, providers)
@@ -201,9 +198,8 @@ def update_session(
         is_successful: Whether the session was successful.
         is_successful_reason: Session success reason.
     """
-    client = Client()  # TODO: Fail silently if client not initialized yet
+    client = Client()
     if not client.session:
-        logger.warning("update_session called when session not initialized. Please call lai.init() first.")
         return
     client.session.update_session(**locals())
 
@@ -225,7 +221,6 @@ def end_session(
     """
     client = Client()
     if not client.session:
-        logger.warning("end_session called when session not initialized. Please call lai.init() first.")
         return
     client.session.update_session(is_finished=True, **locals())
     client.clear()
@@ -237,7 +232,6 @@ def reset_sdk() -> None:
     """
     client = Client()
     if not client.initialized:
-        logger.warning("reset_sdk called when SDK not initialized. Please call lai.init() first.")
         return
     client.clear()
 
@@ -307,7 +301,6 @@ def create_step(
     """
     client = Client()
     if not client.session:
-        logger.warning("create_step called when session not initialized. Please call lai.init() first.")
         return
     return client.session.create_step(**locals())
 
@@ -337,7 +330,6 @@ def update_step(
     """
     client = Client()
     if not client.session:
-        logger.warning("update_step called when session not initialized. Please call lai.init() first.")
         return
     if not client.session.active_step:
         raise InvalidOperationError("No active step to update")
@@ -369,7 +361,6 @@ def end_step(
     """
     client = Client()
     if not client.session:
-        logger.warning("end_step called when session not initialized. Please call lai.init() first.")
         return
     
     if not client.session.active_step and step_id is None:
@@ -404,7 +395,6 @@ def create_event(
 
     client = Client()
     if not client.session:
-        logger.warning("create_event called when session not initialized. Please call lai.init() first.")
         return
     return client.session.create_event(**locals())
 
@@ -430,7 +420,6 @@ def update_event(
     """
     client = Client()
     if not client.session:
-        logger.warning("update_event called when session not initialized. Please call lai.init() first.")
         return
     client.session.update_event(**locals())
 
@@ -455,7 +444,6 @@ def end_event(
     """
     client = Client()
     if not client.session:
-        logger.warning("end_event called when session not initialized. Please call lai.init() first.")
         return
     client.session.update_event(is_finished=True, **locals())
 
@@ -480,7 +468,6 @@ def get_prompt(
     """
     client = Client()
     if not client.session:
-        logger.warning("get_prompt called when session not initialized, and will return an empty string. Please call lai.init() first.")
         return ""
     prompt = client.get_prompt(prompt_name, cache_ttl, label)
     if variables:

lucidicai/singleton.py

@@ -4,13 +4,47 @@ lai_inst = {}
 
 def singleton(class_):
     def getinstance(*args, **kwargs):
-        if class_ not in lai_inst:
-            if class_.__name__ == 'Client' and ('lucidic_api_key' not in kwargs or 'agent_id' not in kwargs):
-                raise LucidicNotInitializedError()
-            lai_inst[class_] = class_(*args, **kwargs)
-        return lai_inst[class_]
 
+        inst = lai_inst.get(class_)
+
+        # on first access -> no instance yet
+        if inst is None:
+            # no args/kwargs -> return a NullClient for Client
+            if class_.__name__ == 'Client' and not args and not kwargs:
+                inst = NullClient()
+            else:
+                inst = class_(*args, **kwargs)
+            lai_inst[class_] = inst
+            return inst
+
+        # existing instance present
+        # if NullClient and now real init args are passed -> upgrade it
+        if isinstance(inst, NullClient) and (args or kwargs):
+            inst = class_(*args, **kwargs)
+            lai_inst[class_] = inst
+        return inst
+    
     return getinstance
 
 def clear_singletons():
     lai_inst.clear()
+
+
+class NullClient:
+    """
+    A no-op client returned when Lucidic has not been initialized.
+    All methods are inert and session is None.
+    """
+    def __init__(self):
+        self.initialized = False
+        self.session = None
+        self.providers = []
+
+    def set_provider(self, *args, **kwargs):
+        pass
+
+    def undo_overrides(self):
+        pass
+
+    def clear(self):
+        pass

{lucidicai-1.2.13.dist-info → lucidicai-1.2.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: lucidicai
-Version: 1.2.13
+Version: 1.2.14
 Summary: Lucidic AI Python SDK
 Author: Andy Liang
 Author-email: andy@lucidic.ai

{lucidicai-1.2.13.dist-info → lucidicai-1.2.14.dist-info}/RECORD

@@ -1,4 +1,4 @@
-lucidicai/__init__.py,sha256=gYHjKKbjNwsY1uEcL4ogIJqHzKeabqKlKdz3H_XNGXY,18173
+lucidicai/__init__.py,sha256=sNUGk7kd2IsjL39WgRkc7VuulRbFB5o1liK_65iEH9E,17034
 lucidicai/action.py,sha256=sPRd1hTIVXDqnvG9ZXWEipUFh0bsXcE0Fm7RVqmVccM,237
 lucidicai/client.py,sha256=axJ9JjDq6qIuyyYtiQlMREPTKD_eKve-0pOBKHH7HZg,5695
 lucidicai/constants.py,sha256=_u0z3M4geZgS1g-CrOZUVjtcew8l70dKQnpVQvlXh9w,2172
@@ -7,7 +7,7 @@ lucidicai/event.py,sha256=9Z1yuP7Pef0sdXABU9SCHCLZSu6DfK--uGZoq-a9_IA,1974
 lucidicai/image_upload.py,sha256=ShacoEaGXbQESatfp-CrIygsDntt9IkcCqZcc9uLZVQ,3130
 lucidicai/model_pricing.py,sha256=benQS2sp0-bboqP13e9l3ZYaYJcoqdIjHEaufCWoNw4,11599
 lucidicai/session.py,sha256=goLQxBvXkLT5kS3eSfht3IFqvfYfgULC4eECSIanrPc,4909
-lucidicai/singleton.py,sha256=gmgei2mvCsgwng--Bb4Phk2wluvgS03zW3Cll6yQR9Y,477
+lucidicai/singleton.py,sha256=gfT3XdWLXSIWMqDXbY6-pnesMZ8RGRitaEPhIsgrRPw,1272
 lucidicai/state.py,sha256=4Tb1X6l2or6w_e62FYSuEeghAv3xXm5gquKwzCpvdok,235
 lucidicai/step.py,sha256=egDmr3z3ZXu5nBJqeepj0Ml3ifDuyg07OwTB6vOJCaY,2462
 lucidicai/streaming.py,sha256=wQ32xMCHvaNaM6OQoAhY-yS5KoLi71KQPCbcxjpLzbU,11658
@@ -19,7 +19,7 @@ lucidicai/providers/openai_agents_handler.py,sha256=AAMtY7HZ-7UvTn1RVwd-uHhibJus
 lucidicai/providers/openai_handler.py,sha256=j2SW3YlGY1FhMO7d03WaIRxAtti6xATnoo2h8jh-uJk,35166
 lucidicai/providers/opentelemetry_converter.py,sha256=xOHCqoTyO4hUkL6k7fxy84PbljPpYep6ET9ZqbkJehc,17665
 lucidicai/providers/pydantic_ai_handler.py,sha256=Vu03SEqRuQNbmOK3iPwWVqczVRZNDDVoilDILIycK8c,28935
-lucidicai-1.2.13.dist-info/METADATA,sha256=JwKTQtiaKO8529OgFcPskeitCzAeKGLpFdTUHl3QV5o,577
-lucidicai-1.2.13.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
-lucidicai-1.2.13.dist-info/top_level.txt,sha256=vSSdM3lclF4I5tyVC0xxUk8eIRnnYXMe1hW-eO91HUo,10
-lucidicai-1.2.13.dist-info/RECORD,,
+lucidicai-1.2.14.dist-info/METADATA,sha256=_zXTh7KcZmfq_YmlgytwfJNJDtAxE7Hy4iSKHbK0pNk,577
+lucidicai-1.2.14.dist-info/WHEEL,sha256=Xo9-1PvkuimrydujYJAjF7pCkriuXBpUPEjma1nZyJ0,92
+lucidicai-1.2.14.dist-info/top_level.txt,sha256=vSSdM3lclF4I5tyVC0xxUk8eIRnnYXMe1hW-eO91HUo,10
+lucidicai-1.2.14.dist-info/RECORD,,