meshcode 2.0.5__tar.gz → 2.0.6__tar.gz

{meshcode-2.0.5 → meshcode-2.0.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshcode
-Version: 2.0.5
+Version: 2.0.6
 Summary: Real-time communication between AI agents — Supabase-backed CLI
 Author-email: MeshCode <hello@meshcode.io>
 License: MIT

{meshcode-2.0.5 → meshcode-2.0.6}/meshcode/__init__.py

@@ -1,2 +1,2 @@
 """MeshCode — Real-time communication between AI agents."""
-__version__ = "2.0.5"
+__version__ = "2.0.6"

{meshcode-2.0.5 → meshcode-2.0.6}/meshcode/meshcode_mcp/realtime.py

@@ -216,6 +216,10 @@ class RealtimeListener:
                         except Exception as e:
                             log.warning(f"notify_callback failed: {e}")
 
+    def peek(self) -> list:
+        """Return queued messages without removing them."""
+        return list(self.queue)
+
     def drain(self) -> list:
         """Pop and return all queued messages."""
         out = list(self.queue)

{meshcode-2.0.5 → meshcode-2.0.6}/meshcode/meshcode_mcp/server.py

@@ -329,13 +329,21 @@ if not _flip_status("idle", ""):
 
 
 # ============================================================
-# Working/idle status decorator for @mcp.tool() functions.
-# Fire-and-forget flips so tool execution is never blocked.
+# Automatic Agent Status State Machine
+# States: ONLINE → WORKING → ONLINE → WAITING → ONLINE → IDLE → OFFLINE
+# Transitions driven by tool calls and meshcode_wait, not the LLM.
 # ============================================================
 import functools as _functools
 import threading as _threading
+import time as _time
 
 _flip_lock = _threading.Lock()
+_current_state = "online"
+_last_tool_at = _time.time()
+_current_tool = ""
+_IDLE_THRESHOLD_S = 120  # seconds without tool call → IDLE
+_PROCESSING_COOLDOWN_S = 15  # seconds after tool returns before flipping to ONLINE
+_processing_timer: Optional[_threading.Timer] = None
 
 
 async def _async_flip_status(status: str, task: str = "") -> None:
@@ -362,6 +370,28 @@ def _schedule_flip(status: str, task: str = "") -> None:
         ).start()
 
 
+def _set_state(state: str, tool: str = "") -> None:
+    """Update the state machine and broadcast to dashboard."""
+    global _current_state, _current_tool, _last_tool_at, _processing_timer
+    # Cancel any pending processing→online timer
+    if _processing_timer is not None:
+        _processing_timer.cancel()
+        _processing_timer = None
+    _current_state = state
+    _current_tool = tool
+    if state == "working":
+        _last_tool_at = _time.time()
+    _schedule_flip(state, tool)
+
+
+def _processing_to_online() -> None:
+    """Called after PROCESSING cooldown expires — flip to ONLINE."""
+    global _processing_timer
+    _processing_timer = None
+    if _current_state == "processing":
+        _set_state("online", "")
+
+
 def with_working_status(func):
     name = func.__name__
     skip = (name == "meshcode_wait")
@@ -370,26 +400,37 @@ def with_working_status(func):
         async def awrapper(*args, **kwargs):
             _check_hot_reload()
             if not skip:
-                _schedule_flip("working", name)
+                _set_state("working", name)
                 _record_event_bg("tool_call", {"tool": name, "args_keys": list(kwargs.keys())})
             try:
                 return await func(*args, **kwargs)
             finally:
                 if not skip:
-                    _schedule_flip("idle", "")
+                    global _last_tool_at, _processing_timer
+                    _last_tool_at = _time.time()
+                    # Enter PROCESSING cooldown — stays green for 15s
+                    _set_state("processing", "processing...")
+                    _processing_timer = _threading.Timer(_PROCESSING_COOLDOWN_S, _processing_to_online)
+                    _processing_timer.daemon = True
+                    _processing_timer.start()
         return awrapper
     else:
         @_functools.wraps(func)
         def swrapper(*args, **kwargs):
             _check_hot_reload()
             if not skip:
-                _schedule_flip("working", name)
+                _set_state("working", name)
                 _record_event_bg("tool_call", {"tool": name, "args_keys": list(kwargs.keys())})
             try:
                 return func(*args, **kwargs)
             finally:
                 if not skip:
