meshcode 2.11.135__tar.gz → 2.11.137__tar.gz

{meshcode-2.11.135 → meshcode-2.11.137}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: meshcode
-Version: 2.11.135
+Version: 2.11.137
 Summary: Real-time communication between AI agents — Supabase-backed CLI
 Author-email: MeshCode <hello@meshcode.io>
 License: MIT
@@ -18,17 +18,8 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Operating System :: OS Independent
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
-Requires-Dist: mcp[cli]>=1.0.0
-Requires-Dist: websockets>=12.0
-Requires-Dist: realtime>=2.0.0
-Requires-Dist: keyring>=24.0
-Requires-Dist: cryptography>=41.0
 Provides-Extra: test
-Requires-Dist: pytest>=8; extra == "test"
 Provides-Extra: dev
-Requires-Dist: build>=1.0; extra == "dev"
-Requires-Dist: twine>=4; extra == "dev"
-Requires-Dist: pytest>=8; extra == "dev"
 
 # MeshCode
 

{meshcode-2.11.135 → meshcode-2.11.137}/meshcode/__init__.py

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

meshcode-2.11.137/meshcode/helper_visuals.py

@@ -0,0 +1,142 @@
+"""Helper terminal visuals (task d8f8e325 — Samuel msgs edf0ed8d + 68c7fee0).
+
+ENJAMBRE helpers must open VISUALLY DISTINCT from top-level agents on every
+platform, so a wall of fleet tabs reads instantly: amber = ephemeral helper,
+normal = real agent. Two layers (both silent-degrade — a visuals failure must
+NEVER break a spawn):
+
+  [1] UNIVERSAL — `meshcode run` emits OSC 0/2 (title "helper:<name>") +
+      OSC 11 (dark-amber background) at session start. Works in Windows
+      Terminal, iTerm2 and most xterm-compatible Linux terminals regardless
+      of which launcher opened the window; terminals that ignore OSC 11
+      (e.g. macOS Terminal.app) still get the title.
+  [2] PER-PLATFORM at spawn — Windows Terminal gets `--tabColor <amber>` +
+      `--title helper:<name>` on the fleet tab; the Linux/macOS launcher
+      scripts prepend the same OSC prelude so the tint applies even before
+      `meshcode run` boots.
+
+HOW A SPAWNER KNOWS IT'S A HELPER (no agent_kind in the spawn payloads —
+probed live 2026-06-12: mc_agents_needing_respawn candidates and
+mc_host_config_get agents carry no kind field):
+
+  - MARKER FILE: swarm.spawn_helper() runs on the PARENT's host, which is the
+    same host the helper spawns on (W5: helper row inherits the parent's
+    host/repo). It stamps ~/.meshcode/helpers/<name>.json with the helper's
+    TTL; spawners treat a FRESH marker as "helper". TTL expiry is the
+    cleanup (helpers are ephemeral by contract, TTL <= 86400).
+  - NAME PREFIX fallback: a name starting with 'helper' counts even without
+    a marker (covers cross-host edge cases + the observed naming convention).
+
+Tradeoff (documented): a top-level agent that shares a helper's bare name on
+the same host within the marker TTL would render amber — cosmetic only, and
+name collisions are already rejected server-side within a meshwork.
+"""
+from __future__ import annotations
+
+import json
+import re
+import sys
+import time
+from pathlib import Path
+
+# Spec colors (task d8f8e325): amber tab; dark-amber background tint that
+# keeps default light-on-dark text readable.
+HELPER_TAB_COLOR = "#E8A33D"
+HELPER_BG_COLOR = "#3A2310"
+HELPER_TITLE_PREFIX = "helper:"
+
+_MARKER_TTL_CAP_S = 86400  # mirror of the server-side helper TTL ceiling
+
+
+def _helpers_dir() -> Path:
+    """Marker directory, behind a function so tests can patch it."""
+    return Path.home() / ".meshcode" / "helpers"
+
+
+def _safe_name(name: str) -> str:
+    return re.sub(r"[^A-Za-z0-9_.-]", "_", (name or "").strip()).strip("_")[:80]
+
+
+def mark_helper(name: str, ttl_seconds: int = 3600) -> None:
+    """Stamp <name> as a helper on THIS host (called by swarm.spawn_helper).
+    Best-effort: never raises. Opportunistically prunes expired markers."""
+    try:
+        safe = _safe_name(name)
+        if not safe:
+            return
+        d = _helpers_dir()
+        d.mkdir(parents=True, exist_ok=True)
+        ttl = max(60, min(int(ttl_seconds or 3600), _MARKER_TTL_CAP_S))
+        (d / f"{safe}.json").write_text(
+            json.dumps({"name": name, "expires_at": time.time() + ttl}),
+            encoding="utf-8")
+        for p in d.glob("*.json"):
+            try:
+                if float(json.loads(p.read_text(encoding="utf-8"))
+                         .get("expires_at", 0)) < time.time():
+                    p.unlink()
+            except Exception:
+                continue
+    except Exception:
+        pass
+
+
+def unmark_helper(name: str) -> None:
+    """Drop the marker (helper retired). Best-effort."""
+    try:
+        safe = _safe_name(name)
+        if safe:
+            (_helpers_dir() / f"{safe}.json").unlink(missing_ok=True)
+    except Exception:
+        pass
+
+
+def is_helper(target: str) -> bool:
+    """True when `target` (bare 'name' or 'project/name') is a swarm helper:
+    fresh marker on this host OR the 'helper' name prefix. Never raises."""
+    try:
+        agent = (target or "").rsplit("/", 1)[-1].strip()
+        if not agent:
+            return False
+        if agent.lower().startswith("helper"):
+            return True
+        p = _helpers_dir() / f"{_safe_name(agent)}.json"
+        if not p.exists():
+            return False
+        data = json.loads(p.read_text(encoding="utf-8"))
+        return float(data.get("expires_at", 0)) >= time.time()
+    except Exception:
+        return False
+
+
+def helper_title(target: str) -> str:
+    """Tab/window title for a helper: 'helper:<bare name>' (sanitized)."""
+    agent = _safe_name((target or "").rsplit("/", 1)[-1])
+    return f"{HELPER_TITLE_PREFIX}{agent or 'agent'}"[:48]
+
+
+def osc_prelude(target: str) -> str:
+    """Escape string: OSC 0 title + OSC 11 background. Terminals that don't
+    support either sequence ignore it (that IS the degradation path)."""
+    return (f"\x1b]0;{helper_title(target)}\x07"
+            f"\x1b]11;{HELPER_BG_COLOR}\x07")
+
+
+def osc_prelude_shell(target: str) -> str:
+    """The same prelude as a POSIX-shell `printf` command (for launcher
+    scripts / bash -lc command strings). Title is sanitized [A-Za-z0-9_.-:]
+    so it can never break out of the single quotes."""
+    return ("printf '\\033]0;%s\\007\\033]11;%s\\007' 2>/dev/null || true"
+            % (helper_title(target), HELPER_BG_COLOR))
+
+
+def emit_osc(target: str) -> None:
+    """Universal layer: write the prelude to the live terminal from
+    `meshcode run`. Best-effort, TTY-gated (a piped/CI stdout never sees
+    escape garbage)."""
+    try:
+        if sys.stdout.isatty():
+            sys.stdout.write(osc_prelude(target))
+            sys.stdout.flush()
+    except Exception:
+        pass