Imported from constructorfleet/mcp-plex (
mcp_plex/common/AGENTS.md). Install upstream withnpx skills add constructorfleet/mcp-plex --skill common. Copyright stays with the author.
AGENTS
Architecture
mcp_plex.commonprovides shared cache helpers, data models, and utility types consumed by both the loader and the server packages.- Keep shared logic decoupled from CLI wiring so it can be imported safely by tests and other packages.
- Update this module when adding reusable functionality to avoid duplicating code between the loader and server implementations.
- Use the
JSONValueand related aliases intypes.pywhen exchanging cached payloads or structured JSON-like data. Media caches and downstream consumers expect payload dictionaries to resolve todict[str, JSONValue]without falling back toAny.