Component standard
Required identity, lifecycle, representation, role, capability, evidence, and limitation fields.
PLLM documentationView Markdown ↗
- Choose a semantic category and stable authority-owned identity.
- Define versioned parameters, lifecycle phase, input and output representations, host requirements, roles, artifacts, and evidence pointers.
- Implement one concrete class in the semantic family, not in
configuration.pyor a paper-named runtime path;describe()on that class is the descriptor source of truth. - Register the class and add static discovery and identity tests without importing provider or native runtime code.
- Add compatibility and operator-coverage tests.
- Add runtime, benchmark, quality, assurance, and deployment evidence independently when each exists.
The canonical contract is design/component-standard.md. Missing fields remain not recorded; empty evidence is not a pass.
Python SDK example
from pllm.components import get, get_component
from pllm.kernels import Cpu
component_class = get("pllm/cpu")
descriptor = get_component("pllm/cpu")
record = descriptor.to_dict()
assert component_class is Cpu
assert component_class.describe() is descriptor
assert {"provider", "version", "category", "capabilities"} <= record.keys()Built-in descriptors expose the public fields contributors must keep discoverable.