Interface: IRunOutcome

Defined in: internal/llm-client/types.ts:233

Outcome of a run: finished, paused for a human, or aborted by the caller's signal (D90).

Properties

endedByTool?

optional endedByTool?: string

Defined in: internal/llm-client/types.ts:272

Name of the tool that ended the run (D86), when a tool did.

Tells the caller the run stopped because a terminal tool ran, not because the model chose to answer.

Set with DONE: after the tool's step the model got one last step without tools to phrase the answer. Also set when the limits cut the run before that final step (finishReason LENGTH).

---

messages

messages: IMessage[]

Defined in: internal/llm-client/types.ts:242

All messages of the run so far; persisted by the gateway into the RunStore. When ABORTED: the steps that completed, so the tools that ran stay on record; a tool call cut by the abort has no result.

---

pendingCalls?

optional pendingCalls?: IPendingCall[]

Defined in: internal/llm-client/types.ts:251

Present when PAUSED: the tool calls of the step waiting for a human, in request order, never empty.

Every call the policy held back, with what the model reads on a rejection and why the call waits.

A parallel run (D101) decided every call of the step before pausing, so the list holds all of them; a sequential run stops at the first and the list holds one.

---

result?

optional result?: IModelResult

Defined in: internal/llm-client/types.ts:237

Present when DONE.

---

status

status: ERunOutcomeStatus

Defined in: internal/llm-client/types.ts:235

How the run ended: DONE, PAUSED for a human, or ABORTED by the caller's signal.

---

steps

steps: number

Defined in: internal/llm-client/types.ts:253

Model calls performed in this invocation.

---

traceIds

traceIds: string[]

Defined in: internal/llm-client/types.ts:257

One trace entry per step; the gateway annotates all of them.

---

usage

usage: IUsage

Defined in: internal/llm-client/types.ts:255

Sum over all steps.

---

usageDenied?

optional usageDenied?: IUsageDeniedErrorData

Defined in: internal/llm-client/types.ts:263

Present when the usage adapter refused a step after the first: the run is DONE with finishReason LENGTH and the text so far.

The steps before it stand, their tools have had their effects; the gateway reports the refusal as a WARNING issue.