meshcode 2.10.89__tar.gz → 2.10.91__tar.gz

{meshcode-2.10.89 → meshcode-2.10.91}/PKG-INFO

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

meshcode-2.10.91/meshcode/__init__.py

@@ -0,0 +1,82 @@
+"""MeshCode — Real-time communication between AI agents."""
+__version__ = "2.10.91"
+
+# Exception hierarchy — eagerly imported (lightweight, no deps)
+from meshcode.exceptions import (  # noqa: F401
+    MeshCodeError,
+    AuthError,
+    RPCError,
+    MeshCodeTimeoutError,
+    MeshCodeConnectionError,
+)
+
+# Public API — lazy imports to avoid heavy deps at import time
+def __getattr__(name):
+    if name == "backend":
+        from meshcode.meshcode_mcp import backend
+        return backend
+    if name in _BACKEND_EXPORTS:
+        from meshcode.meshcode_mcp import backend
+        return getattr(backend, name)
+    if name in _SECRETS_EXPORTS:
+        from meshcode import secrets
+        return getattr(secrets, name)
+    raise AttributeError(f"module 'meshcode' has no attribute {name!r}")
+
+
+# Backend: core messaging & agent management
+_BACKEND_EXPORTS = {
+    "send_message",
+    "read_inbox",
+    "count_pending",
+    "get_board",
+    "heartbeat",
+    "set_status",
+    "register_agent",
+    "get_project_id",
+    "sb_rpc",
+    "task_create",
+    "task_list",
+    "encrypt_payload",
+    "decrypt_payload",
+}
+
+# Secrets: credential management
+_SECRETS_EXPORTS = {
+    "get_api_key",
+    "set_api_key",
+    "list_profiles",
+}
+
+__all__ = [
+    "__version__",
+    "backend",
+    # Exceptions
+    "MeshCodeError",
+    "AuthError",
+    "RPCError",
+    "MeshCodeTimeoutError",
+    "MeshCodeConnectionError",
+    # Messaging
+    "send_message",
+    "read_inbox",
+    "count_pending",
+    # Agent management
+    "register_agent",
+    "get_project_id",
+    "get_board",
+    "heartbeat",
+    "set_status",
+    # Tasks
+    "task_create",
+    "task_list",
+    # Low-level
+    "sb_rpc",
+    # Encryption
+    "encrypt_payload",
+    "decrypt_payload",
+    # Credentials
+    "get_api_key",
+    "set_api_key",
+    "list_profiles",
+]

{meshcode-2.10.89 → meshcode-2.10.91}/meshcode/meshcode_mcp/server.py

@@ -731,6 +731,19 @@ def with_working_status(func):
                 # Auto-log to activity feed (skip noisy read-only tools)
                 if not skip and name not in _ACTIVITY_LOG_SKIP:
                     _log_activity_bg("tool_call", f"{AGENT_NAME}: {name}")
+                # Persona hint injection (BE-S4.1.sdk): once per session.
+                global _PERSONA_INJECTED
+                if (not skip and not _PERSONA_INJECTED and _PERSONA
+                        and isinstance(result, dict)):
+                    _hint_fields = {
+                        k: _PERSONA[k]
+                        for k in ("tone", "language", "reply_max_tokens",
+                                  "emoji_policy", "decision_style")
+                        if k in _PERSONA and _PERSONA[k] is not None
+                    }
+                    if _hint_fields:
+                        result.setdefault("persona_hint", _hint_fields)
+                        _PERSONA_INJECTED = True
                 return result
             except asyncio.CancelledError:
                 log.debug(f"[meshcode] tool {name} cancelled by client (ESC)")
@@ -759,6 +772,22 @@ def with_working_status(func):
                 result = func(*args, **kwargs)
                 if not skip and name not in _ACTIVITY_LOG_SKIP:
                     _log_activity_bg("tool_call", f"{AGENT_NAME}: {name}")
+                # Persona hint injection (BE-S4.1.sdk): on the FIRST non-wait
+                # tool call after boot, attach a persona_hint envelope so the
+                # LLM stays in voice. Only once per session — agents are
+                # supposed to internalize tone after seeing it once.
+                global _PERSONA_INJECTED
+                if (not skip and not _PERSONA_INJECTED and _PERSONA
+                        and isinstance(result, dict)):
+                    _hint_fields = {
+                        k: _PERSONA[k]
+                        for k in ("tone", "language", "reply_max_tokens",
+                                  "emoji_policy", "decision_style")
+                        if k in _PERSONA and _PERSONA[k] is not None
+                    }
+                    if _hint_fields:
+                        result.setdefault("persona_hint", _hint_fields)
+                        _PERSONA_INJECTED = True
                 return result
             except Exception as e:
                 if not skip:
