Skip to main content

Interface: SessionSendStructuredResult<T>

Defined in: packages/agentos/src/api/agent.ts:230

Result returned by AgentSession.send when responseSchema is set. Extends GenerateTextResult with a typed Zod-validated object.

Extends​

Type Parameters​

T​

T

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.

Inherited from​

GenerateTextResult.agentCalls

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.

Inherited from​

GenerateTextResult.finishReason

model​

model: string

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

Resolved model identifier used for the run.

Inherited from​

GenerateTextResult.model

object​

object: T

Defined in: packages/agentos/src/api/agent.ts:232

Zod-validated typed object.

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.

Inherited from​

GenerateTextResult.parsed

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.

Inherited from​

GenerateTextResult.plan

provider​

provider: string

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

Provider identifier used for the final run.

Inherited from​

GenerateTextResult.provider

text​

text: string

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

Final assistant text after all agentic steps have completed.

Inherited from​

GenerateTextResult.text

toolCalls​

toolCalls: ToolCallRecord[]

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

Ordered list of every tool call made during the run.

Inherited from​

GenerateTextResult.toolCalls

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.

Inherited from​

GenerateTextResult.trace

usage​

usage: TokenUsage

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

Aggregated token usage across all steps.

Inherited from​

GenerateTextResult.usage