interlens.stop.conditions¶

Bases: StopCondition

Stop once seconds of wall-clock have elapsed since the run started (monotonic clock).

69
70
71

def __init__(self, seconds: float):
	self.seconds = seconds
	self.start = None

Bases: StopCondition

Stop when a committed message's visible content contains any of the given strings (a done-signal).

85
86

def __init__(self, strings):
	self.strings = [strings] if isinstance(strings, str) else list(strings)

Bases: StopCondition

A per-conversation compute budget — the matched-compute primitive for fair solo-vs-pair comparisons.

per_conversation stops a conversation once ITS OWN cumulative generated tokens reach the budget, and per_turn caps each individual turn so the allowance is spread across real conversation turns rather than consumed by one monologue. Both are enforced via turn_cap too: the run loop shrinks the next generation to min(speaker cap, per_turn, per_conversation - spent), so the budget is respected without overshoot.

The budget is per-conversation, not a shared pool. Spend is read from the conversation's own transcript (metadata['n_tokens']), so the condition is stateless — in a rollout of N copies, each copy independently gets the full budget. Cheap to count (never re-tokenizes) and trivially picklable, so it works installed directly (run_until=TokenBudget(...)) or ambiently (with TokenBudget(per_conversation=200): conv.rollout()).

113
114
115
116
117

def __init__(self, per_conversation: int | None = None, per_turn: int | None = None):
	if per_conversation is None and per_turn is None:
		raise ValueError("TokenBudget needs at least one of per_conversation= or per_turn=")
	self.per_conversation = per_conversation
	self.per_turn = per_turn

Bases: StopCondition

Stop once the total generated tokens across turns reach max_tokens.

The per-turn count comes from Message.metadata['n_tokens'], which ModelParticipant.generate records — so the source of truth is defined, not guessed. Turns without a count (e.g. seeded messages) contribute 0.

54
55
56

def __init__(self, max_tokens: int):
	self.max_tokens = max_tokens
	self.total = 0

Bases: StopCondition

Stop after max_turns committed turns.

35
36
37

def __init__(self, max_turns: int):
	self.max_turns = max_turns
	self.count = 0