Speculation tool gate
The side-effect gate for speculative brain dispatch. Each client-owner attachment has its own private gate file, in an owner-only directory per owner and generation.
Living doc, checked against the code 2026-11-14
fox9-refork — speculation tool gate
The gateway passes its path to the owned Pi child as
VULPINE_SPECULATION_GATE. The gate reads hold while an unpromoted speculative generation is in flight, open
otherwise, and retired once the attachment is gone. The extension reads it on every Pi tool_call:
open→ the call proceeds (promotion sets it).hold→ the call parks, polling, until the state changes.- Refork/cancel aborts the generation → the parked call dies with it.
- A hold that never clears blocks the call at the wait bound (default 10s) with an explicit refusal reason. It fails closed.
- No gate path, a missing, malformed, non-private or
retiredgate refuses the call.
The gateway loads the extension itself for every owner-attached brain, from the bundled extension root; no loadout or
tool allowlist can drop it. With [speculation] disabled the gate stays open.