Structured Outputs

Operator calls generateObject with mode:'auto' against a provider that does not support JSON mode; output silently degrades to free-form text wrapped in {}.

mode:'auto' picks the best-supported strategy per provider (JSON mode where available, tool-call otherwise). For deterministic enforcement, pin mode:'json' (requires provider JSON-mode support) or mode:'tool' (uses a hidden tool whose parameters are the schema). Verify the chosen mode in provider d…

generateObject with a Zod schema produces wrong-shape output more than 10% of the time. Operator pinned mode:'tool' but omitted schemaName and schemaDescription.

Set `schemaName: 'invoice'` and `schemaDescription: 'Structured invoice extracted from the user message'`. These names propagate to the underlying tool/JSON-mode call so the model has a concrete label — without them the SDK uses generic defaults that hurt accuracy.

Operator needs an array of invoice line items as the root. Uses schema = z.array(LineItem) with default output.

Default output is 'object' which requires the root to be a Zod object. For array roots, pass `output:'array'` AND `schema: LineItem` (the element schema, not the array). The SDK wraps it and returns result.object as the array. For enums use output:'enum' with `enum:['a','b','c']`.