Class

Structured Value

Abstract marker class for key-value / list / scalar data. Subclassed by StructuredMap, StructuredList, StringScalar, and IntegerScalar. Used for Document.metadata and for any nested data inside it. Distinct from Block/Inline so frontmatter/TOML/JSON backends can walk metadata recursively without needing to understand narrative block types. As of 1.3.0 StructuredValue is an EscapeHintable: a value may carry its own `escapeHint` directly. This is what lets a scalar *inside a StructuredList* be serialized with a type hint — a list item has no enclosing StructuredEntry to carry the hint for it.

Class
Subclass Of
Escape-Hintable

Referenced by

← Range

Object PropertyItemsThe ordered elements of a StructuredList.
Object PropertyValueThe value of a StructuredEntry. May be a scalar, list, or nested map.

← Subclass Of

ClassInteger ScalarAn integer leaf value. Serialized as a bare numeric literal by all backends (no quoting). Used for fields like an agent's `maxTurns`.
ClassString ScalarA string leaf value. Carries the raw unescaped string in `stringValue`. The containing StructuredEntry's `escapeHint` controls how backends serialize it.
ClassStructured ListAn ordered collection of StructuredValues. Used for array-valued metadata fields (e.g., an agent's `tools` list). Backends serialize this as a YAML flow…
ClassStructured MapAn ordered key-value collection. Entry order is significant and is preserved from the author's specification through to the output file. Backends that produce…