How oskarbartoszyk/masqe-hackyeah2026 works
MASQE is a runtime security gateway for agent actions. Clients submit actions through the Go gateway, which evaluates policy and defenses, executes only permitted actions, inspects results, and records decisions for audit and reporting. Python services provide semantic scoring, PII detection, explanations, and Ghost Shell support; the Go gateway remains the decision authority. The dashboard exposes operations, events, incidents, policy, agent activity, and Ghost sessions. Some Go and dashboard subsystem links reflect README documentation because their implementation excerpts were not shown.
Main entry points: engine.go Decision engine · App.jsx Console application · lib.js Console API client · server.go HTTP gateway
Components 26
Client integrations
- Python SDK
sdk/python/masqe_sdk.py - MCP proxy
sdk/python/masqe_mcp.py
Go security gateway
- HTTP gateway
gateway/server.go - Decision engine
gateway/engine.go - Action execution
gateway/execution.go - Deterministic guards
gateway/guards.go
Python guard services
- Semantic scoring
ai-guard/server.py - PII detection
ai-guard/ner_service.py - NER engine
ai-guard/masqe_engine/ner.py - PII rules and spans
ai-guard/masqe_engine/rules.py - Decision explanations
ai-guard/explain.py - Ghost Shell
ai-guard/ghost.py
Audit and policy state
- Policy and threat feed
gateway/config.go - Audit store
gateway/store.go - Tamper-evident chain
gateway/audit_chain.go - Telemetry and traces
gateway/telemetry.go
Security console
- Console application
dashboard/src/App.jsx - Operations view
dashboard/src/pages/Operations.jsx - Agent activity graph
dashboard/src/pages/AgentGraph.jsx - Events and trace
dashboard/src/pages/Events.jsx - Incident workflow
dashboard/src/pages/Incidents.jsx - Policy view
dashboard/src/pages/PolicyPage.jsx - Ghost sessions
dashboard/src/GhostShell.jsx - Console API client
dashboard/src/lib.js
Other components
- User
- Agent or tool
Connections 33
- User → Agent or tool: requests action
README.md - Agent or tool → Python SDK: submits action
sdk/python/masqe_sdk.py - Agent or tool → MCP proxy: uses proxy
README.md - Python SDK → HTTP gateway: sends request
sdk/python/masqe_sdk.py - MCP proxy → HTTP gateway: proxies actions
README.md - HTTP gateway → Decision engine: routes requests
README.md - Decision engine → Deterministic guards: checks policy
README.md - Decision engine → Semantic scoring: requests scores
README.md - Decision engine → PII detection: requests detection
README.md - PII detection → NER engine: detects spans
ai-guard/ner_service.py - NER engine → PII rules and spans: uses rules
ai-guard/masqe_engine/ner.py - Decision engine → Action execution: runs permitted action
README.md - Action execution → Decision engine: returns result
README.md - Decision engine → Ghost Shell: isolates untrusted code
README.md - Decision engine → Decision explanations: requests explanation
README.md - Decision engine → Policy and threat feed: loads policy
README.md - Decision engine → Audit store: records decisions
README.md - Audit store → Tamper-evident chain: appends audit entry
README.md - Decision engine → Telemetry and traces: reports timings
README.md - Console application → Console API client: uses API client
dashboard/src/App.jsx - Console application → Operations view: renders view
dashboard/src/App.jsx - Console application → Agent activity graph: renders view
dashboard/src/App.jsx - Console application → Events and trace: renders view
dashboard/src/App.jsx - Console application → Incident workflow: renders view
dashboard/src/App.jsx - Console application → Policy view: renders view
dashboard/src/App.jsx - Console application → Ghost sessions: renders view
dashboard/src/App.jsx - Console API client → HTTP gateway: calls API
dashboard/src/lib.js - Agent activity graph → Console API client: loads audit stream
dashboard/src/pages/AgentGraph.jsx - Operations view → Console API client: shows runtime metrics
README.md - Events and trace → Console API client: shows audit events
README.md - Incident workflow → Console API client: manages incidents
README.md - Policy view → Console API client: reads policy
README.md - Ghost sessions → Console API client: shows recordings
README.md