meshcode 2.10.59__tar.gz → 2.10.61__tar.gz

{meshcode-2.10.59 → meshcode-2.10.61}/PKG-INFO

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

{meshcode-2.10.59 → meshcode-2.10.61}/meshcode/__init__.py

@@ -1,5 +1,5 @@
 """MeshCode — Real-time communication between AI agents."""
-__version__ = "2.10.59"
+__version__ = "2.10.61"
 
 # Exception hierarchy — eagerly imported (lightweight, no deps)
 from meshcode.exceptions import (  # noqa: F401

{meshcode-2.10.59 → meshcode-2.10.61}/meshcode/comms_v4.py

@@ -3324,6 +3324,15 @@ if __name__ == "__main__":
             from meshcode.launcher_install import main as _launcher_main  # type: ignore
         sys.exit(_launcher_main(sys.argv[2:]))
 
+    elif cmd == "upload":
+        # meshcode upload <file>
+        if len(pos) < 1:
+            print("Usage: meshcode upload <file>")
+            sys.exit(1)
+        import importlib
+        _upl = importlib.import_module("meshcode.upload")
+        sys.exit(_upl.cmd_upload(pos[0]))
+
     elif cmd in ("help", "--help", "-h"):
         show_help()
 
@@ -3360,7 +3369,7 @@ if __name__ == "__main__":
             "setup", "run", "go", "invite", "join", "invites", "members",
             "revoke-invite", "revoke-member", "login", "prefs", "launcher",
             "help", "init", "doctor", "compat", "upgrade", "profile", "validate-sessions", "wake-headless",
-            "supervisor",
+            "supervisor", "upload",
         ]
         # Simple fuzzy: prefix match + Levenshtein-like best match
         suggestions = [c for c in known_cmds if c.startswith(cmd)]

meshcode-2.10.61/meshcode/error_hints.py

@@ -0,0 +1,74 @@
+"""Smart error messages — maps common error patterns to actionable fix commands.
+
+Usage:
+    from meshcode.error_hints import hint_for_error
+    print(hint_for_error("agent not found"))
+    # → "Run: meshcode register <project> <agent> <role>"
+"""
+
+_HINTS = [
+    # Auth errors
+    ("invalid api_key", "Run: meshcode login <api_key> to set your credentials"),
+    ("api key", "Run: meshcode login <api_key> to refresh credentials"),
+    ("auth_failed", "Run: meshcode login to re-authenticate"),
+    ("forbidden", "You don't have permission. Check: meshcode doctor"),
+    ("not authenticated", "Run: meshcode login <api_key>"),
+
+    # Agent errors
+    ("agent not found", "Run: meshcode register <project> <agent_name> <role>"),
+    ("agent.*not registered", "Run: meshcode register <project> <agent_name> <role>"),
+
+    # Project errors
+    ("project.*not found", "Check project name with: meshcode projects"),
+    ("no projects found", "Create one at meshcode.io/dashboard or: meshcode init <project_name>"),
+
+    # Network errors
+    ("circuit breaker open", "Supabase is temporarily unavailable. Wait 30s and retry. Details: meshcode doctor"),
+    ("connection refused", "Check internet connection. If persists: meshcode doctor"),
+    ("network error", "Check internet connection. If persists: meshcode doctor"),
+    ("timeout", "Request timed out. Check connection: meshcode doctor"),
+
+    # MCP errors
+    ("MCP server crashed", "Restart: meshcode run <agent>"),
+    ("stdin EOF", "MCP pipe closed. Restart the MCP server or Claude Code session"),
+    ("mcp.*failed", "Check MCP config: meshcode doctor"),
+
+    # Task errors
+    ("task.*already claimed", "This task is being worked on. Try: meshcode tasks to see available tasks"),
+    ("task not found", "Check task ID. List tasks: meshcode tasks"),
+
+    # Config errors
+    ("comms_v4.py not found", "Reinstall: pip install --upgrade meshcode"),
+    ("\.mcp\.json", "Run: meshcode setup <project> <agent> to create config"),
+
+    # Token errors
+    ("token expired", "Generate a new token from the dashboard"),
+    ("token already used", "Generate a new token from the dashboard"),
+]
+
+
+def hint_for_error(error_msg: str) -> str:
+    """Return an actionable fix suggestion for a given error message.
+
+    Returns empty string if no hint matches.
+    """
+    import re
+    lower = error_msg.lower()
+    for pattern, hint in _HINTS:
+        if re.search(pattern, lower):
+            return hint
+    return ""
+
+
+def format_error(error_msg: str, prefix: str = "[meshcode]") -> str:
+    """Format an error with an actionable hint if available.
+
+    Example output:
+        [meshcode] ERROR: agent not found
+        [meshcode] Fix: Run: meshcode register <project> <agent_name> <role>
+    """
+    lines = [f"{prefix} ERROR: {error_msg}"]
+    hint = hint_for_error(error_msg)
+    if hint:
+        lines.append(f"{prefix} Fix: {hint}")
+    return "\n".join(lines)

{meshcode-2.10.59 → meshcode-2.10.61}/meshcode/meshcode_mcp/server.py

@@ -2183,6 +2183,16 @@ def _mark_realtime_msgs_read_in_db(messages: List[Dict[str, Any]]) -> None:
         except Exception as e:
             log.debug(f"mark_read failed for msg {mid}: {e}")
 
+    # Confirm delivery (best-effort, background) — completes the
+    # delivery pipeline: sent → read → confirmed.
+    try:
+        be.sb_rpc("mc_confirm_delivery", {
+            "p_api_key": api_key,
+            "p_message_ids": msg_ids,
+        })
+    except Exception:
+        pass  # Non-critical: messages still work without confirmation
+
 
 async def _meshcode_wait_inner(actual_timeout: int, include_acks: bool) -> Dict[str, Any]:
 

