← Schema index / Config Reference

beads schema

Canonical generated docsThis section is generated from caco config schema --json. The table below preserves the runtime field path, type, required/default markers, and canonical description for every value in this slice.

Cluster-wide beads primary routing and automatic failover policy.

Field pathTypeRequiredDefaultCanonical description
beadssectionoptionalCluster-wide beads primary routing and automatic failover policy.
└ beads.primarystring | map | list[string|map]optionalOrdered authoritative-host preference. Legacy string entries keep in-process daemon mode; object entries declare standalone caco-bd-daemon listeners (for example `{ node = "helsinki", port = 11101, cluster_port = 12101 }`).
└ beads.failovermapoptionalAutomatic failover policy.
└ beads.failover.afterdurationoptionalDuration after which automatic primary promotion may begin (e.g. '5m').
└ beads.failover.reclaim_unavailable_agents_afterdurationoptionalGlobal default reclaim timer for agent-owned beads on unavailable nodes.
└ beads.rewritemapoptionalLLM-powered bead rewrite and post-creation refinement configuration.
└ beads.rewrite.modelstringoptionalsmartLLM alias for rewriting and refinement (indexes into top-level llm map).
└ beads.expandmapoptionalLLM-powered free-form text and Quickfile expansion configuration. Omission inherits beads.rewrite.model, then legacy llm.fast.
└ beads.expand.modelstringoptionalsmartLLM alias for every text-to-beads expansion surface (indexes into top-level llm map).