Skip to content
jearonwong edited this page Dec 4, 2025 · 1 revision

MPLP Protocol — Official Wiki Portal

Multi-Agent Lifecycle Protocol (MPLP)
Version: v1.0.0 (Frozen)
License: Apache-2.0
Governance: MPLP Protocol Governance Committee (MPGC)

Welcome to the official Wiki for the MPLP Protocol, the world’s first open, vendor-neutral lifecycle protocol for multi-agent AI systems.
This Wiki serves as the canonical navigation hub for architects, implementers, runtime developers, and researchers.


📘 What is MPLP?

MPLP defines a full lifecycle governance model for AI agents — from:

Context → Plan → Confirm → Trace → Role → Dialog → Collab → Extension → Core → Network

It provides:

  • A frozen, stable L1–L2 protocol specification

  • JSON Schemas as the single source of truth

  • Runtime glue definitions (L3)

  • Integration & implementation standards (L4)

  • Governance & compatibility guarantees across all implementations


🧊 Frozen Specification Status (v1.0.0)

MPLP v1.0.0 is a Frozen Specification, meaning:

  • Schema definitions are locked

  • Module semantics are invariant

  • Breaking changes are prohibited

  • Any normative change requires a new protocol version via the MIP process

  • Implementations (runtimes, SDKs, IDEs, agents) may evolve, but the protocol contract cannot


📚 Documentation Index

This Wiki organizes all MPLP knowledge into structured documents:

1. Architecture

  • Overview of the 4-layer architecture (L1 → L4)

  • Design principles

  • Module interactions

  • Crosscutting concerns (coordination, observability, versioning, drift control)

2. Core Specification (L1)

  • JSON Schema index

  • Stability guarantees

  • Compliance rules

  • Breaking-change policy

3. Modules & Crosscuts (L2)

  • Full definition of all 10 modules

  • Execution Profiles (SA / MAP)

  • Observability Duties

  • Learning Feedback Duties

4. Runtime Glue (L3)

  • Project Semantic Graph (PSG)

  • Drift detection & rollback

  • AEL / VSL models

  • Execution orchestration

5. Integrations & Implementations (L4)

  • Storage providers

  • Tooling providers

  • LLM integrations

  • Reference runtimes

6. Governance

  • MPLP Improvement Proposal (MIP) process

  • MPGC structure & responsibilities

  • Versioning policy

  • Release checklist

7. SDKs & Tools

  • TypeScript SDK

  • Minimal reference runtime

  • DevTools CLI

  • Compliance testing framework

8. Examples & Use Cases

  • Minimal agent lifecycle examples

  • Multi-agent collaboration patterns

  • Trace & drift governance examples


📦 NPM Packages (Official Implementation Artifacts)

The official MPLP NPM family consists of 12 packages, aligned at version 1.0.2:

Package Description
@mplp/core Core primitives & types
@mplp/schema JSON Schemas (SSOT)
@mplp/modules Module specifications
@mplp/coordination Governance helpers
@mplp/compliance Compliance toolkit
@mplp/devtools Development CLI
@mplp/runtime-minimal Reference runtime
@mplp/sdk-ts TypeScript SDK
@mplp/integration-llm-http LLM integration
@mplp/integration-tools-generic Tool execution
@mplp/integration-storage-fs File storage
@mplp/integration-storage-kv KV storage

NPM Organization:
https://www.npmjs.com/org/mplp


🏛 Governance — MPGC

The MPLP Protocol Governance Committee (MPGC) is responsible for:

  • Maintaining the Frozen Specification

  • Approving MIP proposals

  • Overseeing version increments

  • Ensuring cross-implementation compatibility

  • Managing trademark / usage correctness

Official processes include:

  • MIP Proposal Template

  • Version Bump Protocol

  • Compliance Certification Flow

  • Release Freeze Criteria


📝 Release Notes

See the GitHub Releases page for:

  • v1.0.0 — Frozen Lifecycle Specification

  • v1.0.2 — NPM Release Hardening Update

  • Future MIP proposals & minor-version updates


🚀 Getting Started

  1. Read Architecture Overview

  2. Explore Schemas

  3. Choose an SDK or runtime

  4. Follow the example flows

  5. Run compliance tests

  6. Build your own agent system on MPLP


🔗 Useful Links