Peer-to-peer communication for AI coding agents — by Qualixar, powered by SuperLocalMemory
SLM Mesh defines 8 tools with consistent naming (mesh_* prefix) and reasonable descriptions (avg ~120 chars). All tools have input schemas with types and enums. However, output schemas are entirely undocumented, no response structure is specified for any tool. Parameter descriptions are present but often generic (e.g., 'Message text to send' lacks format/length guidance). Error handling is absent: no recovery guidance, no categorization of retryable vs fatal errors. The mesh_lock and mesh_state tools expose distributed coordination concerns that require careful sequencing, but no idempotency or conflict-resolution guidance is provided. Tool composition is reasonable (each does one thing), but chaining is not documented.
Read, subscribe to, or unsubscribe from mesh events. Events include peer joins/leaves, file locks, state changes, and messages.
Check your incoming messages from other agents. Call periodically to stay in sync with your peers.
Acquire, release, or query distributed file locks. ALWAYS query before editing shared files to avoid conflicts with other agents.
Discover other AI agents connected to the SLM Mesh network. Returns active peers with their names, agent types, and what they are working on.
Send a message to another agent on the mesh. Use peer ID from mesh_peers, or "all" to broadcast to everyone.
Read or write shared state across agent sessions. Use for sharing config values, API endpoints, status flags, etc.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract required fields (e.g., peer IDs from mesh_peers, lock status from mesh_lock). Responses are entirely opaque.
No error handling or recovery guidance. Tools like mesh_lock (distributed coordination) and mesh_send (network delivery) can fail silently or transiently, but no guidance on retryability, conflict resolution, or user-fixable errors.
mesh_lock and mesh_state lack idempotency guarantees and conflict-resolution semantics. No documentation of what happens if two agents acquire the same lock, or if concurrent state writes occur. Agents cannot safely retry.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 61 | <=2025-11-25 | v2 |
Get the status of the SLM Mesh broker and network. Returns peer counts, message stats, lock counts, and broker uptime.
Set a summary of what you are currently working on. This is visible to other agents on the mesh so they know your context.
Parameter descriptions are generic and lack constraints. 'Message text to send' does not specify max length, encoding, or format. 'Brief description' (mesh_summary) lacks guidance on what constitutes useful context for other agents.
mesh_inbox and mesh_events lack pagination guidance. No documented limit on result size, no next_cursor or offset mechanism. Large message backlogs could exhaust context windows.