Connector registry¶
Every officially-maintained parsimony-<name> distribution declares itself
to the kernel through entry-point metadata in its pyproject.toml:
The value is a bare importable module path, not a module:attr target.
The kernel imports that module and reads its top-level
CONNECTORS = Connectors([...]) export.
Consumers (agent frameworks, CLIs) discover installed providers at
runtime via the kernel's parsimony.discover surface (discover.load_all()
and discover.load(*names)). Entry-point metadata on the installed
distribution is the authoritative source; this monorepo does not ship a
separate index file.
Adding an officially-maintained connector¶
- Add
packages/<name>/with apyproject.tomlthat declares a[project.entry-points."parsimony.providers"]stanza (CI enforces this invariant; see.github/workflows/ci.yml→discoverjob). - Follow the conformance contract in the kernel's
parsimony.testingmodule — CI runsassert_plugin_validon every package. - Publish through the monorepo's per-package release workflow.