Tone
Inline tone metadata for the presentation. Use 'id' to reference a tones catalog record and override selected fields, or use 'name' for a custom inline tone.
Metadata
#/$defs/Tone
object | object
spec/schemas/opf.schema.json
Fields
| Field | Type | Req | Description |
|---|---|---|---|
| id | string | — | Optional tones catalog id to resolve before applying inline overrides. |
| name | string | — | Human-readable tone name shown in pickers. |
| summary | string | — | One-sentence positioning of the tone. |
| description | string | — | Longer prose describing the tone and the kinds of decks it suits. |
| voiceCues | array<string> | — | Short directives that shape AI generation toward this tone. |
| avoid | array<string> | — | Anti-patterns that AI generation should not produce when this tone is active. |
| samplePhrases | array<string> | — | Short example phrases that exemplify this tone. |
| recommendedNarratives | array<string> | — | Soft cross-link: narrative-catalog ids this tone pairs well with. |
| tags | array<string> | — | Free-form labels for filtering and search. |
id
Type: string · Optional · Default: — · Pattern: ^[a-z][a-z0-9-]*$
Optional tones catalog id to resolve before applying inline overrides.
{
"id": "formal"
}name
Type: string · Optional · Default: —
Human-readable tone name shown in pickers.
{
"name": "name-value"
}summary
Type: string · Optional · Default: —
One-sentence positioning of the tone.
{
"summary": "summary-value"
}description
Type: string · Optional · Default: —
Longer prose describing the tone and the kinds of decks it suits.
{
"description": "description-value"
}voiceCues
Type: array<string> · Optional · Default: —
Short directives that shape AI generation toward this tone.
{
"voiceCues": []
}avoid
Type: array<string> · Optional · Default: —
Anti-patterns that AI generation should not produce when this tone is active.
{
"avoid": []
}samplePhrases
Type: array<string> · Optional · Default: —
Short example phrases that exemplify this tone.
{
"samplePhrases": []
}recommendedNarratives
Type: array<string> · Optional · Default: —
Soft cross-link: narrative-catalog ids this tone pairs well with.
{
"recommendedNarratives": []
}