paxm memory - A memory management system that provides recall and remember tools for storing and retrieving contextual information through configured memory providers
paxm exposes 4 memory-management tools with complete JSON schemas and reasonable descriptions. Tool names follow verb_noun convention (paxm_recall, paxm_remember, paxm_history, paxm_config_doctor). All tools have descriptions (50 - 150 chars, within baseline 34 - 392 range). Input schemas are present with typed properties and descriptions. However, descriptions lack actionable context (when to use, prerequisites, error recovery). Parameter descriptions are minimal (e.g., 'Optional recall profile' without explaining profile options or defaults). Output schemas are not documented, LLMs cannot predict response structure. No error handling guidance. Tool composition is sound (each does one thing), but descriptions could be 2 - 3x more detailed to match A-grade baselines (50 - 200 chars, LLM-optimized).
Check health for enabled paxm memory providers without returning secrets.
Summarize recent local paxm telemetry.
Search configured paxm memory providers using the active recall policy.
Store memory through the configured paxm write profile. Use profile=stm for short-term working memory and profile=ltm for durable facts.
Output schemas not documented. LLMs cannot predict response structure (e.g., what fields are in memory.MemoryHit, what does paxm_remember return). Forces agents to guess downstream field names.
Parameter descriptions lack actionable detail. 'Optional recall profile' does not explain what profiles exist, when to use each, or what the default is. 'Optional metadata filters' does not specify format or valid keys.
Tool descriptions lack context for LLM selection. 'paxm_history' says 'Summarize recent local paxm telemetry' but does not explain when to call it vs paxm_recall, what 'telemetry' means, or what the output contains.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | 2025-06-18+ | v2 |
No error handling guidance. If paxm_recall returns no hits, or a provider fails, what should the LLM do? Retry? Call a different tool? Error responses must guide recovery.
paxm_config_doctor naming is vague. 'doctor' is not an action verb. Consider 'check_provider_health' or 'validate_memory_providers' to clarify intent.