session-mesh

Purpose

This skill manages session topologies in distributed communication systems. It enables discovery of active sessions, maintains a specialization registry, allows steering or terminating sub-agents, and handles session keys for secure interactions. Use it to build resilient mesh networks where agents communicate dynamically.

When to Use

• When monitoring or managing distributed sessions in real-time, such as in IoT fleets or multi-agent AI systems.
• For tasks involving sub-agent control, like rerouting traffic or scaling resources in a mesh topology.
• In scenarios requiring session key management for authentication, e.g., secure data exchange between agents.
• Avoid if you're working with isolated, non-distributed systems; this is optimized for interconnected environments.

Key Capabilities

• Discover alive sessions: Query active sessions using GET /api/session-mesh/alive with query parameters like ?filter=active.
• Specialization registry: Register sub-agent specializations via POST /api/session-mesh/registry with a JSON body, e.g., {"specialization": "image-processing", "agent_id": "123"}.
• Steer sub-agents: Redirect agents using CLI flag --direction (e.g., north/south) or API endpoint POST /api/session-mesh/steer with payload {"agent_id": "456", "direction": "east"}.
• Kill sub-agents: Terminate agents via CLI command session-mesh kill --agent-id 789 or API DELETE /api/session-mesh/agents/789.
• Session keys: Generate keys with POST /api/session-mesh/keys, returning a secure token for authentication.