---
title: "Settings v2 and events schema v2"
date: "2026-04-09"
---

## Settings v2

The TOML configuration format has been redesigned for clarity and consistency. Settings are now organized into logical sections (`[run]`, `[server]`, `[cli]`, `[hooks]`, `[sandbox]`, `[mcp]`) with typed fields throughout. Run goals can now reference external files using a tagged union syntax, so you can keep large goal prompts separate from your workflow config.

```toml
[run]
goal = { file = "goals/deploy-review.md" }
model = "claude-sonnet-4-6"

[server]
host = "127.0.0.1"
port = 8080
```

Comments in your `settings.toml` are now preserved when Fabro edits the file during setup and registration.

## Events schema v2

The event wire format has been flattened and enriched. Each event envelope now carries stage scope (visit count, parallel group and branch IDs) and actor information directly, rather than requiring consumers to reconstruct context from surrounding events. The TypeScript API client has been regenerated to match.

## More

<Accordion title="Improvements">
- Server auth resolver now fails closed instead of panicking on unexpected states
- Config parse errors now include the file path for easier debugging
</Accordion>
