meshcode 2.0.2__tar.gz → 2.0.4__tar.gz

{meshcode-2.0.2 → meshcode-2.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshcode
-Version: 2.0.2
+Version: 2.0.4
 Summary: Real-time communication between AI agents — Supabase-backed CLI
 Author-email: MeshCode <hello@meshcode.io>
 License: MIT
@@ -153,7 +153,9 @@ meshcode revoke-member my-project <user> # kick a member instantly
 | `meshcode status` | `meshcode status` | Show the logged-in account and version. |
 | `meshcode send` (legacy) | `meshcode send my-project a:b '{"need":"..."}'` | Pre-1.5 manual message send (MCP tools are preferred). |
 | `meshcode read` (legacy) | `meshcode read my-project backend` | Pre-1.5 manual read. |
-| `meshcode --version` | `meshcode --version` | Print `meshcode 1.5.1`. |
+| `meshcode projects` | `meshcode projects` | List all your meshworks and their agents. |
+| `meshcode list` | `meshcode list` | Alias for `meshcode projects`. |
+| `meshcode --version` | `meshcode --version` | Print current version. |
 | `meshcode help` | `meshcode help` | Top-level help. Per-verb help: `meshcode <verb> --help`. |
 
 ---
@@ -251,10 +253,11 @@ pip install meshcode --upgrade
 ### Reconnect a single agent
 
 ```bash
-meshcode run <agent-name>
+meshcode setup my-project agent-name   # ensures workspace exists (safe to re-run)
+meshcode run agent-name                # opens your editor
 ```
 
-That's it. This reopens your editor with the agent's MCP server. The agent automatically:
+Since v2.0.2, `meshcode run` **auto-recovers** if the workspace was deleted — it queries the server, recreates the workspace, and launches. So `meshcode run agent-name` alone is usually enough. The agent automatically:
 1. Loads its persistent memories (`meshcode_recall()`)
 2. Checks who else is online (`meshcode_status()`)
 3. Picks up any open tasks (`meshcode_tasks()`)
@@ -326,21 +329,49 @@ If an agent is offline, the dashboard shows a **Reconnect** button on its card.
 
 ## Troubleshooting
 
-**1. `No credentials found. Run meshcode login first.`**
+**1. `no workspace found for agent 'X'`**
+Your local workspace was deleted or never created. Since v2.0.2, `meshcode run` auto-recovers by querying the server. If you're on an older version:
+```bash
+pip install meshcode --upgrade          # get v2.0.2+
+meshcode run agent-name                 # auto-recovers now
+```
+If auto-recovery fails (no API key stored), run setup manually:
+```bash
+meshcode setup my-project agent-name    # recreates ~/meshcode/my-project-agent-name/
+meshcode run agent-name
+```
+
+**2. `meshcode projects` shows no projects (but dashboard shows them)**
+Before v2.0.2, the `projects` command used an unauthenticated query blocked by row-level security. Upgrade:
+```bash
+pip install meshcode --upgrade
+meshcode projects                       # now uses your API key
+```
+
+**3. `No credentials found. Run meshcode login first.`**
 You haven't stored a key yet. Grab your `mc_xxx` from https://meshcode.io/onboarding and run:
 ```bash
 meshcode login mc_xxxxxxxxxxxx
 ```
 
-**2. `agent already running in another window`**
+**4. `agent already running in another window`**
 MeshCode prevents split-brain — the same agent name can't be live in two editor windows. Close the other window, or use a different agent name.
 
-**3. `scoped api key cannot access this project`**
+**5. `scoped api key cannot access this project`**
 You joined a meshwork via an invite, and you're now trying to use a different project. Scoped keys only work for the one mesh they were minted for. Run `meshcode members <correct-project>` to confirm which mesh you belong to.
 
-**4. `meshcode: command not found`**
+**6. `meshcode: command not found`**
 Either `pip install` didn't add to your PATH (check `which meshcode` and `python -m site --user-base`), or you have a stale pre-1.0.0 `~/bin/meshcode` shim shadowing the real binary — delete it.
 
+**7. `could not resolve project 'X': project not found`**
+Wrong project name. Since v2.0.2, `meshcode setup` will suggest your real projects when it can't find the one you typed. Check the exact name:
+```bash
+meshcode projects                       # lists all your meshworks
+```
+
+**8. Unknown command (e.g., `meshcode list`)**
+Since v2.0.2, the CLI suggests the closest match instead of dumping the full help text. Common aliases: `list` and `ls` both work for `projects`.
+
 **5. `MCP server failed to start` in the Claude Code `/mcp` panel**
 Run `claude --debug` to see the underlying error. Nine times out of ten it's a stale or missing key — run `meshcode login mc_xxx` again.
 

{meshcode-2.0.2 → meshcode-2.0.4}/README.md

@@ -128,7 +128,9 @@ meshcode revoke-member my-project <user> # kick a member instantly
 | `meshcode status` | `meshcode status` | Show the logged-in account and version. |
 | `meshcode send` (legacy) | `meshcode send my-project a:b '{"need":"..."}'` | Pre-1.5 manual message send (MCP tools are preferred). |
 | `meshcode read` (legacy) | `meshcode read my-project backend` | Pre-1.5 manual read. |
-| `meshcode --version` | `meshcode --version` | Print `meshcode 1.5.1`. |
+| `meshcode projects` | `meshcode projects` | List all your meshworks and their agents. |
+| `meshcode list` | `meshcode list` | Alias for `meshcode projects`. |
+| `meshcode --version` | `meshcode --version` | Print current version. |
 | `meshcode help` | `meshcode help` | Top-level help. Per-verb help: `meshcode <verb> --help`. |
 
 ---
@@ -226,10 +228,11 @@ pip install meshcode --upgrade
 ### Reconnect a single agent
 
 ```bash
-meshcode run <agent-name>
+meshcode setup my-project agent-name   # ensures workspace exists (safe to re-run)
+meshcode run agent-name                # opens your editor
 ```
 
-That's it. This reopens your editor with the agent's MCP server. The agent automatically:
+Since v2.0.2, `meshcode run` **auto-recovers** if the workspace was deleted — it queries the server, recreates the workspace, and launches. So `meshcode run agent-name` alone is usually enough. The agent automatically:
 1. Loads its persistent memories (`meshcode_recall()`)
 2. Checks who else is online (`meshcode_status()`)
 3. Picks up any open tasks (`meshcode_tasks()`)
@@ -301,21 +304,49 @@ If an agent is offline, the dashboard shows a **Reconnect** button on its card.
 
 ## Troubleshooting
 
-**1. `No credentials found. Run meshcode login first.`**
+**1. `no workspace found for agent 'X'`**
+Your local workspace was deleted or never created. Since v2.0.2, `meshcode run` auto-recovers by querying the server. If you're on an older version:
+```bash
+pip install meshcode --upgrade          # get v2.0.2+
+meshcode run agent-name                 # auto-recovers now
+```
+If auto-recovery fails (no API key stored), run setup manually:
+```bash
+meshcode setup my-project agent-name    # recreates ~/meshcode/my-project-agent-name/
+meshcode run agent-name
+```
+
+**2. `meshcode projects` shows no projects (but dashboard shows them)**
+Before v2.0.2, the `projects` command used an unauthenticated query blocked by row-level security. Upgrade:
+```bash
+pip install meshcode --upgrade
+meshcode projects                       # now uses your API key
+```
+
+**3. `No credentials found. Run meshcode login first.`**
 You haven't stored a key yet. Grab your `mc_xxx` from https://meshcode.io/onboarding and run:
 ```bash
 meshcode login mc_xxxxxxxxxxxx
 ```
 
-**2. `agent already running in another window`**
+**4. `agent already running in another window`**
 MeshCode prevents split-brain — the same agent name can't be live in two editor windows. Close the other window, or use a different agent name.
 
-**3. `scoped api key cannot access this project`**
+**5. `scoped api key cannot access this project`**
 You joined a meshwork via an invite, and you're now trying to use a different project. Scoped keys only work for the one mesh they were minted for. Run `meshcode members <correct-project>` to confirm which mesh you belong to.
 
-**4. `meshcode: command not found`**
+**6. `meshcode: command not found`**
 Either `pip install` didn't add to your PATH (check `which meshcode` and `python -m site --user-base`), or you have a stale pre-1.0.0 `~/bin/meshcode` shim shadowing the real binary — delete it.
 
+**7. `could not resolve project 'X': project not found`**
+Wrong project name. Since v2.0.2, `meshcode setup` will suggest your real projects when it can't find the one you typed. Check the exact name:
+```bash
+meshcode projects                       # lists all your meshworks
+```
+
+**8. Unknown command (e.g., `meshcode list`)**
+Since v2.0.2, the CLI suggests the closest match instead of dumping the full help text. Common aliases: `list` and `ls` both work for `projects`.
+
 **5. `MCP server failed to start` in the Claude Code `/mcp` panel**
 Run `claude --debug` to see the underlying error. Nine times out of ten it's a stale or missing key — run `meshcode login mc_xxx` again.
 

{meshcode-2.0.2 → meshcode-2.0.4}/meshcode/__init__.py

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

{meshcode-2.0.2 → meshcode-2.0.4}/meshcode/meshcode_mcp/realtime.py

@@ -13,6 +13,7 @@ import logging
 import ssl
 from collections import deque
 from typing import Any, Awaitable, Callable, Deque, Dict, Optional
+from urllib.parse import quote as url_quote
 
 try:
     import certifi
@@ -138,7 +139,7 @@ class RealtimeListener:
                                 "event": "INSERT",
                                 "schema": "meshcode",
                                 "table": "mc_messages",
-                                "filter": f"to_agent=eq.{self.agent_name}",
+                                "filter": f"to_agent=eq.{url_quote(self.agent_name, safe='')}",
                             }
                         ]
                     }

