Metadata-Version: 2.4
Name: mplp-sdk
Version: 1.0.2
Summary: Python SDK and reference runtime for the MPLP Protocol v1.0.0 (Multi-Agent Lifecycle Protocol).
Author: Coregentis AI
License: Apache-2.0
Project-URL: Homepage, https://mplp.io
Project-URL: Documentation, https://docs.mplp.io
Project-URL: Repository, https://github.com/Coregentis/MPLP-Protocol
Project-URL: Issues, https://github.com/Coregentis/MPLP-Protocol/issues
Keywords: mplp,multi-agent,lifecycle,protocol,agent-os,AI agents,runtime
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: pydantic<3.0,>=2.0

# MPLP Python SDK (`mplp-sdk`)

**Protocol:** MPLP v1.0.0 (Frozen)
**License:** Apache-2.0

The **MPLP Python SDK** provides a **protocol-compliant Python interface** for the
**Multi-Agent Lifecycle Protocol (MPLP)** — the Agent OS–level lifecycle specification for AI agent systems.

This package focuses on **schema-level correctness, model validation, and protocol alignment**.
It is designed to be used together with the official MPLP specification and documentation.

---

## Scope & Guarantees (Important)

### ✅ What this package provides

* **Protocol-compliant Python models** aligned with MPLP v1.0.0
* **Structural validation helpers** for core protocol objects (Context, Plan, Trace)
* **Strict version alignment** with the frozen MPLP protocol specification
* **Type-safe integration surface** for higher-level runtimes and tools

### ❌ What this package does NOT provide

* ❌ Full execution runtime (LLM orchestration, tool execution)
* ❌ Golden Flow execution engines (Flow-01 ~ Flow-05)
* ❌ Observability pipelines or distributed tracing backends
* ❌ Production agent orchestration

> These capabilities belong to **reference runtimes and products built *on top of* MPLP**,
> not to the protocol SDK itself.

---

## Installation

```bash
pip install mplp-sdk
```

---

## Basic Validation Usage

```python
from mplp import validate_context, validate_plan, validate_trace

result = validate_context({
    "protocolVersion": "1.0.0",
    # ...
})

if result.ok:
    print("Context is protocol-compliant")
else:
    print(result.errors)
```

> Validation helpers are provided to **assist protocol adoption**,
> not as a substitute for full lifecycle management.

---

## Protocol Documentation (Authoritative)

* **Homepage:** [https://mplp.io](https://mplp.io)
* **Specification & Docs:** [https://docs.mplp.io](https://docs.mplp.io)
* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol)
* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues)

All normative definitions, lifecycle semantics, and Golden Flows
are defined **exclusively** in the official documentation.

---

## Versioning & Compatibility

* **Protocol version:** MPLP v1.0.0 (Frozen)
* **SDK compatibility:** Guaranteed for v1.0.0 only
* Breaking changes require a new protocol version.

---

## License

Apache License, Version 2.0

© 2025 **Bangshi Beijing Network Technology Limited Company**
Coregentis AI
