---
title: "Speculation tool gate"
description: "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."
type: "living"
source: "crates/voice_gateway/extensions/fox9-refork/README.md"
verified: "2026-11-14"
group: "The brain"
---

> **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`.