{meshcode-2.0.2 → meshcode-2.0.4}/meshcode/meshcode_mcp/server.py

@@ -44,18 +44,23 @@ def _try_auto_wake(from_agent: str, preview: str) -> None:
     """
     if _IN_WAIT or not _AUTO_WAKE:
         return
-    import subprocess, platform
-    nudge = f"You have a new mesh message from {from_agent}: {preview[:60]}. Check your inbox with meshcode_check()."
+    import subprocess, platform, re
+    # Sanitize inputs: strip everything except alphanumeric, spaces, basic punctuation
+    safe_agent = re.sub(r'[^a-zA-Z0-9_\- ]', '', from_agent)[:50]
+    safe_preview = re.sub(r'[^a-zA-Z0-9_\-.,!? ]', '', preview)[:60]
+    nudge = f"New mesh message from {safe_agent}: {safe_preview}. Check inbox with meshcode_check()."
     system = platform.system()
     try:
         if system == "Darwin":
-            # Find which terminal app is running this process
+            # Use xdotool-style approach: pass nudge as argument, not interpolated script
             parent_app = os.environ.get("TERM_PROGRAM", "Terminal")
             app_name = "iTerm" if "iTerm" in parent_app else "Terminal"
+            # Escape for AppleScript string: replace backslash and double-quote
+            as_safe = nudge.replace("\\", "\\\\").replace('"', '\\"')
             script = f'''
             tell application "{app_name}"
                 tell application "System Events"
-                    keystroke "{nudge}"
+                    keystroke "{as_safe}"
                     keystroke return
                 end tell
             end tell
@@ -64,15 +69,17 @@ def _try_auto_wake(from_agent: str, preview: str) -> None:
                              stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
             log.info(f"auto-wake: injected nudge via {app_name} AppleScript")
         elif system == "Windows":
+            # Sanitize for SendKeys: strip braces and special SendKeys metacharacters
+            sk_safe = nudge.replace("{", "").replace("}", "").replace("+", "").replace("^", "").replace("%", "").replace("~", "")
             ps_script = f'''
             Add-Type -AssemblyName System.Windows.Forms
-            [System.Windows.Forms.SendKeys]::SendWait("{nudge}{{ENTER}}")
+            [System.Windows.Forms.SendKeys]::SendWait("{sk_safe}{{ENTER}}")
             '''
             subprocess.Popen(["powershell", "-Command", ps_script],
                              stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
             log.info("auto-wake: injected nudge via PowerShell SendKeys")
         else:
-            # Linux — best-effort with xdotool
+            # Linux — xdotool takes args directly, not shell-interpolated (safe)
             subprocess.Popen(["xdotool", "type", "--clearmodifiers", nudge + "\n"],
                              stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
             log.info("auto-wake: injected nudge via xdotool")
@@ -138,6 +145,35 @@ def _split_messages(messages: List[Dict[str, Any]]) -> Dict[str, Any]:
 from . import backend as be
 from .realtime import RealtimeListener
 
+# ============================================================
+# Hot-reload: detect when backend.py changes on disk (e.g. after
+# pip install --upgrade meshcode) and reload without restart.
+# Only backend.py is safe to reload (stateless). server.py has
+# module-level state that would be destroyed by reload.
+# ============================================================
+import importlib as _importlib
+_be_mtime: float = 0.0
+try:
+    _be_path = os.path.abspath(be.__file__)
+    _be_mtime = os.path.getmtime(_be_path)
+except Exception:
+    _be_path = ""
+
+
+def _check_hot_reload() -> None:
+    """If backend.py was modified since boot/last reload, reimport it."""
+    global _be_mtime, be
+    if not _be_path:
+        return
+    try:
+        current_mtime = os.path.getmtime(_be_path)
+        if current_mtime > _be_mtime:
+            _be_mtime = current_mtime
+            _importlib.reload(be)
+            log.info("[meshcode] Hot-reloaded backend.py (new version detected)")
+    except Exception as e:
+        log.debug(f"hot-reload check failed: {e}")
+
 try:
     from mcp.server.fastmcp import FastMCP
 except ImportError:
@@ -310,6 +346,7 @@ def with_working_status(func):
     if asyncio.iscoroutinefunction(func):
         @_functools.wraps(func)
         async def awrapper(*args, **kwargs):
+            _check_hot_reload()
             if not skip:
                 _schedule_flip("working", name)
             try:
@@ -321,6 +358,7 @@ def with_working_status(func):
     else:
         @_functools.wraps(func)
         def swrapper(*args, **kwargs):
+            _check_hot_reload()
             if not skip:
                 _schedule_flip("working", name)
             try:
@@ -567,7 +605,10 @@ async def _on_new_message(msg: Dict[str, Any]) -> None:
     from_agent = msg.get("from") or msg.get("from_agent") or "unknown"
     payload = msg.get("payload") or {}
     preview = payload.get("text", "") if isinstance(payload, dict) else str(payload)
-    _try_auto_wake(from_agent, preview[:60])
+    try:
+        _try_auto_wake(from_agent, preview[:60])
+    except Exception:
+        pass  # auto-wake is best-effort, never block message handling
 
     try:
         srv = mcp._mcp_server  # FastMCP exposes the lowlevel server here
@@ -845,7 +886,20 @@ async def _meshcode_wait_inner(actual_timeout: int, include_acks: bool) -> Dict[
         # Realtime unavailable — plain sleep fallback so we still honor timeout.
         await asyncio.sleep(actual_timeout)
 
-    return {"timed_out": True}
+    # On timeout, check for unclaimed tasks assigned to this agent
+    timeout_result: Dict[str, Any] = {"timed_out": True}
+    try:
+        api_key = _get_api_key()
+        open_tasks = be.task_list(api_key, _PROJECT_ID, AGENT_NAME, status_filter="open")
+        if isinstance(open_tasks, dict) and open_tasks.get("ok"):
+            my_tasks = [t for t in open_tasks.get("tasks", [])
+                       if t.get("assignee") == AGENT_NAME and not t.get("claimed_by")]
+            if my_tasks:
+                timeout_result["unclaimed_tasks"] = len(my_tasks)
+                timeout_result["hint"] = f"You have {len(my_tasks)} unclaimed task(s) assigned to you. Run meshcode_tasks(status_filter='open') to see them."
+    except Exception:
+        pass
+    return timeout_result
 
 
 @mcp.tool()
@@ -988,9 +1042,22 @@ def meshcode_task_create(title: str, description: str = "", assignee: str = "*",
     Returns: {"ok": true, "task_id": "...", "title": "..."}
     """
     api_key = _get_api_key()
