Module pin 

ClientFrame::Pin (synaps daemon pin <ID|NAME> [--off]): pin or unpin one session from a control connection, without attaching to it.

The daemon sends the session KeepWarm{on} with host authority (from: None), so the actor’s own handling runs unchanged: pinning a parked session unparks it, unpinning one leaves it parked. The answer comes from the handle’s pin cell, which the actor writes when it applies the command; no reply event to match.

Constants

PIN_BUDGET

How long the daemon waits for the actor to apply the pin (queue latency).

PIN_UNPARK_BUDGET

Pinning a parked session rebuilds its runtime first (MCP servers, extensions), which can take longer than PIN_BUDGET.

Functions

pin_session

Serve Pin{session_id, on}. Always answers with one frame: Pinned, Refused{Busy|UnknownSession} or Error.