Skip to main content

Type Alias: ActionLimitAnswer

ActionLimitAnswer = { expiresAt?: number; status: "reserved"; cancel?: Promise<void>; commit: Promise<void>; release: Promise<void>; renew?: Promise<void>; } | { reason: "limit_reached" | "duplicate" | "in_flight" | "retries_exhausted" | "unresolvable"; ruleId?: string; status: "denied"; }

Defined in: packages/agentos/src/safety/runtime/ActionLimiter.ts:25

A limiter's answer: every rule reserved one unit, or one rule refused and nothing stays reserved.

Type Declaration​

{ expiresAt?: number; status: "reserved"; cancel?: Promise<void>; commit: Promise<void>; release: Promise<void>; renew?: Promise<void>; }

expiresAt?​

optional expiresAt: number

When the earliest of the reservations runs out of its lease, epoch milliseconds. A limiter without leases leaves it out.

status​

status: "reserved"

cancel()?​

optional cancel(): Promise<void>

Gives the units back for an action whose tool never started, without counting an attempt. A limiter without it is released instead.

Returns​

Promise<void>

commit()​

commit(): Promise<void>

Returns​

Promise<void>

release()​

release(): Promise<void>

Gives the units back: the action ran and failed, and the release counts as one of its attempts.

Returns​

Promise<void>

renew()?​

optional renew(): Promise<void>

Extends every reservation's lease by the limiter's lease from now, so a reconcile pass does not count an action whose tool is still running. A governed tool calls it while its tool runs. A reservation settled already is left as it is.

Returns​

Promise<void>

{ reason: "limit_reached" | "duplicate" | "in_flight" | "retries_exhausted" | "unresolvable"; ruleId?: string; status: "denied"; }

reason​

reason: "limit_reached" | "duplicate" | "in_flight" | "retries_exhausted" | "unresolvable"

ruleId?​

optional ruleId: string

status​

status: "denied"