-    return be.task_create(api_key, _PROJECT_ID, AGENT_NAME, title,
+    result = be.task_create(api_key, _PROJECT_ID, AGENT_NAME, title,
                            description=description, assignee=assignee,
                            priority=priority, parent_task_id=parent_task_id)
+    # Auto-notify assignee so they wake from meshcode_wait
+    if isinstance(result, dict) and result.get("ok") and assignee and assignee != "*" and assignee != AGENT_NAME:
+        try:
+            be.send_message(_PROJECT_ID, AGENT_NAME, assignee, {
+                "type": "task_assigned",
+                "task_id": result.get("task_id", ""),
+                "title": title,
+                "priority": priority,
+                "text": f"New {priority} task assigned to you: {title}",
+            }, msg_type="system")
+        except Exception:
+            pass  # best-effort notification
+    return result
 
 
 @mcp.tool()
@@ -1258,6 +1325,9 @@ def _sync_to_obsidian(key: str, value: Any) -> None:
     Writes markdown notes with YAML frontmatter to MeshCode/<agent>/ folder.
     Failures are logged but never block the main memory write.
     """
+    from datetime import datetime
+    from urllib.request import Request, urlopen
+    from urllib.error import URLError
     try:
         import importlib
         prefs_mod = importlib.import_module("meshcode.preferences")
@@ -1265,10 +1335,6 @@ def _sync_to_obsidian(key: str, value: Any) -> None:
         if not config:
             return
 
-        from datetime import datetime
-        from urllib.request import Request, urlopen
-        from urllib.error import URLError
-
         # Build markdown note with YAML frontmatter
         timestamp = datetime.utcnow().strftime("%Y-%m-%dT%H:%M:%SZ")
         if isinstance(value, (dict, list)):
@@ -1332,7 +1398,10 @@ def meshcode_remember(key: str, value: Any) -> Dict[str, Any]:
     })
     # Best-effort sync to Obsidian vault (if configured)
     if isinstance(result, dict) and result.get("ok"):
-        _sync_to_obsidian(key, json_value)
+        try:
+            _sync_to_obsidian(key, json_value)
+        except Exception:
+            pass  # Obsidian sync is best-effort, never block memory writes
     return result
 
 

{meshcode-2.0.2 → meshcode-2.0.4}/meshcode.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meshcode
-Version: 2.0.2
+Version: 2.0.4
 Summary: Real-time communication between AI agents — Supabase-backed CLI
 Author-email: MeshCode <hello@meshcode.io>
 License: MIT
@@ -153,7 +153,9 @@ meshcode revoke-member my-project <user> # kick a member instantly
 | `meshcode status` | `meshcode status` | Show the logged-in account and version. |
 | `meshcode send` (legacy) | `meshcode send my-project a:b '{"need":"..."}'` | Pre-1.5 manual message send (MCP tools are preferred). |
 | `meshcode read` (legacy) | `meshcode read my-project backend` | Pre-1.5 manual read. |
-| `meshcode --version` | `meshcode --version` | Print `meshcode 1.5.1`. |
+| `meshcode projects` | `meshcode projects` | List all your meshworks and their agents. |
+| `meshcode list` | `meshcode list` | Alias for `meshcode projects`. |
+| `meshcode --version` | `meshcode --version` | Print current version. |
 | `meshcode help` | `meshcode help` | Top-level help. Per-verb help: `meshcode <verb> --help`. |
 
 ---
@@ -251,10 +253,11 @@ pip install meshcode --upgrade
 ### Reconnect a single agent
 
 ```bash
-meshcode run <agent-name>
+meshcode setup my-project agent-name   # ensures workspace exists (safe to re-run)
+meshcode run agent-name                # opens your editor
 ```
 
-That's it. This reopens your editor with the agent's MCP server. The agent automatically:
+Since v2.0.2, `meshcode run` **auto-recovers** if the workspace was deleted — it queries the server, recreates the workspace, and launches. So `meshcode run agent-name` alone is usually enough. The agent automatically:
 1. Loads its persistent memories (`meshcode_recall()`)
 2. Checks who else is online (`meshcode_status()`)
 3. Picks up any open tasks (`meshcode_tasks()`)
@@ -326,21 +329,49 @@ If an agent is offline, the dashboard shows a **Reconnect** button on its card.
 
 ## Troubleshooting
 
-**1. `No credentials found. Run meshcode login first.`**
+**1. `no workspace found for agent 'X'`**
+Your local workspace was deleted or never created. Since v2.0.2, `meshcode run` auto-recovers by querying the server. If you're on an older version:
+```bash
+pip install meshcode --upgrade          # get v2.0.2+
+meshcode run agent-name                 # auto-recovers now
+```
+If auto-recovery fails (no API key stored), run setup manually:
+```bash
+meshcode setup my-project agent-name    # recreates ~/meshcode/my-project-agent-name/
+meshcode run agent-name
+```
+
+**2. `meshcode projects` shows no projects (but dashboard shows them)**
+Before v2.0.2, the `projects` command used an unauthenticated query blocked by row-level security. Upgrade:
+```bash
+pip install meshcode --upgrade
+meshcode projects                       # now uses your API key
+```
+
+**3. `No credentials found. Run meshcode login first.`**
 You haven't stored a key yet. Grab your `mc_xxx` from https://meshcode.io/onboarding and run:
 ```bash
 meshcode login mc_xxxxxxxxxxxx
 ```
 
-**2. `agent already running in another window`**
+**4. `agent already running in another window`**
 MeshCode prevents split-brain — the same agent name can't be live in two editor windows. Close the other window, or use a different agent name.
 
-**3. `scoped api key cannot access this project`**
+**5. `scoped api key cannot access this project`**
 You joined a meshwork via an invite, and you're now trying to use a different project. Scoped keys only work for the one mesh they were minted for. Run `meshcode members <correct-project>` to confirm which mesh you belong to.
 
-**4. `meshcode: command not found`**
+**6. `meshcode: command not found`**
 Either `pip install` didn't add to your PATH (check `which meshcode` and `python -m site --user-base`), or you have a stale pre-1.0.0 `~/bin/meshcode` shim shadowing the real binary — delete it.
 
+**7. `could not resolve project 'X': project not found`**
+Wrong project name. Since v2.0.2, `meshcode setup` will suggest your real projects when it can't find the one you typed. Check the exact name:
+```bash
+meshcode projects                       # lists all your meshworks
+```
+
+**8. Unknown command (e.g., `meshcode list`)**
+Since v2.0.2, the CLI suggests the closest match instead of dumping the full help text. Common aliases: `list` and `ls` both work for `projects`.
+
 **5. `MCP server failed to start` in the Claude Code `/mcp` panel**
 Run `claude --debug` to see the underlying error. Nine times out of ten it's a stale or missing key — run `meshcode login mc_xxx` again.
 

{meshcode-2.0.2 → meshcode-2.0.4}/pyproject.toml

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