(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
Expressive State Guide (PGM-ESG)
- Is produced by the State Adaptation (SAD) AIM.
- Encapsulates expressive cues, user engagement signals, and modulation constraints derived from the User’s current state and interaction context.
- Is consumed by Personality Alignment (PAL) to adapt tone, style, and affect in alignment with the User’s Personal Status.
Functional Requirements
Expressive State Guide conveys the following main information elements:
| Function | Description |
| User State Embedding | Includes current user engagement, affective posture, and interaction mode. Supports modulation of expressive stance in PAL. |
| Expressive Cue Structuring | Includes tone, style, and pacing preferences derived from SAD. Supports expressive coherence across modules. |
| Modulation Constraints | Includes semantic or behavioural constraints relevant to expressive adaptation. Supports filtering or prioritisation in PAL’s modulation logic. |
| Alignment Tags | Includes high-level descriptors of expressive alignment (e.g., “needs reassurance”, “prefers directness”). Supports adaptive personality framing. |
| Traceability | Includes origin metadata and timestamp for audit and replay. |
Syntax
https://schemas.mpai.community/PGM1/data/V1.0/ExpressiveStateGuide.json
Semantics
| Label | Description |
| Header | Expressive State Guide Header |
| ├─ Standard-ESG | The characters “PGP-ESG-V” |
| ├─ Version | Major version – 1 or 2 characters |
| ├─ Dot-separator | The character “.” separating version components |
| └─ Subversion | Minor version – 1 or 2 characters |
| GuideID | Unique identifier for this Expressive State Guide instance |
| UserState | Snapshot of user’s current engagement and affective posture |
| ├─ EngagementLevel | e.g., passive, active, exploratory |
| ├─ AffectiveTone | e.g., calm, frustrated, curious |
| └─ InteractionMode | e.g., voice, text, gesture |
| ExpressiveFrame | Modulation cues for tone, style, and pacing |
| ├─ Tone | empathetic, assertive, playful, formal, neutral |
| ├─ Style | concise, elaborate, technical, casual |
| └─ Pacing | slow, steady, fast |
| ModulationConstraints | Constraints shaping expressive adaptation |
| ├─ ConstraintType | e.g., avoid humor, emphasise clarity |
| └─ ConstraintValue | Boolean or string |
| AlignmentTags | High-level descriptors of expressive alignment |
| └─ Tags | e.g., “needs reassurance”, “prefers directness”, “avoid ambiguity” |
| Trace | Provenance metadata |
| ├─ Origin | Module or subsystem that generated the guide |
| └─ Timestamp | Time of creation (conforming to Time.json) |