Skip to main content

Interface: KeyState

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:18

One key's standing in a pool. fingerprint and label identify the key without holding it.

Properties​

failures​

failures: number

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:30

Consecutive auth or billing failures since the last success; sets the recheck delay.

fingerprint​

fingerprint: string

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:20

A short non-reversible digest of the key, the row's identity in a store.

kind?​

optional kind: KeyFailureKind

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:26

The kind of the last failure, set while resting or failed.

label​

label: string

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:22

k<index> plus the key's last four characters, for log lines.

lastFailAt?​

optional lastFailAt: number

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:34

The start time of the last request that failed with this key.

lastOkAt?​

optional lastOkAt: number

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:32

The start time of the last request that succeeded with this key.

nextRecheckAt?​

optional nextRecheckAt: number

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:36

When the next probe of a failed key may run (epoch ms).

status​

status: "failed" | "ok" | "resting"

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:24

ok: hand out freely. resting: a quota rest until until. failed: out until a probe passes or a recheck re-admits it.

until?​

optional until: number

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:28

When a quota rest ends (epoch ms).

updatedAt​

updatedAt: number

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:38

When this state was last changed (epoch ms); a store keeps the newest.

version​

version: 1

Defined in: packages/agentos/src/core/providers/KeyPoolStateStore.ts:40

The record's shape version; a store ignores other versions.