Clearing Primitives

Work

A unit of value to be done — a lead, a ticket, an AI task, an order. The cargo the clearing lifecycle carries.

Work is a unit of value to be done — Work (Routable) in the API. It is cargo-agnostic by design: a lead, a support ticket, an AI task, an order, an inference request. The cargo changes; the machine does not. A Routable carries a free-form type string and a payload, not a hardcoded schema, so one pipeline clears every kind of work.

Work enters a pool — a market with rules: eligibility criteria, capacity budgets, SLA targets, dedup windows, quality gates, and a market mechanism. Before it is priced or routed, the trust plane runs — fraud scoring, deduplication, consent validation, quality scoring — so bad work is rejected or flagged before it costs anyone money.

Status
shipping — Routable and pools exist today.

Lifecycle

When work is cleared through a market, its session moves through MarketSessionStatus:

MarketSessionStatus
open → soliciting

The market is created and workers are being solicited to bid.

MarketSessionStatus
collecting_bids → clearing

Bids arrive and are cleared by the session's algorithm.

MarketSessionStatus
cleared → committed

A winner is selected and the routing decision is committed.

MarketSessionStatus
expired · cancelled · failed

Off-ramps when no clearing is possible.

Where to go deeper