Vitals tracking for AI agents — health metrics, operational signals, and system monitoring. Plugin for cortex-engine.
Two tools with clear naming (vitals_get, vitals_set) and reasonable descriptions (100-150 chars). Input schemas present with proper types and enums. However, output schemas are undocumented, LLMs cannot predict response structure. Error handling is absent; no guidance on invalid inputs or failure modes. Parameter descriptions are minimal (e.g., 'New value 0.0-1.0' lacks context on when/why to update). Missing tool annotations (readOnlyHint, destructiveHint). vitals_set lacks validation error messaging.
Read all current vitals (curiosity, connection, confidence, creative_energy, frustration) with behavioral trigger evaluation.
Update a single vital dimension value (0.0-1.0).
Output schemas undocumented. vitals_get returns {vitals, triggers} but LLMs cannot predict field types or structure. vitals_set response structure not visible in code.
No error handling or recovery guidance. Invalid dimension enum values, out-of-range numbers (value > 1.0), or missing required params will fail silently. LLM has no guidance on self-correction.
Missing tool annotations. vitals_get should have readOnlyHint=true; vitals_set should have destructiveHint=true. Agents cannot infer safety/idempotency without explicit hints.
Parameter descriptions lack context. 'New value 0.0-1.0' does not explain what the dimension represents or when to adjust it. 'Namespace (defaults to default)' is vague about multi-tenant isolation.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
vitals_set handler code truncated in source; cannot verify input validation, range checks, or error responses. Assumes all inputs are valid.