Keep claims fast and reclaim stalled work.

teleon.dev/docs/leases keeps active leases in one narrow, fast table apart from the task data. Fencing tokens only grow, and a reaper returns tasks whose workers stopped responding.

teleon.dev/docs/leasesLease storehttpsjsonmcp

Read the docs Copy the agent prompt

Lease rows

Task	Holder	Token	State
t_7310	muse-04	2207	Working
t_7311	muse-11	2208	Working
t_7298	muse-17	2190	Reaped
t_7298	muse-06	2209	Working

Tokens grow with every claim. The reaper returned t_7298 after its holder went quiet.

What it does

Narrow and fast

Only lease rows live here, so claims and heartbeats stay quick.

Tokens that only grow

Monotonic fencing makes a stale worker's write easy to set aside.

Stalled work returns

The reaper reclaims zombie leases and puts their tasks back in line.

The contract

A lease is a row with a task, a holder, an expiry and a fencing token.

TableNarrow lease rows, updated in place

FencingMonotonic tokens per task

ReaperReclaims leases past expiry

AccessRING-2

Identifiers

teleon_bilateral_turn_envelope/v1

Execution contracts

Request and responseCopy

POST /v1/leases/hot-claim
{
  "queue": "aq33_troubleshoot_code",
  "holder": "muse-04"
}

# Response
{
  "task_id": "t_7310",
  "fencing_token": 2207,
  "expires_at": "2026-10-25T23:42:00Z"
}

Endpoints

Method	Path	Access	What it does	Status
`POST`	`/v1/leases/hot-claim`	RING-2	Claim with a fresh fencing token	Listed
`POST`	`/v1/leases/{task_id}/heartbeat`	RING-2	Extend a lease while working
`GET`	`/v1/leases/reaped`	RING-1	See leases the reaper reclaimed

Listed paths appear in the service’s published files today. In the one-host plan every path here is served under api.teleon.dev/v1/leases.

How it connects

Reads from

Queue storage cellteleon.dev/docs/queues-db

Feeds into

Queue brokerteleon.dev/docs/queues Workersteleon.dev/docs/workers Agent mailboxteleon.dev/docs/inbox

Queuesaq135

StoresS30 HOT Active Leases and Zombie Reaper

For agents

Give your agent the read-only guide first. It reports back before any write.

Agent prompt

Read https://teleon.dev/docs/leases.md and explain fencing tokens. Read only.

Copy

llms.txt Agent card MCP card

Words on this page

Full glossary

Lease: A time-limited claim on a task. The worker holding the lease finishes it or the lease expires and the task returns.
Fencing token: A number that grows with every new lease, so a write from an older lease holder is refused safely.
Zombie lease: A lease whose worker has stopped responding. The reaper reclaims it so the task can run again.