Skip to content

Commit 6718b30

Browse files
authored
Clarify MCE semantics and enhance MRD description
Added clarification on MCE's request-response semantics and expanded on MRD's support for push-based propagation.
1 parent 9a8c1f8 commit 6718b30

File tree

1 file changed

+16
-4
lines changed

1 file changed

+16
-4
lines changed

docs/HMP-0005.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1514,6 +1514,10 @@ For details and examples, see **section 3.15** — *Usage of `network` and `broa
15141514
The **Mesh Container Exchange (MCE)** mechanism is designed for discovering, requesting, and exchanging containers between agents in a distributed network.
15151515
It provides **container synchronization without duplication** while considering network constraints (`broadcast`, `network`).
15161516

1517+
*MCE does not mandate request-response semantics.*
1518+
1519+
---
1520+
15171521
### 5.1 General principles
15181522

15191523
1. Each agent maintains a **Container Index** — a set of minimal metadata describing which containers are available in its storage and how they are cognitively positioned.
@@ -4727,12 +4731,18 @@ and lists all containers with their metadata and hashes.
47274731

47284732
The **Message Routing & Delivery (MRD)** subsystem defines how containers are delivered to specific agents across the Mesh.
47294733
Unlike the **Mesh Container Exchange (MCE)**, which is responsible for publishing and exchanging containers in the Mesh network,
4730-
MRD focuses on *directed delivery* — ensuring that a container eventually reaches its intended recipient,
4731-
even through NAT, intermittent connectivity, or indirect relay paths.
4734+
MRD focuses on *directed delivery* — ensuring that a container eventually reaches its intended recipient, even through NAT, intermittent connectivity, or indirect relay paths.
47324735

47334736
In HMP v5.0, message delivery is performed through verifiable **container transactions**.
47344737
Peers discover suitable relays via `peer_announce` metadata, while delivery routes are auditable through appended `relay_chain` entries and distributed container publication in `container_index` records.
47354738

4739+
MRD **MAY support push-based propagation** (unsolicited or role-driven container dissemination), including:
4740+
4741+
* role-based dissemination;
4742+
* pub/sub hubs;
4743+
* archival store-and-forward nodes;
4744+
* opportunistic broadcast channels.
4745+
47364746
---
47374747

47384748
#### 6.8.1 Purpose
@@ -4897,8 +4907,10 @@ flowchart LR
48974907

48984908
> **Summary:**
48994909
> MRD provides a verifiable, role-driven message delivery layer above MCE.
4900-
> It ensures containers can reach intended recipients through trusted relays,
4901-
> maintaining auditability, TTL enforcement, and reputation-aware routing policies.
4910+
> It ensures containers can reach intended recipients through trusted relays, maintaining auditability, TTL enforcement, and reputation-aware routing policies.
4911+
>
4912+
> **MCE defines container exchange primitives, not delivery strategies.
4913+
> MRD defines how, when, and to whom containers are propagated.**
49024914
49034915
---
49044916

0 commit comments

Comments
 (0)