Graphorin API reference v0.15.1

---

Graphorin API reference / @graphorin/core / / AgentModelFellbackEvent

Interface: AgentModelFellbackEvent

Defined in: packages/core/src/types/agent-event.ts:404

Stable

Emitted exactly once per agent-level model-fallback transition. Identifies the failed primary, the next model in Agent.fallbackModels, the eligible reason taxonomy, the 1-based step number and the 1-based attempt index within the step.

The event fires BEFORE the new model's stream starts so that observers see the transition before any of the new model's subsequent events flow.

Properties

Property	Modifier	Type	Defined in
agentId	readonly	string	packages/core/src/types/agent-event.ts:408
attempt	readonly	number	packages/core/src/types/agent-event.ts:413
from	readonly	string	packages/core/src/types/agent-event.ts:409
reason	readonly	"rate-limit" | "capacity" | "context-length" | "transient"	packages/core/src/types/agent-event.ts:411
runId	readonly	string	packages/core/src/types/agent-event.ts:406
sessionId	readonly	string	packages/core/src/types/agent-event.ts:407
stepNumber	readonly	number	packages/core/src/types/agent-event.ts:412
to	readonly	string	packages/core/src/types/agent-event.ts:410
type	readonly	"agent.model.fellback"	packages/core/src/types/agent-event.ts:405