INFORMATIVEDRAFTprotocol

Truth Source: Repository schemas and tests are authoritative.

Module Interactions

Scope

This document describes the relationships and dependencies between MPLP L2 modules. It is informative and provides a comprehensive overview of how modules interact within the protocol.

Non-Goals

This document does not define normative obligations. All normative requirements are defined in individual module specifications.

---

1. Purpose

This document describes the relationships and dependencies between MPLP L2 modules, providing a comprehensive view of how modules interact within the protocol.

2. Module Classification

2.1 Core Modules (Required)

Module	Purpose	Always Required
Core	Protocol manifest	Yes
Context	World state	Yes
Plan	Task decomposition	Yes
Trace	Execution audit	Yes
Role	Permissions	Yes

2.2 Coordination Modules (Optional)

Module	Purpose	Profile
Collab	Multi-agent sessions	MAP
Confirm	Approval workflow	SA/MAP
Dialog	Conversations	SA/MAP

2.3 Extension Modules (Optional)

Module	Purpose	Profile
Extension	Plugin system	SA/MAP
Network	Agent topology	MAP

3. Dependency Graph

3.1 Complete Dependency Map

3.2 Reference Bindings

From	Field	To	Description
Plan	context_id	Context	Plan belongs to Context
Trace	context_id	Context	Trace belongs to Context
Trace	plan_id	Plan	Trace for Plan execution
Confirm	target_id	Plan/Context	What to approve
Confirm	requested_by_role	Role	Who requested
Confirm	decided_by_role	Role	Who decided
Collab	context_id	Context	Session belongs to Context
Collab	participant.role_id	Role	Participant role
Dialog	context_id	Context	Dialog belongs to Context
Extension	context_id	Context	Extension belongs to Context
Network	context_id	Context	Network belongs to Context
Plan.Step	agent_role	Role	Step executor
Context	owner_role	Role	Context owner

4. Data Flow Patterns

4.1 SA Profile (Single-Agent)

4.2 MAP Profile (Multi-Agent)

5. Module Coupling

5.1 Loose Coupling (Recommended)

Good: Reference by ID only

{
  "plan_id": "plan-123",
  "context_id": "ctx-456"
}

5.2 Invariant Enforcement

Modules enforce cross-references through invariants:

// SA invariant: Plan context_id must match loaded Context
function validatePlanContextBinding(plan: Plan, context: Context): boolean {
  return plan.context_id === context.context_id;
}

// SA invariant: Trace context_id must match loaded Context
function validateTraceContextBinding(trace: Trace, context: Context): boolean {
  return trace.context_id === context.context_id;
}

6. Profile Configurations

6.1 Minimal SA Profile

Required modules only:

{
  "modules": [
    { "module_id": "context", "status": "enabled" },
    { "module_id": "plan", "status": "enabled" },
    { "module_id": "trace", "status": "enabled" },
    { "module_id": "role", "status": "enabled" }
  ]
}

6.2 Full SA Profile

With approval and dialog:

{
  "modules": [
    { "module_id": "context", "status": "enabled" },
    { "module_id": "plan", "status": "enabled" },
    { "module_id": "trace", "status": "enabled" },
    { "module_id": "role", "status": "enabled" },
    { "module_id": "confirm", "status": "enabled" },
    { "module_id": "dialog", "status": "enabled" }
  ]
}

6.3 Full MAP Profile

Multi-agent with all modules:

{
  "modules": [
    { "module_id": "context", "status": "enabled" },
    { "module_id": "plan", "status": "enabled" },
    { "module_id": "trace", "status": "enabled" },
    { "module_id": "role", "status": "enabled" },
    { "module_id": "collab", "status": "enabled" },
    { "module_id": "confirm", "status": "enabled" },
    { "module_id": "dialog", "status": "enabled" },
    { "module_id": "extension", "status": "enabled" },
    { "module_id": "network", "status": "enabled" }
  ]
}

7. Event Flow

7.1 Cross-Module Events

Event	Source	Consumers
context.activated	Context	Plan, Collab
plan.proposed	Plan	Confirm
plan.approved	Confirm	Plan, Trace
step.completed	Plan	Trace, Learning
collab.started	Collab	Dialog, Trace
confirm.decided	Confirm	Plan, Learning

7.2 Event Propagation

8. Related Documents

• Core Module
• Context Module
• Plan Module
• Trace Module
• Role Module
• Collab Module
• Confirm Module
• Dialog Module
• Extension Module
• Network Module

---

Core Modules: Core, Context, Plan, Trace, Role (5)
Optional Modules: Collab, Confirm, Dialog, Extension, Network (5)
Total Modules: 10