Graph analysis for AI agent memory — connections, clustering, and visualization. Plugin for cortex-engine.
tools-graph provides 4 well-structured tools with complete input schemas and descriptions. Naming follows verb_noun convention (graph_report, link, suggest_links, suggest_tags). All tools have descriptions (avg 120 chars) and documented parameters with types. However, output schemas are not formally documented, handlers return untyped Record<string, unknown>. Error handling is minimal (basic validation only, no recovery guidance). The 'link' tool lacks idempotency documentation despite being a write operation. No tool annotations (readOnlyHint, destructiveHint) are present. Parameter descriptions are adequate but lack format constraints (e.g., weight range 0.1-1.0 is stated but not enforced in schema). Overall solid foundation but missing production-grade polish.
Graph connectivity report — orphaned concepts, most/least connected nodes, memory density by category.
Manually create a typed relationship edge between two concepts. Use for connections you've reasoned to explicitly rather than waiting for dream consolidation.
Scan a text for phrases that match known concepts in the memory graph. Returns link suggestions with similarity scores.
Suggest tags for content based on semantic similarity to known concepts in the memory graph.
Output schemas not documented. Handlers return Record<string, unknown> with no formal schema definition. LLMs cannot predict response structure for downstream planning.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). 'link' is a write operation but lacks destructiveHint. 'graph_report' and suggest_* are read-only but lack readOnlyHint.
Error handling lacks recovery guidance. 'link' returns bare error strings ('source_id and target_id required', 'Invalid relation') without actionable next steps or suggestions.
Parameter constraints not enforced in schema. 'weight' description states 0.1-1.0 range but schema lacks minimum/maximum. 'threshold' (0-1) and 'max_tags' lack bounds.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 57 | 2026-07-28+ | v2 |
No idempotency guarantee documented for 'link'. Write operations should declare idempotency or support deduplication (e.g., via edge hash or upsert semantics).