Metadata-Version: 2.4
Name: mplp-sdk
Version: 1.0.5
Summary: Published Python protocol helper package for MPLP v1.0.0 metadata, protocol binding, and Kernel Duty baseline.
Author: Coregentis AI
License-Expression: 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,python,kernel-duties
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
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.9
Description-Content-Type: text/markdown

# mplp-sdk

**Package Role:** Published PyPI protocol helper package
**Protocol:** MPLP v1.0.0 (Frozen)
**sdk_version:** 1.0.5
**License:** Apache-2.0

The published `mplp-sdk` package currently provides a **minimal Python
protocol helper surface** for MPLP package identity, protocol-version alignment,
and the canonical 11 Kernel Duties.

Current shipped surface:

- `import mplp`
- `mplp.__version__`
- `mplp.MPLP_PROTOCOL_VERSION`
- `mplp.KERNEL_DUTIES`
- `mplp.KERNEL_DUTY_IDS`
- `mplp.KERNEL_DUTY_NAMES`
- `mplp.KERNEL_DUTY_COUNT`

It does **not** currently ship a full Python SDK, generated models, or a
reference runtime implementation.

---

## Scope & Guarantees (Important)

### What this package provides

- Installable protocol helper package surface for MPLP v1.0.0
- Protocol version alignment with the frozen MPLP protocol specification
- Kernel Duty baseline exports for published Python package consumers

### What this package does NOT provide

- Full Python SDK models
- Pydantic model set
- Reference runtime implementation
- Golden Flow execution engines
- Full Python SDK models
- Reference runtime implementation
- Golden Flow execution engines

---

## Installation

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

---

## Protocol Documentation (Authoritative)

- **Homepage:** [https://www.mplp.io](https://www.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)

---

## Publish Scope

- **Public PyPI surface:** `packages/pypi/mplp-sdk/`
- **Source-side mirror:** `packages/sources/sdk-py/`

This public package surface is intentionally narrower than the TypeScript SDK and
runtime packages, but it now carries the canonical 11-duty baseline for Python consumers.

---

## Kernel Duty Baseline

This package now ships the 11 MPLP Kernel Duties as Python constants:

```python
import mplp

assert mplp.KERNEL_DUTY_COUNT == 11
print(mplp.KERNEL_DUTIES[0])
```

Canonical upstream baseline remains in:

- `schemas/v2/taxonomy/kernel-duties.yaml`
- `governance/05-specialized/entity.json`

---

## Versioning & Compatibility

- **Protocol version:** MPLP v1.0.0 (Frozen)
- **Published package version:** 1.0.5
- **Kernel duty baseline:** 11/11 carried in package exports
- **Package compatibility:** aligned to `protocol_version` v1.0.0 only
- Breaking changes require a new protocol version.

---

## License

Apache License, Version 2.0

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