Skip to main content

Interface: GenerateTextResult

Defined in: packages/agentos/src/api/generateText.ts:378

The completed result returned by generateText.

Extended by​

Properties​

agentCalls?​

optional agentCalls: AgentCallRecord[]

Defined in: packages/agentos/src/api/generateText.ts:401

Ordered records of every sub-agent call made during an agency() run. undefined for plain generateText / agent() calls.

finishReason​

finishReason: "error" | "length" | "stop" | "tool-calls"

Defined in: packages/agentos/src/api/generateText.ts:396

Reason the model stopped generating.

  • "stop" — natural end of response.
  • "length" — maxTokens limit reached.
  • "tool-calls" — loop exhausted maxSteps while still calling tools.
  • "error" — provider returned an error.

model​

model: string

Defined in: packages/agentos/src/api/generateText.ts:382

Resolved model identifier used for the run.

parsed?​

optional parsed: unknown

Defined in: packages/agentos/src/api/generateText.ts:411

Parsed structured output produced when BaseAgentConfig.output is a Zod schema. undefined when no output schema is configured.

plan?​

optional plan: Plan

Defined in: packages/agentos/src/api/generateText.ts:416

The plan produced by the planning phase when planning is enabled. undefined when planning is disabled or was not requested.

provider​

provider: string

Defined in: packages/agentos/src/api/generateText.ts:380

Provider identifier used for the final run.

text​

text: string

Defined in: packages/agentos/src/api/generateText.ts:384

Final assistant text after all agentic steps have completed.

toolCalls​

toolCalls: ToolCallRecord[]

Defined in: packages/agentos/src/api/generateText.ts:388

Ordered list of every tool call made during the run.

trace?​

optional trace: AgencyTraceEvent[]

Defined in: packages/agentos/src/api/generateText.ts:406

Structured trace events emitted during the run. Populated by the agency orchestrator; undefined for single-agent calls.

usage​

usage: TokenUsage

Defined in: packages/agentos/src/api/generateText.ts:386

Aggregated token usage across all steps.