meshcode 2.0.5__tar.gz → 2.0.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshcode
-Version: 2.0.5
+Version: 2.0.7
 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.7}/meshcode/__init__.py

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

{meshcode-2.0.5 → meshcode-2.0.7}/meshcode/meshcode_mcp/backend.py

@@ -319,10 +319,22 @@ def record_event(api_key, project_id, agent_name, session_id, event_type, payloa
     })
 
 
-def get_history(project_id: str, limit: int = 20) -> List[Dict]:
+def get_history(project_id: str, limit: int = 20, agent_filter: str = "") -> List[Dict]:
+    filters = f"project_id=eq.{project_id}&type=neq.ack"
+    if agent_filter:
+        filters += f"&or=(from_agent.eq.{quote(agent_filter)},to_agent.eq.{quote(agent_filter)})"
     return sb_select(
         "mc_messages",
-        f"project_id=eq.{project_id}&type=neq.ack",
+        filters,
         order="created_at.desc",
         limit=limit,
     )
+
+
+def get_message_by_id(project_id: str, msg_id: str) -> Optional[Dict]:
+    results = sb_select(
+        "mc_messages",
+        f"project_id=eq.{project_id}&id=eq.{msg_id}",
+        limit=1,
+    )
+    return results[0] if results else None

{meshcode-2.0.5 → meshcode-2.0.7}/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.7}/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:
@@ -838,6 +883,58 @@ def meshcode_read(include_acks: bool = False) -> Dict[str, Any]:
     return split
 
 
+@mcp.tool()
+@with_working_status
+def meshcode_history(limit: int = 20, agent_filter: Optional[str] = None) -> Dict[str, Any]:
+    """View recent message history (both read and unread). Use when you need
+    context from past conversations or lost messages after context compression.
+
+    Args:
+        limit: Max messages to return (default 20).
+        agent_filter: Optional agent name to filter (shows messages to/from that agent).
+    """
+    raw = be.get_history(_PROJECT_ID, limit=limit, agent_filter=agent_filter or "")
+    messages = [
+        {
+            "from": m.get("from_agent", ""),
+            "to": m.get("to_agent", ""),
+            "type": m.get("type", "msg"),
+            "ts": m.get("created_at", ""),
+            "payload": m.get("payload", {}),
+            "id": m.get("id", ""),
+            "read": m.get("read", False),
+        }
+        for m in raw
+    ]
+    return {"ok": True, "messages": messages, "count": len(messages)}
+
+
+@mcp.tool()
+@with_working_status
+def meshcode_read_message(msg_id: str) -> Dict[str, Any]:
+    """Fetch a specific message by ID. Use when you need to re-read a message
+    after context was compressed or session restarted.
+
+    Args:
+        msg_id: The UUID of the message to fetch.
+    """
+    msg = be.get_message_by_id(_PROJECT_ID, msg_id)
+    if not msg:
+        return {"error": "message not found", "msg_id": msg_id}
+    return {
+        "ok": True,
+        "message": {
+            "from": msg.get("from_agent", ""),
+            "to": msg.get("to_agent", ""),
+            "type": msg.get("type", "msg"),
+            "ts": msg.get("created_at", ""),
+            "payload": msg.get("payload", {}),
+            "id": msg.get("id", ""),
+            "read": msg.get("read", False),
+        },
+    }
+
+
 def _detect_global_done(messages: List[Dict[str, Any]]) -> Optional[Dict[str, Any]]:
     """Return {reason, from} if the list contains a global_done signal, else None."""
     for m in messages:
@@ -861,8 +958,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 +1062,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 +1083,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.7}/meshcode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshcode
-Version: 2.0.5
+Version: 2.0.7
 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.7}/pyproject.toml

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