meshcode-2.10.61/meshcode/upload.py

@@ -0,0 +1,125 @@
+"""MeshCode file upload — register metadata + upload to Supabase Storage."""
+import os
+import sys
+import json
+import mimetypes
+from pathlib import Path
+from urllib.request import Request, urlopen
+from urllib.error import HTTPError
+
+
+def upload_file(file_path: str, api_key: str, supabase_url: str, supabase_key: str) -> dict:
+    """Upload a file to MeshCode via Supabase Storage.
+
+    1. Register file metadata via mc_register_file RPC
+    2. Upload binary to Supabase Storage bucket
+    3. Return file_id for task attachment
+
+    Returns: {"ok": True, "file_id": "...", "storage_path": "..."}
+    """
+    path = Path(file_path)
+    if not path.exists():
+        return {"error": f"file not found: {file_path}"}
+
+    file_name = path.name
+    mime_type = mimetypes.guess_type(file_name)[0] or "application/octet-stream"
+    size_bytes = path.stat().st_size
+
+    if size_bytes > 52428800:
+        return {"error": "file too large (max 50MB)"}
+
+    # 1. Register metadata
+    rpc_url = f"{supabase_url}/rest/v1/rpc/mc_register_file"
+    payload = json.dumps({
+        "p_api_key": api_key,
+        "p_file_name": file_name,
+        "p_mime_type": mime_type,
+        "p_size_bytes": size_bytes,
+    }).encode("utf-8")
+
+    req = Request(rpc_url, data=payload, method="POST")
+    req.add_header("apikey", supabase_key)
+    req.add_header("Content-Type", "application/json")
+
+    try:
+        with urlopen(req) as resp:
+            result = json.loads(resp.read())
+    except HTTPError as e:
+        body = e.read().decode("utf-8", errors="replace")
+        return {"error": f"register failed: {body[:200]}"}
+
+    if not result or result.get("error"):
+        return {"error": f"register failed: {result}"}
+
+    storage_path = result["storage_path"]
+    bucket = result.get("bucket", "meshcode-files")
+    file_id = result["file_id"]
+
+    # 2. Upload to Supabase Storage
+    storage_url = f"{supabase_url}/storage/v1/object/{bucket}/{storage_path}"
+    with open(path, "rb") as f:
+        file_data = f.read()
+
+    upload_req = Request(storage_url, data=file_data, method="POST")
+    upload_req.add_header("apikey", supabase_key)
+    upload_req.add_header("Authorization", f"Bearer {supabase_key}")
+    upload_req.add_header("Content-Type", mime_type)
+
+    try:
+        with urlopen(upload_req) as resp:
+            upload_result = json.loads(resp.read())
+    except HTTPError as e:
+        body = e.read().decode("utf-8", errors="replace")
+        return {"error": f"upload failed: {body[:200]}", "file_id": file_id, "note": "metadata registered but upload failed"}
+
+    return {
+        "ok": True,
+        "file_id": file_id,
+        "file_name": file_name,
+        "size_bytes": size_bytes,
+        "storage_path": storage_path,
+        "mime_type": mime_type,
+    }
+
+
+def cmd_upload(file_path: str, project: str = None) -> int:
+    """CLI entry point for meshcode upload <file>."""
+    from meshcode.meshcode_mcp import backend as be
+
+    api_key = None
+    # Try to get API key from environment or config
+    env_key = os.environ.get("MESHCODE_API_KEY")
+    if env_key:
+        api_key = env_key
+    else:
+        # Try keychain profile
+        try:
+            profile_path = Path.home() / ".meshcode" / "profile_meta.json"
+            if profile_path.exists():
+                meta = json.loads(profile_path.read_text())
+                api_key = meta.get("api_key")
+        except Exception:
+            pass
+
+    if not api_key:
+        print("[meshcode upload] ERROR: No API key. Set MESHCODE_API_KEY or run meshcode login.")
+        return 1
+
+    print(f"[meshcode upload] Uploading {file_path}...")
+    result = upload_file(
+        file_path=file_path,
+        api_key=api_key,
+        supabase_url=be.SUPABASE_URL,
+        supabase_key=be.SUPABASE_KEY,
+    )
+
+    if result.get("ok"):
+        print(f"[meshcode upload] Success!")
+        print(f"  file_id:   {result['file_id']}")
+        print(f"  file_name: {result['file_name']}")
+        print(f"  size:      {result['size_bytes']} bytes")
+        print(f"  path:      {result['storage_path']}")
+        return 0
+    else:
+        print(f"[meshcode upload] ERROR: {result.get('error', 'unknown error')}")
+        return 1

{meshcode-2.10.59 → meshcode-2.10.61}/meshcode.egg-info/PKG-INFO

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

{meshcode-2.10.59 → meshcode-2.10.61}/meshcode.egg-info/SOURCES.txt

@@ -5,6 +5,7 @@ meshcode/ascii_art.py
 meshcode/cli.py
 meshcode/comms_v4.py
 meshcode/compat.py
+meshcode/error_hints.py
 meshcode/exceptions.py
 meshcode/invites.py
 meshcode/launcher.py
@@ -16,6 +17,7 @@ meshcode/secrets.py
 meshcode/self_update.py
 meshcode/setup_clients.py
 meshcode/supervisor.py
+meshcode/upload.py
 meshcode.egg-info/PKG-INFO
 meshcode.egg-info/SOURCES.txt
 meshcode.egg-info/dependency_links.txt

{meshcode-2.10.59 → meshcode-2.10.61}/pyproject.toml

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