@@ -790,6 +819,11 @@ _BOOT_PPID = os.getppid()
 _BOOT_CONTEXT_BUNDLE: Optional[Dict[str, Any]] = None
 _BOOT_CONTEXT_AT: float = 0.0
 _BOOT_CONTEXT_TTL_SECONDS: float = 30.0
+# Per-agent persona JSONB (mig 232) cached at lifespan start. Drives tone /
+# voice / reply length on first tool call after boot. TTL infinite within a
+# session — persona changes are rare and need a relaunch to take effect.
+_PERSONA: Optional[Dict[str, Any]] = None
+_PERSONA_INJECTED: bool = False
 
 def _acquire_lease() -> bool:
     api_key = _get_api_key()
@@ -1640,6 +1674,28 @@ async def lifespan(_app):
             log.warning(f"initial heartbeat attempt {_attempt+1} failed: {e}")
             import time; time.sleep(2)
 
+    # Per-agent persona (BE-S4.1.sdk / mig 232): tone/voice/policy that
+    # shapes how the agent talks. Loaded once per session; soft-fail if the
+    # RPC is unavailable on older projects.
+    global _PERSONA
+    try:
+        _persona_resp = be.sb_rpc("mc_agent_persona", {
+            "p_api_key": _get_api_key(),
+            "p_project_id": _PROJECT_ID,
+            "p_agent_name": AGENT_NAME,
+        })
+        if isinstance(_persona_resp, dict) and _persona_resp.get("ok"):
+            _PERSONA = _persona_resp.get("persona") or {}
+            log.info(
+                f"[meshcode] persona loaded: tone={_PERSONA.get('tone','default')} "
+                f"language={_PERSONA.get('language','en')} "
+                f"reply_max_tokens={_PERSONA.get('reply_max_tokens','unset')}"
+            )
+        else:
+            log.debug(f"persona load returned non-ok: {_persona_resp} — continuing without")
+    except Exception as e:
+        log.debug(f"persona RPC unavailable ({e}) — continuing without")
+
     # Boot-context bundle (S1-2.F2 / mig 217): single RPC returns last_seen
     # + recent msgs + open tasks + relevant memories + peer state. Cached on
     # the module global so the first ~30s of tool calls can short-circuit.
@@ -1786,8 +1842,16 @@ async def meshcode_debug_sleep(seconds: int = 30) -> Dict[str, Any]:
 @mcp.tool()
 @with_working_status
 def meshcode_send(to: str, message: Any, in_reply_to: Optional[str] = None,
-                  sensitive: bool = False, encrypted: bool = False) -> Dict[str, Any]:
-    """Send message. Use "agent@meshwork" for cross-mesh. sensitive=True hides from exports. Pass encrypted=True for secrets/credentials (AES-256-GCM)."""
+                  sensitive: bool = False, encrypted: bool = False,
+                  type: Optional[str] = None) -> Dict[str, Any]:
+    """Send message. Use "agent@meshwork" for cross-mesh. sensitive=True hides from exports. Pass encrypted=True for secrets/credentials (AES-256-GCM).
+
+    Optional `type` argument (mig 233 typed catalog): one of report, ask,
+    proposal, status, blocker, decision, broadcast, ack, msg, dm, etc.
+    When passed, the SDK soft-validates the payload against the schema
+    in mc_message_schema(p_type) and logs a warning on mismatch — never
+    refuses the send (per memory feedback_meshcode_wait_mark_read).
+    """
     if not to or not to.strip():
         return {"error": "recipient 'to' cannot be empty"}
     to = to.strip()
