How sugarfarmeriod/tunnelminion works
TunnelMinion is a local-first, cross-platform AI agent for inspecting services on a node and diagnosing authorized peers over an existing private network. The main workflow is browser chat or resource browsing → local agent and read-only tools → service evidence and diagnostics; separate flows cover confirmed long-term memory, human-approved peer operations, incident investigation, and managed-network coordination. The README documents these capabilities, while sampled code confirms selected assembly, persistence, and request paths; links for unsampled wiring are intentionally omitted.
Main entry points: router.tsx Page routing · runtime.py Agent runtime · conversation.py Conversation API · client.py Gateway client
Components 24
Web experience
- Browser app
frontend/src/main.tsx - Page routing
frontend/src/app/router.tsx - Chat page
frontend/src/features/chat/ChatPage.tsx - Resource views
src/tunnelminion/web/resources.py - Conversation API
src/tunnelminion/web/conversation.py
Agent and diagnostics
- Application assembly
src/tunnelminion/app.py - Agent runtime
src/tunnelminion/agent/runtime.py - Tool runtime
src/tunnelminion/tools/runtime.py - Windows adapters
src/tunnelminion/platforms/windows/definitions.py - Service summaries
src/tunnelminion/agent/services.py - Cross-node diagnostics
src/tunnelminion/agent/diagnostics.py - Model service
src/tunnelminion/model/api.py
Peer networking
- Peer Gateway API
src/tunnelminion/gateway/api.py - Gateway client
src/tunnelminion/gateway/client.py - Coordinator
src/tunnelminion/coordinator/app.py - Managed path control
src/tunnelminion/network/path_controller.py
Operations and incidents
- Requester operations
src/tunnelminion/operation/requester_service.py - Incident investigation
src/tunnelminion/incident/investigation.py
Memory and state
- Incident store
src/tunnelminion/incident/storage.py - Memory service
src/tunnelminion/memory/service.py - Memory store
src/tunnelminion/memory/sqlite.py
Other components
- Operator
- External model
- Authorized peer
Connections 20
- Operator → Browser app: uses
- Browser app → Page routing: renders
- Page routing → Chat page: routes to
- Chat page → Conversation API: requests
- Page routing → Resource views: loads
- Application assembly → Conversation API: mounts
- Application assembly → Resource views: mounts
- Conversation API → Agent runtime: dispatches
- Agent runtime → Model service: queries
- Model service → External model: calls
- Agent runtime → Tool runtime: invokes
- Tool runtime → Windows adapters: dispatches
- Cross-node diagnostics → Service summaries: summarizes evidence
- Cross-node diagnostics → Gateway client: requests peer tools
- Gateway client → Authorized peer: calls
- Authorized peer → Peer Gateway API: serves
- Requester operations → Gateway client: submits plans
- Coordinator → Managed path control: coordinates paths
- Incident investigation → Incident store: persists state
- Memory service → Memory store: reads and writes