meshcode 2.11.86__tar.gz → 2.11.87__tar.gz

{meshcode-2.11.86 → meshcode-2.11.87}/PKG-INFO

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

{meshcode-2.11.86 → meshcode-2.11.87}/meshcode/__init__.py

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

{meshcode-2.11.86 → meshcode-2.11.87}/meshcode/_session_handoff_template.py

@@ -113,6 +113,54 @@ def _extract_tail(transcript_path: str):
     return rows[-MAX_TURNS:]
 
 
+def _request_recycle_if_marked(project_dir) -> None:
+    """CTX-CLOSE-RELAUNCH (task 400fc536): commander-tier sessions ask the
+    server to recycle (close+relaunch fresh) at the next task-edge, right after
+    the handoff is snapshotted. Gated by the scaffold-baked
+    .claude/meshcode_hook_ctx.json recycle_on_compact flag (commander-only v1).
+
+    Best-effort in every dimension: missing marker/flag, missing creds, import
+    failure, network error -> silently skip. handoff.json is already written, so
+    a context-recycle still relaunches WITH context; and the actual exit is the
+    server's call (mc_consume_recycle at a task boundary), never this hook.
+    """
+    try:
+        ctx_path = project_dir / ".claude" / "meshcode_hook_ctx.json"
+        if not ctx_path.exists():
+            return
+        if not json.loads(ctx_path.read_text(encoding="utf-8")).get("recycle_on_compact"):
+            return  # non-commander -> in-place autocompact, no recycle
+        mcp = json.loads((project_dir / ".mcp.json").read_text(encoding="utf-8"))
+        env = (next(iter((mcp.get("mcpServers") or {}).values()), {}) or {}).get("env", {}) or {}
+        url = env.get("SUPABASE_URL"); key = env.get("SUPABASE_KEY")
+        pid = env.get("MESHCODE_PROJECT_ID"); agent = env.get("MESHCODE_AGENT")
+        if not (url and key and pid and agent):
+            return
+        api_key = os.environ.get("MESHCODE_API_KEY")
+        if not api_key:
+            try:
+                import importlib
+                api_key = importlib.import_module("meshcode.secrets").get_api_key(
+                    profile=env.get("MESHCODE_KEYCHAIN_PROFILE") or "default")
+            except Exception:
+                api_key = None
+        if not api_key:
+            return
+        import urllib.request as _u
+        body = json.dumps({
+            "p_api_key": api_key, "p_project_id": pid,
+            "p_agent_name": agent, "p_allow_busy": True,  # flag-now; exit deferred to wait-loop
+        }).encode("utf-8")
+        req = _u.Request(
+            url.rstrip("/") + "/rest/v1/rpc/mc_request_recycle",
+            data=body, method="POST",
+            headers={"apikey": key, "Authorization": "Bearer " + key,
+                     "Content-Type": "application/json"})
+        _u.urlopen(req, timeout=5).read()  # best-effort; ignore result per backend contract
+    except Exception as e:  # noqa: BLE001 — never block compaction
+        sys.stderr.write(f"[session_handoff_write] recycle-request skipped: {e}\\n")
+
+
 def main() -> int:
     try:
         raw = sys.stdin.read()
@@ -137,6 +185,9 @@ def main() -> int:
         tmp.replace(d / "handoff.json")
     except OSError as e:
         sys.stderr.write(f"[session_handoff_write] skipped: {e}\\n")
+    # CTX-CLOSE-RELAUNCH (task 400fc536): now that the thread is snapshotted,
+    # commander-tier sessions ask the server to recycle at the next task-edge.
+    _request_recycle_if_marked(_project_dir())
     return 0
 
 

{meshcode-2.11.86 → meshcode-2.11.87}/meshcode/setup_clients.py

@@ -288,6 +288,49 @@ def _stop_hook_command() -> str:
     return _hook_command("stay_on_loop.py")
 
 
