Proxy
Filter pipeline state and dry-run evaluation.
| Method | Path | Summary | Flags |
|---|---|---|---|
| GET | /proxy/status | Filter stats, thresholds, and queue depth. | |
| POST | /proxy/test | Dry-run a tool call shape. Returns the would-be decision. | |
| POST | /proxy/evaluate | Internal IPC: evaluate a real syscall request. | IPC |
| GET | /proxy/status/full | Internal IPC: extended state including per-filter scores. | IPC |
GET /proxy/status
Public status: filter stats, current thresholds, queue depth.
{
"filters_enabled": 16,
"filters_total": 17,
"auto_allow_threshold": 3.0,
"auto_deny_threshold": 8.0,
"queue_depth": 2,
"decisions_last_minute": { "allow": 412, "queue": 3, "deny": 1 }
}
POST /proxy/test
Dry-run a tool call shape. Returns the would-be decision and full filter breakdown.
This is the REST equivalent of grith proxy test.
Request:
{
"operation": "file_read",
"target": "/home/you/.ssh/config"
}
Response:
{
"decision": "queue",
"composite_score": 4.2,
"filters": [
{
"name": "sensitive_path",
"score": 3.5,
"annotations": ["ssh-config"]
},
{
"name": "path_match",
"score": 1.2
}
]
}
POST /proxy/evaluate (IPC)
Internal endpoint used by thin-client supervisors to evaluate a real syscall. Authenticated by loopback origin only. Should not be called by user code.
GET /proxy/status/full (IPC)
Extended state including per-filter metrics, per-session counters, and recent decision histograms. Used by the dashboard.
See also
Last updated: 2026-05-14Edit this page on GitHub →