jvserve 2.1.14__tar.gz → 2.1.16__tar.gz

{jvserve-2.1.14 → jvserve-2.1.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jvserve
-Version: 2.1.14
+Version: 2.1.16
 Summary: FastAPI webserver for loading and interaction with JIVAS agents.
 Home-page: https://github.com/TrueSelph/jvserve
 Author: TrueSelph Inc.

{jvserve-2.1.14 → jvserve-2.1.16}/jvserve/cli.py

@@ -33,6 +33,7 @@ from typing_extensions import Any
 from watchfiles import Change, watch
 
 from jvserve.lib.agent_interface import AgentInterface
+from jvserve.lib.agent_pulse import AgentPulse
 from jvserve.lib.file_interface import (
     DEFAULT_FILES_ROOT,
     FILE_INTERFACE,
@@ -220,6 +221,7 @@ def run_jivas(filename: str, host: str = "localhost", port: int = 8000) -> None:
 
     async def on_shutdown() -> None:
         jvlogger.info("JIVAS is shutting down...")
+        AgentPulse.stop()
 
     app = JaseciFastAPI.get()
     app_lifespan = app.router.lifespan_context

jvserve-2.1.16/jvserve/lib/agent_pulse.py

@@ -0,0 +1,63 @@
+"""Agent Pulse class for scheduling and running agent jobs."""
+
+import logging
+import threading
+import time
+
+import schedule
+
+
+class AgentPulse:
+    """Agent Pulse class for scheduling and running agent jobs."""
+
+    EVENT = None
+    THREAD = None
+    LOGGER = logging.getLogger(__name__)
+
+    @staticmethod
+    def start(interval: int = 1) -> threading.Event:
+        """Starts the agent pulse in a separate thread that executes
+        pending jobs at each elapsed time interval.
+
+        This method ensures that only one thread is running at a time
+        to prevent duplication. If a thread is already running, it logs
+        a message and returns without starting a new thread.
+
+        @param interval: Time in seconds between each execution cycle of
+        scheduled jobs.
+        @return: threading.Event which can be set to stop the running
+        thread.
+
+        Note: It is intended behavior that run_continuously() does not
+        run missed jobs. For instance, a job scheduled to run every
+        minute with a run interval of one hour will only run once per
+        hour, not 60 times at once.
+        """
+
+        if AgentPulse.THREAD and AgentPulse.THREAD.is_alive():
+            AgentPulse.LOGGER.info("agent pulse is already running.")
+            return AgentPulse.EVENT
+
+        AgentPulse.EVENT = threading.Event()
+
+        class ScheduleThread(threading.Thread):
+            def run(self) -> None:
+                while AgentPulse.EVENT and not AgentPulse.EVENT.is_set():
+                    schedule.run_pending()
+                    time.sleep(interval)
+
+        AgentPulse.THREAD = ScheduleThread()
+        AgentPulse.THREAD.start()
+
+        AgentPulse.LOGGER.info("agent pulse started.")
+
+        return AgentPulse.EVENT
+
+    @staticmethod
+    def stop() -> None:
+        """Stops the agent pulse."""
+        if AgentPulse.EVENT and not AgentPulse.EVENT.is_set():
+            AgentPulse.LOGGER.info("agent pulse stopped.")
+            AgentPulse.EVENT.set()
+            if AgentPulse.THREAD:
+                AgentPulse.THREAD.join()

{jvserve-2.1.14 → jvserve-2.1.16}/jvserve.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jvserve
-Version: 2.1.14
+Version: 2.1.16
 Summary: FastAPI webserver for loading and interaction with JIVAS agents.
 Home-page: https://github.com/TrueSelph/jvserve
 Author: TrueSelph Inc.

{jvserve-2.1.14 → jvserve-2.1.16}/jvserve.egg-info/SOURCES.txt

@@ -11,6 +11,7 @@ jvserve.egg-info/requires.txt
 jvserve.egg-info/top_level.txt
 jvserve/lib/__init__.py
 jvserve/lib/agent_interface.py
+jvserve/lib/agent_pulse.py
 jvserve/lib/file_interface.py
 jvserve/lib/jac_interface.py
 jvserve/lib/jvlogger.py