How frankoslaw/stopslop works
StopSlop is an AI request-control product: clients send chat input through either a synchronous in-process transport or an HTTP gateway; policy enforcement evaluates input, manages permissions and quotas, forwards permitted requests, and checks replies. Separate capabilities include semantic classification, local or trusted fallback routing, policy administration, scripted demos, and a read-only operations dashboard. The graph follows documented and indexed relationships; unsampled implementation details are represented only where the README identifies the capability.
Main entry points: policy.py Policy enforcement · cli.py Chat demo · router.py SDK transport · app.py HTTP gateway
Components 25
Client entry points
- Runtime settings
packages/stopslop/src/stopslop/config.py - SDK transport
packages/stopslop/src/stopslop/router.py - HTTP gateway
packages/stopslop_proxy/src/stopslop_proxy/app.py
Policy and assessment
- Policy enforcement
packages/stopslop/src/stopslop/policy.py - Policy definition
packages/stopslop/src/stopslop/policy_file.py - Policy loading
packages/stopslop/src/stopslop/policy_loader.py - Policy formats
packages/stopslop/src/stopslop/policy_format.py - Policy schema
packages/stopslop/src/stopslop/policy_schema.py - Pattern detection
packages/stopslop/src/stopslop/rules.py - Semantic evaluation
packages/stopslop/src/stopslop/evaluators.py - Jev classifier
packages/stopslop/src/stopslop/jev.py - Laya classifier
packages/stopslop/src/stopslop/laya.py - Output controls
packages/stopslop/src/stopslop/output.py - Agent permissions
packages/stopslop/src/stopslop/permissions.py
Runtime state
- Quota and telemetry
packages/stopslop/src/stopslop/runtime.py - SQLite state
packages/stopslop/src/stopslop/repository.py
Operations and demo
- Policy administration
packages/stopslop/src/stopslop/adapt.py - Startup checks
packages/stopslop/src/stopslop/preflight.py - Chat demo
packages/stopslop_demo/src/stopslop_demo/cli.py - Demo scenarios
packages/stopslop_demo/src/stopslop_demo/scenarios.py - Demo progress
packages/stopslop_demo/src/stopslop_demo/spinner.py - Terminal dashboard
packages/stopslop_top/src/stopslop_top/top.py
Other components
- SDK client
- Gateway client
- Model provider
Connections 30
- SDK client → SDK transport: sends chat
README.md - Gateway client → HTTP gateway: posts chat
README.md - Runtime settings → SDK transport: configures
packages/stopslop/src/stopslop/router.py - Runtime settings → HTTP gateway: configures
packages/stopslop_proxy/src/stopslop_proxy/app.py - SDK transport → Policy enforcement: routes through
packages/stopslop/src/stopslop/router.py - HTTP gateway → Policy enforcement: routes through
packages/stopslop_proxy/src/stopslop_proxy/app.py - Policy enforcement → Policy loading: loads policy
packages/stopslop/src/stopslop/policy.py - Policy loading → Policy definition: constructs
packages/stopslop/src/stopslop/policy_loader.py - Policy loading → Policy formats: reads format
packages/stopslop/src/stopslop/policy_loader.py - Policy formats → Policy schema: normalizes
packages/stopslop/src/stopslop/policy_format.py - Policy definition → Policy schema: validates
packages/stopslop/src/stopslop/policy_file.py - Policy enforcement → Pattern detection: scans input
packages/stopslop/src/stopslop/policy.py - Policy enforcement → Semantic evaluation: assesses content
packages/stopslop/src/stopslop/policy.py - Jev classifier → Semantic evaluation: implements evaluator
packages/stopslop/src/stopslop/jev.py - Laya classifier → Semantic evaluation: implements evaluator
packages/stopslop/src/stopslop/laya.py - Policy enforcement → Output controls: checks replies
packages/stopslop/src/stopslop/policy.py - Policy enforcement → Agent permissions: authorizes operations
packages/stopslop/src/stopslop/policy.py - Policy enforcement → Quota and telemetry: reserves quota
packages/stopslop/src/stopslop/policy.py - Quota and telemetry → SQLite state: persists state
packages/stopslop/src/stopslop/runtime.py - SDK transport → Model provider: forwards request
README.md - HTTP gateway → Model provider: forwards request
README.md - Policy enforcement → Model provider: selects fallback route
README.md - Policy administration → Policy loading: updates policy
packages/stopslop/src/stopslop/adapt.py - Policy administration → SQLite state: stores overlay
packages/stopslop/src/stopslop/adapt.py - Chat demo → Runtime settings: loads settings
packages/stopslop_demo/src/stopslop_demo/cli.py - Chat demo → SDK transport: uses transport
packages/stopslop_demo/src/stopslop_demo/cli.py - Chat demo → Startup checks: checks readiness
packages/stopslop_demo/src/stopslop_demo/cli.py - Chat demo → Demo scenarios: runs scenarios
packages/stopslop_demo/src/stopslop_demo/cli.py - Chat demo → Demo progress: shows progress
packages/stopslop_demo/src/stopslop_demo/cli.py - Terminal dashboard → SQLite state: reads state
packages/stopslop_top/src/stopslop_top/top.py