+# Mirror of server.py _LEADER_KEYWORDS / _is_leader_agent — the canonical
+# agent-side commander/leader signal. Kept in sync intentionally (small, stable).
+_LEADER_KEYWORDS = (
+    'commander', 'lead', 'orchestrat', 'coordinator', 'coordinat',
+    'coordinad', 'jefe', 'líder', 'lider', 'director', 'manager',
+    'chief', 'captain', 'boss', 'head agent',
+)
+
+
+def _is_commander_role(name: str, role: str = "") -> bool:
+    """True if this agent is commander/leader tier (name+role keyword match).
+
+    CTX-CLOSE-RELAUNCH (task 400fc536): the PreCompact handoff hook self-requests
+    a context-recycle ONLY for commander-tier sessions (v1 = commander-only).
+    The hook subprocess cannot import server.py's _is_leader_agent (its module
+    globals aren't set there), so we BAKE this decision into the workspace at
+    scaffold time (commander directive) using the SAME heuristic the SDK already
+    uses everywhere for leader detection. This is a client-side BEHAVIOUR gate,
+    not authorization — the server's owner check in mc_request_recycle is the
+    real security boundary — so the name/role heuristic is safe here.
+    """
+    hay = ((name or "") + " " + (role or "")).lower()
+    return any(k in hay for k in _LEADER_KEYWORDS)
+
+
+def _write_hook_ctx_marker(ws: Path, is_commander: bool, agent: str = "", project: str = "") -> None:
+    """Write .claude/meshcode_hook_ctx.json — the scaffold-baked signal the
+    PreCompact handoff hook reads to decide whether to self-request a
+    context-recycle (CTX-CLOSE-RELAUNCH). Best-effort."""
+    try:
+        (ws / ".claude").mkdir(parents=True, exist_ok=True)
+        (ws / ".claude" / "meshcode_hook_ctx.json").write_text(
+            json.dumps({
+                "recycle_on_compact": bool(is_commander),
+                "agent": agent,
+                "project": project,
+            }, indent=2) + "\n",
+            encoding="utf-8",
+        )
+    except Exception as _e:  # noqa: BLE001 — never block scaffold on this marker
+        print(f"[meshcode] WARNING: could not write hook ctx marker: {_e}", file=sys.stderr)
+
+
 # The meshcode hooks (event -> hook-script filename). Each is matched in
 # settings.json by its script filename so the heal touches ONLY meshcode's own
 # hooks and never a user-added hook on the same event.
@@ -1487,6 +1530,10 @@ Call `meshcode_wait` now.
             except OSError:
                 pass
         (ws / ".claude" / "settings.json").write_text(settings_body, encoding="utf-8")
+        # CTX-CLOSE-RELAUNCH (task 400fc536): bake the commander-tier signal the
+        # PreCompact handoff hook reads to decide whether to self-request a
+        # context-recycle (commander-only v1).
+        _write_hook_ctx_marker(ws, _is_commander_role(agent, role), agent=agent, project=project)
     except Exception as _e:
         print(f"[meshcode] WARNING: could not write /meshcode-wait command + hooks: {_e}", file=sys.stderr)
 
@@ -1749,7 +1796,25 @@ def patch_hooks(dry_run: bool = False) -> int:
         except Exception as e:  # noqa: BLE001 — never let one ws abort the sweep
             settings_changed, settings_note = False, f"settings heal failed: {e}"
 
-        record = f"{ws.name} ({body_note}; {settings_note})"
+        # CTX-CLOSE-RELAUNCH (task 400fc536): backfill the commander-tier marker
+        # the PreCompact hook reads. Recompute is_commander from the workspace's
+        # baked .mcp.json (MESHCODE_AGENT + MESHCODE_ROLE) so existing commanders
+        # get the recycle trigger without a full re-scaffold.
+        marker_note = "marker skipped"
+        if not dry_run:
+            try:
+                mcp = json.loads((ws / ".mcp.json").read_text(encoding="utf-8"))
+                env = (next(iter((mcp.get("mcpServers") or {}).values()), {}) or {}).get("env", {}) or {}
+                _agent = env.get("MESHCODE_AGENT") or ws.name
+                _role = env.get("MESHCODE_ROLE") or ""
+                _write_hook_ctx_marker(ws, _is_commander_role(_agent, _role), agent=_agent, project=env.get("MESHCODE_PROJECT") or "")
+                marker_note = "marker written"
+            except Exception as e:  # noqa: BLE001
+                marker_note = f"marker skipped ({e})"
+        else:
+            marker_note = "marker would write"
+
+        record = f"{ws.name} ({body_note}; {settings_note}; {marker_note})"
         (patched if (body_changed or settings_changed) else skipped).append(record)
 
     verb = "would patch" if dry_run else "patched"

{meshcode-2.11.86 → meshcode-2.11.87}/meshcode.egg-info/PKG-INFO

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

{meshcode-2.11.86 → meshcode-2.11.87}/pyproject.toml

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