Skip to main content

handle_muxspect_dock_clear

agentmux_srv::server::muxspect_handlers

Function handle_muxspect_dock_clear 

Source 
pub async fn handle_muxspect_dock_clear(
    __arg0: State<AppState>,
    __arg1: Json<MuxspectDockClearRequest>,
) -> impl IntoResponse
Expand description

POST /api/v1/muxspect/dock/clear — validates node_id is a currently tracked node for block_id (per the cache — see docs/specs/SPEC_MUXSPECT_DOCK_DIAGNOSIS_AND_REMEDIATION_2026_08_06.md §3.2), then publishes EVENT_DOCK_CLEAR scoped to block:<id>. Only a renderer currently displaying that block and still holding that node ever receives or acts on it (real server-side scope routing, not client-side self-filtering — same mechanism EVENT_SHELL_NODE_CREATE already uses). Returns 404 if the node isn’t in the cache — either it was never pushed, or it already resolved/was already cleared; either way there’s nothing to do.