Feat: Add federation_read + federation_inbox tools so Council can open the gift

app.py

@@ -130,6 +130,18 @@ class VerifySealInput(BaseModel):
         examples=["⟦ NODE :: PANTHEON-HF :: 🜁-20260319-5FCY-PCCP :: ACTIVE ⟧"]
     )
 
+class ReadEnvelopeInput(BaseModel):
+    model_config = {"extra": "forbid"}
+    envelope_id: str = Field(
+        description="Full UUID of the envelope to read.",
+        examples=["5672f981-8d38-48df-8f0c-42a4672bd940"]
+    )
+
+class InboxInput(BaseModel):
+    model_config = {"extra": "forbid"}
+    limit: int = Field(default=20, ge=1, le=100, description="Max envelopes to return.")
+    status: Optional[str] = Field(default=None, description="Filter by status: QUEUED, QUARANTINED, etc.")
+
 # ═══════════════════════════════════════════════
 # TOOLS
 # ═══════════════════════════════════════════════
@@ -240,6 +252,46 @@ async def federation_verify_seal(input_data: VerifySealInput) -> str:
         return node_error(e)
 
 
+@mcp.tool(
+    name="federation_read",
+    description=(
+        "Read the full contents of a specific envelope by ID.\n\n"
+        "**When to use:** When you have an envelope_id (from federation_send or federation_inbox) "
+        "and want to read the full payload including the message body.\n\n"
+        "**Returns:** Full envelope record including sender, payload body, and delivery metadata."
+    ),
+    annotations={"readOnlyHint": True, "destructiveHint": False}
+)
+async def federation_read(input_data: ReadEnvelopeInput) -> str:
+    try:
+        result = await call_node("GET", f"/envelope/{input_data.envelope_id}/read")
+        return json.dumps(result, indent=2)
+    except Exception as e:
+        return node_error(e)
+
+
+@mcp.tool(
+    name="federation_inbox",
+    description=(
+        "Browse the Embassy inbox — list recent envelopes with previews.\n\n"
+        "**When to use:** To see what messages have arrived at the node. "
+        "Returns envelope IDs, senders, classes, and a payload preview. "
+        "Use federation_read with the envelope_id to read the full message.\n\n"
+        "**Returns:** List of envelopes, most recent first."
+    ),
+    annotations={"readOnlyHint": True, "destructiveHint": False}
+)
+async def federation_inbox(input_data: InboxInput) -> str:
+    try:
+        params = f"?limit={input_data.limit}"
+        if input_data.status:
+            params += f"&status={input_data.status}"
+        result = await call_node("GET", f"/inbox{params}")
+        return json.dumps(result, indent=2)
+    except Exception as e:
+        return node_error(e)
+
+
 # ═══════════════════════════════════════════════
 # ENTRYPOINT
 # ═══════════════════════════════════════════════