How vaibhav375/protocol-toolkit works
Protocol Toolkit is a network-protocol workbench: users run real HTTP, DNS, SMTP, mail-deliverability, and port-scan operations, then inspect the recorded exchange and export captures. The browser UI calls a Python web backend, which dispatches to raw-socket protocol clients and maintains session and capture state. The README documents HTTP/1.1–3, DNS trace and transports, test servers, assistant tool use, pcapng, and HAR. Some backend routes and export wiring are unsampled, so only documented or indexed relationships are shown.
Main entry points: server.py Web API · httpclient.py HTTP Client · wire.py Wire Capture · agent.py Assistant Agent
Components 24
Workbench UI
- Workbench Views
web/src/views/HttpView.tsx - App Shell
web/src/App.tsx - UI State
web/src/lib/store.tsx - API Client
web/src/lib/api.ts - Wire Display
web/src/components/wire.tsx
Web Backend
- Web API
protocol_toolkit/webapp/server.py
Protocol Operations
- HTTP Client
protocol_toolkit/httpclient.py - HTTP/2
protocol_toolkit/http2.py - HTTP/3
protocol_toolkit/http3.py - DNS Client
protocol_toolkit/dnsclient.py - SMTP Client
protocol_toolkit/smtpclient.py - Mail Check
protocol_toolkit/mailcheck.py - Port Scanner
protocol_toolkit/scanner.py - Assistant Agent
protocol_toolkit/agent.py - LLM Providers
protocol_toolkit/llm.py
Capture and Analysis
- Wire Capture
protocol_toolkit/wire.py - Inspector UI
web/src/views/InspectorView.tsx - pcapng Export
protocol_toolkit/pcap.py - HAR Export
protocol_toolkit/har.py - Protocol Annotations
protocol_toolkit/explain.py
Safety and Lab
- Network Guard
protocol_toolkit/guard.py - Local Test Servers
protocol_toolkit/testservers.py - TCP and TLS
protocol_toolkit/net.py
Other components
- User
Connections 34
- User → Workbench Views: runs operations
README.md - Workbench Views → App Shell: renders in
web/src/App.tsx - App Shell → UI State: uses state
web/src/App.tsx - Workbench Views → API Client: calls API
web/src/views/HttpView.tsx - API Client → Web API: sends requests
web/src/lib/api.ts - Web API → HTTP Client: dispatches HTTP
protocol_toolkit/webapp/server.py - Web API → DNS Client: dispatches DNS
protocol_toolkit/webapp/server.py - Web API → SMTP Client: dispatches SMTP
protocol_toolkit/webapp/server.py - Web API → Mail Check: dispatches checks
protocol_toolkit/webapp/server.py - Web API → Port Scanner: dispatches scans
protocol_toolkit/webapp/server.py - Web API → Assistant Agent: dispatches assistant
protocol_toolkit/webapp/server.py - HTTP Client → HTTP/2: uses when negotiated
protocol_toolkit/httpclient.py - HTTP Client → HTTP/3: supports HTTP/3
README.md - Mail Check → DNS Client: queries records
protocol_toolkit/mailcheck.py - Mail Check → HTTP Client: fetches policies
protocol_toolkit/mailcheck.py - Mail Check → SMTP Client: checks SMTP
protocol_toolkit/mailcheck.py - Assistant Agent → LLM Providers: requests model steps
protocol_toolkit/agent.py - Assistant Agent → HTTP Client: invokes tools
protocol_toolkit/agent.py - Assistant Agent → DNS Client: invokes tools
protocol_toolkit/agent.py - Assistant Agent → Mail Check: invokes tools
protocol_toolkit/agent.py - HTTP Client → TCP and TLS: opens connections
protocol_toolkit/httpclient.py - DNS Client → TCP and TLS: uses transport
protocol_toolkit/dnsclient.py - SMTP Client → TCP and TLS: uses transport
protocol_toolkit/smtpclient.py - Port Scanner → TCP and TLS: probes ports
protocol_toolkit/scanner.py - HTTP Client → Wire Capture: records exchange
protocol_toolkit/httpclient.py - DNS Client → Wire Capture: records exchange
protocol_toolkit/dnsclient.py - SMTP Client → Wire Capture: records exchange
protocol_toolkit/smtpclient.py - Wire Display → API Client: formats capture data
web/src/components/wire.tsx - Inspector UI → API Client: loads captures
web/src/views/InspectorView.tsx - Wire Capture → pcapng Export: exports pcapng
README.md - Wire Capture → HAR Export: exports HAR
README.md - Wire Capture → Protocol Annotations: annotates bytes
protocol_toolkit/har.py - Web API → Network Guard: applies network safety
protocol_toolkit/webapp/server.py - Web API → Local Test Servers: controls local servers
protocol_toolkit/webapp/server.py