suaveplan/packages/networking/network/network-plugin-transport-manager/README.md

@suaveplan/network-plugin-transport-manager - Multi-transport orchestration for the Suaveplan mesh: pool, capability negotiation, priority routing, round-robin balancing, health monitoring, pre-emptive switching, session persistence, battery + bandwidth conservation

Summary

Multi-transport orchestration for the Suaveplan mesh. Maintains a pool of registered transports per peer, negotiates capability bitmaps during handshake, routes outbound messages by 5-tier priority (CRITICAL/HIGH/NORMAL/LOW/BULK), distributes NORMAL/BULK traffic across all healthy transports via round-robin, monitors per-transport health (RTT/loss/stability) and auto-pauses degraded paths, pre-emptively switches transports when quality trends predict failure with smooth handoff, persists session state across temporary drops with prioritized recovery, and conserves power and bandwidth via BatteryAwareScheduler and BandwidthConservator.

Documentation tree

• analyzer — (no submodules)
  • quality-trend-analyzer — (no submodules)
• balancer — (no submodules)
  • round-robin-balancer — (no submodules)
• health — (no submodules)
  • transport-health-monitor — (no submodules)
• negotiator — (no submodules)
  • capability-negotiator — (no submodules)
• persistence — (no submodules)
  • session-persistence-buffer — (no submodules)
• plugin — (no submodules)
  • transport-manager-plugin — (no submodules)
• pool — (no submodules)
  • transport-pool — (no submodules)
• priority — (no submodules)
  • priority-router — (no submodules)