-                    _schedule_flip("idle", "")
+                    global _last_tool_at, _processing_timer
+                    _last_tool_at = _time.time()
+                    _set_state("processing", "processing...")
+                    _processing_timer = _threading.Timer(_PROCESSING_COOLDOWN_S, _processing_to_online)
+                    _processing_timer.daemon = True
+                    _processing_timer.start()
         return swrapper
 
 
@@ -659,9 +700,13 @@ def _heartbeat_thread_fn():
     while not _heartbeat_stop.is_set():
         try:
             be.sb_rpc("mc_heartbeat", {"p_project_id": _PROJECT_ID, "p_agent_name": AGENT_NAME, "p_version": "2.0.0"})
-            # Also ensure status is at least "idle" (not "offline") between tool calls
+            # Idle detection: only from online/processing states (NOT waiting)
+            # Agents in meshcode_wait should stay WAITING, not flip to IDLE
+            if _current_state in ("online", "processing") and (_time.time() - _last_tool_at) > _IDLE_THRESHOLD_S:
+                _set_state("idle", f"idle ({int((_time.time() - _last_tool_at) / 60)}m)")
+            # Sync current state to DB (in case realtime missed it)
             try:
-                be.set_status(_PROJECT_ID, AGENT_NAME, "idle", "")
+                be.set_status(_PROJECT_ID, AGENT_NAME, _current_state, _current_tool)
             except Exception:
                 pass
             if _REALTIME and not _REALTIME.is_connected:
@@ -861,8 +906,12 @@ async def meshcode_wait(timeout_seconds: int = 120, include_acks: bool = False)
     """
     global _IN_WAIT
     _IN_WAIT = True
+    _set_state("waiting", "listening for messages")
     try:
-        return await _meshcode_wait_inner(actual_timeout=max(1, int(timeout_seconds)), include_acks=include_acks)
+        result = await _meshcode_wait_inner(actual_timeout=max(1, int(timeout_seconds)), include_acks=include_acks)
+        if result.get("got_message"):
+            _set_state("online", "")
+        return result
     finally:
         _IN_WAIT = False
 
@@ -961,14 +1010,18 @@ def meshcode_check(include_acks: bool = False) -> Dict[str, Any]:
     the realtime listener connected).
     """
     pending = be.count_pending(_PROJECT_ID, AGENT_NAME)
-    realtime_buffered = _REALTIME.drain() if _REALTIME else []
-    deduped = _filter_and_mark(realtime_buffered)
+    # Peek at realtime buffer WITHOUT draining — check is non-destructive
+    realtime_buffered = _REALTIME.peek() if _REALTIME else []
+    # Don't mark as seen — meshcode_check is a peek, not a consume
+    deduped = [m for m in realtime_buffered if _seen_key(m) not in _SEEN_MSG_IDS]
 
     # Fallback: if realtime buffer is empty but DB has pending messages,
-    # fetch them from the DB so they're not invisible to the agent.
+    # fetch them from the DB. Use mark_read=False so meshcode_check is a
+    # non-destructive peek — messages stay pending until meshcode_wait or
+    # meshcode_read consumes them.
     if not deduped and pending > 0:
-        raw = be.read_inbox(_PROJECT_ID, AGENT_NAME)
-        deduped = _filter_and_mark([
+        raw = be.read_inbox(_PROJECT_ID, AGENT_NAME, mark_read=False)
+        deduped = [
             {
                 "from": m["from_agent"],
                 "type": m.get("type", "msg"),
@@ -978,7 +1031,8 @@ def meshcode_check(include_acks: bool = False) -> Dict[str, Any]:
                 "parent_id": m.get("parent_msg_id"),
             }
             for m in raw
-        ])
+            if _seen_key({"id": m.get("id"), "from": m.get("from_agent"), "payload": m.get("payload", {}), "ts": m.get("created_at")}) not in _SEEN_MSG_IDS
+        ]
 
     split = _split_messages(deduped)
     if not include_acks:

{meshcode-2.0.5 → meshcode-2.0.6}/meshcode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshcode
-Version: 2.0.5
+Version: 2.0.6
 Summary: Real-time communication between AI agents — Supabase-backed CLI
 Author-email: MeshCode <hello@meshcode.io>
 License: MIT

{meshcode-2.0.5 → meshcode-2.0.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "meshcode"
-version = "2.0.5"
+version = "2.0.6"
 description = "Real-time communication between AI agents — Supabase-backed CLI"
 readme = "README.md"
 license = {text = "MIT"}