meshcode 2.11.7__tar.gz → 2.11.8__tar.gz

{meshcode-2.11.7 → meshcode-2.11.8}/PKG-INFO

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

meshcode-2.11.8/meshcode/__init__.py

@@ -0,0 +1,90 @@
+"""MeshCode — Real-time communication between AI agents."""
+__version__ = "2.11.8"
+
+# 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",
+    # Epistemic v1
+    "decide",
+    "outcome",
+    "explain",
+}
+
+# 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",
+    # Epistemic v1
+    "decide",
+    "outcome",
+    "explain",
+    # Encryption
+    "encrypt_payload",
+    "decrypt_payload",
+    # Credentials
+    "get_api_key",
+    "set_api_key",
+    "list_profiles",
+]

{meshcode-2.11.7 → meshcode-2.11.8}/meshcode/meshcode_mcp/backend.py

@@ -1132,7 +1132,7 @@ def get_board(project_id: str, api_key: Optional[str] = None) -> List[Dict]:
             "p_api_key": _ak,
             "p_project_id": project_id,
             "p_agent_name": None,
-            "p_select": ["name", "role", "status", "task", "last_heartbeat", "registered_at"],
+            "p_select": ["name", "role", "status", "task", "last_heartbeat", "last_response_at", "registered_at"],
             "p_limit": None,
         })
         if isinstance(_res, dict) and _res.get("ok"):
@@ -1140,7 +1140,7 @@ def get_board(project_id: str, api_key: Optional[str] = None) -> List[Dict]:
     # Fallback: direct SELECT (gradual rollout)
     return sb_select(
         "mc_agents",
-        f"project_id=eq.{project_id}&select=name,role,status,task,last_heartbeat,registered_at",
+        f"project_id=eq.{project_id}&select=name,role,status,task,last_heartbeat,last_response_at,registered_at",
         order="registered_at.asc",
     )
 
@@ -1340,6 +1340,112 @@ def get_message_by_id(project_id: str, msg_id: str, api_key: Optional[str] = Non
     return results[0] if results else None
 
 
+# ============================================================
+# EPISTEMIC V1: decide / outcome / explain — Python-embedded API.
+# Mirrors the MCP tools meshcode_decide/_outcome/_explain (server.py 5094-5184).
+# RPCs: public.mc_decide / mc_outcome / mc_explain (mig 314 wrappers around
+# meshcode.* SECDEF implementations). Use when integrating MeshCode into a
+# Python application directly (no MCP layer).
+# ============================================================
+
+def decide(
+    project_id: str,
+    agent_name: str,
+    decision: str,
+    alternatives: Optional[List[str]] = None,
+    evidence_refs: Optional[List[Dict[str, Any]]] = None,
+    tier: str = "episodic",
+    api_key: Optional[str] = None,
+) -> Dict[str, Any]:
+    """Log a non-trivial decision to mc_traces. Returns {trace_id}.
+
+    Pair with outcome() later when the result becomes observable.
+
+    Args:
+        project_id: UUID of the project.
+        agent_name: Name of the agent making the decision.
+        decision: What was decided (one sentence).
+        alternatives: Other options considered (list of strings).
+        evidence_refs: Evidence pointers (list of {type, id|key} dicts);
+            type values: 'memory','msg','task','file','rpc'.
+        tier: 'episodic' (default) | 'reference' | 'critical'.
+        api_key: Required for the SECDEF RPC. Falls back to env via _get_api_key().
+    """
+    if not decision or not decision.strip():
+        return {"ok": False, "error": "decision required"}
+    return sb_rpc("mc_decide", {
+        "p_api_key": api_key or _get_api_key(),
+        "p_project_id": project_id,
+        "p_agent_name": agent_name,
+        "p_decision": decision.strip(),
+        "p_alternatives": json.dumps(alternatives or []),
+        "p_evidence_refs": json.dumps(evidence_refs or []),
+        "p_tier": tier,
+    })
+
+
+def outcome(
+    project_id: str,
+    agent_name: str,
+    trace_id: str,
+    outcome: str,
+    outcome_eval: str,
+    api_key: Optional[str] = None,
+) -> Dict[str, Any]:
+    """Record the observable outcome of a prior decision().
+
+    Args:
+        project_id: UUID of the project.
+        agent_name: Name of the agent recording the outcome.
+        trace_id: UUID returned by decide().
+        outcome: Free-form description of what happened.
+        outcome_eval: 'success' | 'failure' | 'partial' | 'unknown'.
+        api_key: Required for the SECDEF RPC. Falls back to env.
+    """
+    if outcome_eval not in ("success", "failure", "partial", "unknown"):
+        return {"ok": False, "error": "outcome_eval must be success|failure|partial|unknown"}
+    return sb_rpc("mc_outcome", {
+        "p_api_key": api_key or _get_api_key(),
+        "p_project_id": project_id,
+        "p_agent_name": agent_name,
+        "p_trace_id": trace_id,
+        "p_outcome": outcome,
+        "p_outcome_eval": outcome_eval,
+    })
+
+
+def explain(
+    project_id: str,
+    agent_name: str,
+    memory_key: Optional[str] = None,
+    decision_substring: Optional[str] = None,
+    trace_limit: int = 20,
+    api_key: Optional[str] = None,
+) -> Dict[str, Any]:
+    """Surface recent traces + open contradictions tied to a memory key or
+    decision substring. Exactly one of (memory_key, decision_substring) is
+    required.
+
+    Args:
+        project_id: UUID of the project.
+        agent_name: Name of the agent asking.
+        memory_key: Match traces whose evidence_refs reference this key.
+        decision_substring: ILIKE match against the decision text.
+        trace_limit: Cap on returned traces (1..200, default 20).
+        api_key: Required for the SECDEF RPC. Falls back to env.
+    """
+    if not memory_key and not decision_substring:
+        return {"ok": False, "error": "one of (memory_key, decision_substring) required"}
+    return sb_rpc("mc_explain", {
+        "p_api_key": api_key or _get_api_key(),
+        "p_project_id": project_id,
+        "p_agent_name": agent_name,
+        "p_memory_key": memory_key,
+        "p_decision_substring": decision_substring,
+        "p_trace_limit": trace_limit,
+    })
+
+
 # ============================================================
 # Convenience class so `from meshcode.meshcode_mcp.backend import MeshCodeBackend`
 # works for users who expect a class-based API (e.g. Windows onboarding docs).
@@ -1370,3 +1476,6 @@ class MeshCodeBackend:
     sb_select = staticmethod(sb_select)
     sb_insert = staticmethod(sb_insert)
     sb_update = staticmethod(sb_update)
+    decide = staticmethod(decide)
+    outcome = staticmethod(outcome)
+    explain = staticmethod(explain)