• connection-recovery-manager — Generates exponential-backoff delays with bounded full-jitter so the manager can pace reconnection attempts without thu…
• session-continuity-guard — Owns the session-state machine around the persistence buffer so callers cannot bypass the documented sequence: a sessio…
• bandwidth-conservator — Implements NET-124: when the manager is told it has a constrained bandwidth budget, this module reports the recommend…
• battery-aware-scheduler — Reduces keepalive frequency and prefers low-power transports when the host device is running on battery. Implements `NE…
• preemptive-selector — Decides whether to swap a still-functioning transport for a healthier alternative before the current one drops to bel…
• transport-selector — Translates a (priority, commonCapabilities) ask into a concrete, ordered list of transports drawn from the live pool.…
• error-codes — Frozen registry of every error code raised by the transport-manager package. Codes are namespaced under NET_TM and re…

- [quality-trend-analyzer](./src/analyzer/quality-trend-analyzer.md) — _(no submodules)_- [balancer](./src/balancer/round-robin-balancer.md) — _(no submodules)_- [round-robin-balancer](./src/balancer/round-robin-balancer.md) — _(no submodules)_- [health](./src/health/transport-health-monitor.md) — _(no submodules)_- [transport-health-monitor](./src/health/transport-health-monitor.md) — _(no submodules)_- [negotiator](./src/negotiator/capability-negotiator.md) — _(no submodules)_- [capability-negotiator](./src/negotiator/capability-negotiator.md) — _(no submodules)_- [persistence](./src/persistence/session-persistence-buffer.md) — _(no submodules)_- [session-persistence-buffer](./src/persistence/session-persistence-buffer.md) — _(no submodules)_- [plugin](./src/plugin/transport-manager-plugin.md) — _(no submodules)_- [transport-manager-plugin](./src/plugin/transport-manager-plugin.md) — _(no submodules)_- [pool](./src/pool/transport-pool.md) — _(no submodules)_- [transport-pool](./src/pool/transport-pool.md) — _(no submodules)_- [priority](./src/priority/priority-router.md) — _(no submodules)_- [priority-router](./src/priority/priority-router.md) — _(no submodules)_- [connection-recovery-manager](./src/recovery/connection-recovery-manager.md) — Generates exponential-backoff delays with bounded full-jitter so the manager can pace reconnection attempts without thu…

• session-continuity-guard — Owns the session-state machine around the persistence buffer so callers cannot bypass the documented sequence: a sessio…
• bandwidth-conservator — Implements NET-124: when the manager is told it has a constrained bandwidth budget, this module reports the recommend…
• battery-aware-scheduler — Reduces keepalive frequency and prefers low-power transports when the host device is running on battery. Implements `NE…
• preemptive-selector — Decides whether to swap a still-functioning transport for a healthier alternative before the current one drops to bel…
• transport-selector — Translates a (priority, commonCapabilities) ask into a concrete, ordered list of transports drawn from the live pool.…
• error-codes — Frozen registry of every error code raised by the transport-manager package. Codes are namespaced under NET_TM and re…
• quality-trend-analyzer — (no submodules)- balancer — (no submodules)- round-robin-balancer — (no submodules)- health — (no submodules)- transport-health-monitor — (no submodules)- negotiator — (no submodules)- capability-negotiator — (no submodules)- persistence — (no submodules)- session-persistence-buffer — (no submodules)- plugin — (no submodules)- transport-manager-plugin — (no submodules)- pool — (no submodules)- transport-pool — (no submodules)- priority — (no submodules)- priority-router — (no submodules)- connection-recovery-manager — Generates exponential-backoff delays with bounded full-jitter so the manager can pace reconnection attempts without thu…
• session-continuity-guard — Owns the session-state machine around the persistence buffer so callers cannot bypass the documented sequence: a sessio…
• bandwidth-conservator — Implements NET-124: when the manager is told it has a constrained bandwidth budget, this module reports the recommend…
• battery-aware-scheduler — Reduces keepalive frequency and prefers low-power transports when the host device is running on battery. Implements `NE…
• preemptive-selector — Decides whether to swap a still-functioning transport for a healthier alternative before the current one drops to bel…
• transport-selector — Translates a (priority, commonCapabilities) ask into a concrete, ordered list of transports drawn from the live pool.…
• error-codes — Frozen registry of every error code raised by the transport-manager package. Codes are namespaced under NET_TM and re…
• quality-trend-analyzer — (no submodules)- balancer — (no submodules)- round-robin-balancer — (no submodules)- health — (no submodules)- transport-health-monitor — (no submodules)- negotiator — (no submodules)- capability-negotiator — (no submodules)- persistence — (no submodules)- session-persistence-buffer — (no submodules)- plugin — (no submodules)- transport-manager-plugin — (no submodules)- pool — (no submodules)- transport-pool — (no submodules)- priority — (no submodules)- priority-router — (no submodules)- connection-recovery-manager — Generates exponential-backoff delays with bounded full-jitter so the manager can pace reconnection attempts without thu…
• session-continuity-guard — Owns the session-state machine around the persistence buffer so callers cannot bypass the documented sequence: a sessio…
• bandwidth-conservator — Implements NET-124: when the manager is told it has a constrained bandwidth budget, this module reports the recommend…
• battery-aware-scheduler — Reduces keepalive frequency and prefers low-power transports when the host device is running on battery. Implements `NE…
• preemptive-selector — Decides whether to swap a still-functioning transport for a healthier alternative before the current one drops to bel…
• transport-selector — Translates a (priority, commonCapabilities) ask into a concrete, ordered list of transports drawn from the live pool.…
• error-codes — Frozen registry of every error code raised by the transport-manager package. Codes are namespaced under NET_TM and re…
• quality-trend-analyzer — (no submodules)- balancer — (no submodules) - round-robin-balancer — (no submodules)- health — (no submodules) - transport-health-monitor — (no submodules)- negotiator — (no submodules) - capability-negotiator — (no submodules)- persistence — (no submodules) - session-persistence-buffer — (no submodules)- plugin — (no submodules) - transport-manager-plugin — (no submodules)- pool — (no submodules) - transport-pool — (no submodules)- priority — (no submodules) - priority-router — (no submodules)- connection-recovery-manager — Generates exponential-backoff delays with bounded full-jitter so the manager can pace reconnection attempts without thu…
• session-continuity-guard — Owns the session-state machine around the persistence buffer so callers cannot bypass the documented sequence: a sessio…
• bandwidth-conservator — Implements NET-124: when the manager is told it has a constrained bandwidth budget, this module reports the recommend…
• battery-aware-scheduler — Reduces keepalive frequency and prefers low-power transports when the host device is running on battery. Implements `NE…
• preemptive-selector — Decides whether to swap a still-functioning transport for a healthier alternative before the current one drops to bel…
• transport-selector — Translates a (priority, commonCapabilities) ask into a concrete, ordered list of transports drawn from the live pool.…
• error-codes — Frozen registry of every error code raised by the transport-manager package. Codes are namespaced under NET_TM and re…