Raft-based · strongly consistent

Consensus & Coordination
as a Service

Fiducia is a Raft-replicated control plane for distributed systems andAI-agent fleets. Hand off the hard parts of coordination —mutual-exclusion locks, semaphores,rate limiting, shared state,service discovery, elections, andcron — to an API that is consistent, fault-tolerant, and always exactly one source of truth.

$ curl -X POST https://api.fiducia.cloud/v1/locks/acquire \
    -d '{"key":"orders/checkout","ttl":"30s"}'

 {
  "acquired": true,
  "fencing_token": "00000000-1F4A",
  "lease_expires": "2026-06-26T19:41:12Z",
  "quorum": "3/5 committed"
}
<5msMedian commit latency
99.99%Control-plane availability
f / 2f+1Tolerates minority node loss
1Source of truth, always
What Fiducia does

Coordination primitives,
delivered as an API

Stop running your own ZooKeeper or etcd cluster. Fiducia gives you the coordination primitives distributed systems fight over most — locks, limits, schedules, config, elections, and discovery — built on a single consistent core.

Locks & Semaphores

Fencing-token mutexes with automatic lease expiry — exactly one holder across your whole fleet — plus counting semaphores when you need up to N concurrent holders.

  • Mutex (one holder) or semaphore (N holders)
  • Fencing tokens to defeat stale holders
  • TTL leases with auto-release on crash
  • Blocking & try-lock, fair FIFO queues

Rate Limiting

Distributed token-bucket and sliding-window limiters that share a single source of truth, so a quota is enforced consistently no matter which replica answers.

  • Token-bucket & sliding-window algorithms
  • Atomic check-and-decrement
  • Per-key, per-tenant quotas
  • Sub-millisecond decisions at the edge

Cron & Scheduling

A replicated scheduler that survives leader failure. Schedule recurring or one-shot jobs and get at-least- or exactly-once delivery with durable history.

  • Standard cron expressions & one-shots
  • Leader-elected, no duplicate fires
  • Durable run history & retries
  • Webhook, queue, or gRPC targets

Config KV & Watches

A linearizable, versioned key/value store for configuration and feature flags. Watch a key or prefix and get changes pushed the instant they commit — no polling, no drift.

  • Versioned keys with compare-and-swap
  • Watch streams for keys & prefixes
  • TTL keys with automatic expiry
  • A consistent read, every node

Leader Election

Run your own elections on top of Fiducia. Campaign for a named leadership, hold it with a TTL lease, and step down cleanly — with a fencing token to defeat the stale leader you forgot about.

  • Campaign, renew & resign semantics
  • Fencing tokens against stale leaders
  • Lease auto-release on crash
  • Observe & watch leadership changes

Service Discovery

Register service instances with a heartbeat lease and look up only the ones that are actually alive. Crashed instances drop out on their own — no stale endpoints, no manual cleanup.

  • TTL-health register & heartbeat
  • Live instance lookup by service
  • Watch streams for add/remove events
  • Metadata & address per instance
AI agent coordination

Give your agent fleet
one source of truth

Autonomous agents run in parallel, retry, crash, and fork. The moment two of them touch the same task, budget, tool, or memory, they need the same correctness primitives as distributed databases.

Claim work once

Hand a job to a fleet and exactly one worker claims it. A fencing-token lock with a TTL lease keeps crashed, forked, or retried agents from double-booking work.

  • Idempotent task claims — no duplicate work or actions
  • Leases auto-release when an agent hangs or dies
  • Fencing tokens defeat stale retried workers
  • Exactly one result commits for each logical task

Gate scarce tools

Put browser sessions, GPUs, paid APIs, inboxes, sandboxes, deploy lanes, and model providers behind one global limiter instead of per-replica counters that drift.

  • Fleet-wide token buckets for LLM and tool rate limits
  • Atomic spend and quota checks per tenant
  • Semaphores cap concurrent calls to fragile tools
  • Back-pressure instead of 429 storms and overage bills

Elect supervisors

Run one planner, reviewer, compactor, or release coordinator at a time, backed by a consistent KV blackboard that pushes watched state changes as soon as they commit.

  • Leader election for a single active supervisor
  • Watch streams for step results and handoffs
  • Compare-and-swap prevents shared-state clobbering
  • Service discovery tracks live agents and tools
Coordination, not cognition

Put each responsibility in the right layer

Fiducia coordinates agent processes. It does not plan tasks, choose models, store transcripts, judge semantic correctness, or prevent hallucinations.

Run the reference fleet
1 · Durable workflow layerPostgres · queue · object store · vector DB

Tasks, prompts, transcripts, artifacts, embeddings, and run history.

2 · Fiducia coordination layerLeases · fencing · elections · quotas · watches

Shared authority, finite capacity, liveness, failover, and no-duplicate scheduling.

3 · Agent worker layerPlanner · coder · researcher · reviewer

Reasoning, tool execution, output validation, and human escalation.

Task claim → lease renewal → fenced durable commit
loop {
  let claim = fiducia.claim(task_id, worker_id, lease_ttl).await?;
  while work.is_running() {
    fiducia.renew(task_id, claim.fencing_token).await?;
    work.advance_one_safe_step().await?;
  }
  durable_store.commit_if_fence_is_current(
    task_id,
    claim.fencing_token,
    work.result(),
  ).await?;
}

Exactly-once external effects still require the target system to enforce a fencing token or stable idempotency key.

Under the hood

Many Raft groups, one guarantee

Every Fiducia operation is a committed entry in its shard’s replicated log. That is what turns “probably locked” into “provably locked” — and what lets the cluster scale out instead of up.

1

Sharded log

The keyspace is split into shards, and each shard is its own Raft group. Every lock, key, or schedule is an entry in its shard’s replicated log.

2

A leader per shard

Each shard elects its own leader, so leadership — and write throughput — spreads across the whole cluster instead of funneling through one node.

3

Quorum commit

An operation is acknowledged only once a majority of its shard has durably stored it — so a committed lock or job survives node loss.

4

A brain that scales it

A control plane watches every node, re-places shards off failed ones, and adds or drains capacity automatically — the cluster heals and grows on its own.

Cluster5 nodes · 3 AZ
Shards256 · RF 3
Leadershipnode-2 · 52 shards
Commit index1,884,209
Active locks12,704
Failover< 250ms
Why it matters

Coordination is easy to get
subtly, dangerously wrong

A Redis SETNX lock without fencing, a cron that double-fires after a deploy, a rate limiter that drifts between replicas — these are the bugs you find in production. Fiducia makes correctness the default. It is crash-fault tolerant (CFT), not Byzantine: it assumes your own nodes can crash, never that they lie.

No split brain

A network partition can never elect two leaders. The minority side stops serving writes rather than diverge — so two clients never hold the same lock.

Crash-safe by construction

A lock acknowledged by Fiducia is durable on a majority of nodes. Lose a replica — or a whole availability zone’s minority — and committed state stays put.

Exactly-once where it counts

Leader-elected scheduling means a cron job fires once, not once per replica, even across rolling deploys and failovers.

Make coordination someone else’s problem

Point your services or agent fleet at one endpoint and get locks, limits, task claims, elections, KV watches, and schedules backed by a consensus you don’t have to operate.