@@ -1816,6 +1880,26 @@ def meshcode_send(to: str, message: Any, in_reply_to: Optional[str] = None,
     if _payload_len > 2000:
         return {"error": f"message too large ({_payload_len} chars). Use meshcode_task_create for long content. Messages must be structured JSON <2000 chars."}
 
+    # Typed-catalog soft validation (BE-S4.2.sdk / mig 233): if caller
+    # passes type=, fetch the schema and check required fields. NEVER
+    # refuses the send — best-effort warn-only. Skips when no type given,
+    # when schema fetch fails, or when the type is unknown.
+    if type:
+        try:
+            _schema_resp = be.sb_rpc("mc_message_schema", {"p_type": type})
+            if isinstance(_schema_resp, dict) and _schema_resp.get("ok"):
+                _schema = _schema_resp.get("schema") or {}
+                _required = (_schema.get("required") or []) if isinstance(_schema, dict) else []
+                _missing = [k for k in _required if k not in payload]
+                if _missing:
+                    log.warning(
+                        f"meshcode_send type={type!r} payload missing required "
+                        f"fields {_missing} per mc_message_schema. Sending anyway "
+                        f"(soft validation)."
+                    )
+        except Exception as _vex:
+            log.debug(f"type-schema validation skipped: {_vex}")
+
     # Cross-mesh routing: if 'to' contains '@', parse as agent@meshwork
     if "@" in to:
         target_agent, target_meshwork = to.split("@", 1)
@@ -1848,13 +1932,14 @@ def meshcode_send(to: str, message: Any, in_reply_to: Optional[str] = None,
             "p_to_project": target_meshwork,
             "p_to_agent": target_agent,
             "p_payload": payload,
-            "p_type": "msg",
+            "p_type": type or "msg",
         })
         if isinstance(result, dict) and result.get("ok") and encrypted:
             result["encrypted"] = True
         return result
 
-    return be.send_message(_PROJECT_ID, AGENT_NAME, to, payload, msg_type="msg",
+    return be.send_message(_PROJECT_ID, AGENT_NAME, to, payload,
+                           msg_type=type or "msg",
                            parent_msg_id=in_reply_to, sensitive=sensitive,
                            api_key=_get_api_key(), encrypted=encrypted)
 

{meshcode-2.10.89 → meshcode-2.10.91}/meshcode.egg-info/PKG-INFO

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

{meshcode-2.10.89 → meshcode-2.10.91}/pyproject.toml

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

meshcode-2.10.89/meshcode/__init__.py

@@ -1,82 +0,0 @@
-"""MeshCode — Real-time communication between AI agents."""
-__version__ = "2.10.89"
-
-# Exception hierarchy — eagerly imported (lightweight, no deps)
-from meshcode.exceptions import (  # noqa: F401
-    MeshCodeError,
-    AuthError,
-    RPCError,
-    MeshCodeTimeoutError,
-    MeshCodeConnectionError,
-)
-
-# Public API — lazy imports to avoid heavy deps at import time
-def __getattr__(name):
-    if name == "backend":
-        from meshcode.meshcode_mcp import backend
-        return backend
-    if name in _BACKEND_EXPORTS:
-        from meshcode.meshcode_mcp import backend
-        return getattr(backend, name)
-    if name in _SECRETS_EXPORTS:
-        from meshcode import secrets
-        return getattr(secrets, name)
-    raise AttributeError(f"module 'meshcode' has no attribute {name!r}")
-
-
-# Backend: core messaging & agent management
-_BACKEND_EXPORTS = {
-    "send_message",
-    "read_inbox",
-    "count_pending",
-    "get_board",
-    "heartbeat",
-    "set_status",
-    "register_agent",
-    "get_project_id",
-    "sb_rpc",
-    "task_create",
-    "task_list",
-    "encrypt_payload",
-    "decrypt_payload",
-}
-
-# Secrets: credential management
-_SECRETS_EXPORTS = {
-    "get_api_key",
-    "set_api_key",
-    "list_profiles",
-}
-
-__all__ = [
-    "__version__",
-    "backend",
-    # Exceptions
-    "MeshCodeError",
-    "AuthError",
-    "RPCError",
-    "MeshCodeTimeoutError",
-    "MeshCodeConnectionError",
-    # Messaging
-    "send_message",
-    "read_inbox",
-    "count_pending",
-    # Agent management
-    "register_agent",
-    "get_project_id",
-    "get_board",
-    "heartbeat",
-    "set_status",
-    # Tasks
-    "task_create",
-    "task_list",
-    # Low-level
-    "sb_rpc",
-    # Encryption
-    "encrypt_payload",
-    "decrypt_payload",
-    # Credentials
-    "get_api_key",
-    "set_api_key",
-    "list_profiles",
-]