Skip to content
Vulpine
Esc
↑↓navigate↵open⌘Jpreview

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 retired gate 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.

Was this page helpful?