Skip to main content

Interface: GenerateTextResult

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

The completed result returned by generateText.

Extended by​

Properties​

agentCalls?​

optional agentCalls: AgentCallRecord[]

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

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:493

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.

grounding?​

optional grounding: VerifiedResponse

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

Per-claim citation verdicts attached when agent({ verifyCitations: … }) is configured. undefined when verification was not requested or could not run for this turn.

See​

import('./types.js').VerifyCitationsConfig

model​

model: string

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

Resolved model identifier used for the run.

parsed?​

optional parsed: unknown

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

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:513

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:477

Provider identifier used for the final run.

text​

text: string

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

Final assistant text after all agentic steps have completed.

toolCalls​

toolCalls: ToolCallRecord[]

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

Ordered list of every tool call made during the run.

trace?​

optional trace: AgencyTraceEvent[]

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

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:483

Aggregated token usage across all steps.