Graphorin API reference v0.15.1
Graphorin API reference / @graphorin/core / / RunStep
Interface: RunStep
Defined in: packages/core/src/types/run.ts:23
Stable
Single step inside an agent run. The agent runtime appends one RunStep per provider call.
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
agentId | readonly | string | Stable agent id active for this step (changes after a handoff). | packages/core/src/types/run.ts:32 |
endedAt? | readonly | string | - | packages/core/src/types/run.ts:26 |
finishReason? | readonly | FinishReason | Why the step's provider call ended ('stop', 'tool-calls', 'length', ...). 'length' on a completed run means the step's text may be truncated at the output-token ceiling. Absent on states persisted before this field existed. | packages/core/src/types/run.ts:39 |
providerResponse? | readonly | RunStepProviderResponse | The model response this step produced, recorded when the agent runs with recordProviderResponses: true. Enables deterministic replay: createReplayProvider(state) serves these back in order so a run re-executes without live model calls. | packages/core/src/types/run.ts:46 |
startedAt | readonly | string | - | packages/core/src/types/run.ts:25 |
stepNumber | readonly | number | - | packages/core/src/types/run.ts:24 |
toolCalls | readonly | readonly CompletedToolCall<unknown>[] | - | packages/core/src/types/run.ts:28 |
usage? | readonly | Usage | - | packages/core/src/types/run.ts:27 |