NetContract

Inspiration

Network engineers often work across legacy tools, diagnostic logs, documented procedures, and approval queues. We wanted to make that workflow easier to use while preserving the operational logic behind it.

NetContract explores a simple idea: describe the problem aloud, inspect the evidence on screen, and keep engineers in control of the next action.

What it does

NetContract demonstrates a voice-assisted network incident workflow. An engineer describes symptoms, the application collects synthetic diagnostic outputs, matches a structured procedure, and presents evidence and proposed steps for review.

Saying “Approved” prompts a node-specific confirmation. “Confirm approval” authorises only a simulated recovery, followed by postchecks.

A separate repository mapper accepts ZIP uploads, discovers supported code structures and integration indicators, and proposes editable mappings for human review. Automatic conversion from an uploaded repository into agent tools is outside this demo.

How we built it

We extended our existing ContractCyber platform with a conversational interface and a real MCP server using the official Python SDK, Streamable HTTP, and protocol version 2025-11-25.

The browser acts as an MCP client, with speech recognition and synthesis for voice interaction. Python and FastAPI handle diagnostics, procedure matching, and review workflows. SQLite retains workflow evidence.

We deployed the applications on AWS EC2, using Caddy for HTTPS and password protection, with systemd keeping the services running.

This is an Alexa+ experience simulation using browser speech—not a live Alexa device integration. The demonstrated network services, command outputs, and recovery actions are synthetic. Challenges we ran into The biggest challenge was keeping conversational convenience separate from operational authority. A casual “approve” should never silently trigger a change.

We introduced a second confirmation tied to the investigation’s version and evidence digest. Expired, replayed, or stale confirmations are rejected.

We also worked through EC2 networking, certificate validation, and browser microphone requirements. Because live Alexa+ connection tools are unavailable to hackathon entrants, we followed the supported web simulation route. Accomplishments that we're proud of We built a complete investigation-to-review demonstration: spoken symptoms, parsed diagnostic evidence, procedure matching, explicit confirmation, and verified synthetic recovery.

Our browser performs real MCP calls rather than displaying a scripted conversation. We validated the implementation with 56 targeted tests, including confirmation expiry, replay protection, stale evidence rejection, and client-to-server interaction.

The interface keeps spoken explanations short while preserving technical detail on screen. What we learned Modernising an operational workflow does not require recreating an entire legacy application. Defined service interfaces and structured procedures can provide a practical foundation for new interactions.

We also learned that symptoms, observations, and root causes must remain distinct. A diagnostic result can confirm a fault without proving why it happened.

Voice works well for quick requests and brief explanations; visual evidence remains essential for informed review.

What's next for NetContract

Next, we want to connect reviewed repository-discovery outputs to the operational procedure catalog and support importing organisation-provided MOPs into structured contracts.

Future work includes validated service adapters, Salesforce-backed records and approvals, and controlled command proposals from reviewed procedures.

Our priority is to extend the demonstrated workflow carefully: preserve source evidence, flag missing information, and require appropriate review before enabling real actions.## Inspiration

Built With

• alexa
• amazon
• api
• caddy
• context
• css3
• ec2
• fastapi
• html5
• javascript
• mcp
• model
• protocol
• pydantic
• python
• salesforce
• speech
• sqlite
• telemetry
• terrraform
• web