(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
User State is a structured semantic representation of the user’s cognitive, emotional, and attentional posture It captures engagement intensity, interaction mode, attentional focus, temporal orientation, and inferred intent – enabling A-User to adapt its responses, behaviours, and expressive stance in real time.
Functional Requirements
- Engagement Modeling
- Encodes both the Level (low, medium, high) and Mode (passive, interactive, directive) of user engagement.
- Supports modulation of agent pacing, expressiveness, and behavioural complexity.
- Attentional Focus
- Includes a Focus object with:
- TargetType: semantic category of the focus (object, zone, concept, actor)
- TargetID: identifier of the focused entity
- Guides context-aware reasoning, gesture alignment, and referential phrasing.
- Temporal Cue Interpretation
- Includes a TemporalCue with:
- CueType: nature of the time signal (explicit, implicit, relative)
- CueValue: interpreted time signal (e.g., “now”, “later”, “soon”)
- Supports scheduling, temporal disambiguation, and prompt timing.
- Intent Embedding
- Includes a reference to the current user Intent, either as a full object or linked identifier.
- Supports semantic continuity across modules (e.g., DA, BK, PA).
- Personal Status
- Includes a PersonalStatus field capturing inferred emotional or cognitive disposition.
- Supports expressive modulation and affective alignment.
- Instance Metadata
- Includes:
- UserStateID: unique identifier for this User State Instance
- MInstanceID: anchoring to metaverse context
- Traceability
- Includes a Trace with:
- Origin: module or subsystem that registered the state
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/UserState.json
Semantics
| Label | Description |
| Header | User State Header |
| – Standard-UserState | The characters “PGP-USS-V” |
| – Version | Major version – 1 or 2 characters |
| – Dot-separator | The character “.” separating version components |
| – Subversion | Minor version – 1 or 2 characters |
| MInstanceID | Identifier of M-Instance. |
| MEnvironmentID | Identifier of M-Environment. |
| UserState ID | Unique identifier for the User State instance. |
| UserState Data | The full User State output package. |
| Personal Status | The User Personal Status. |
| Intent | The user Intent. |
| Engagement | Level and mode of user engagement |
| ├─ Level | Intensity of engagement: low, medium, high |
| └─ Mode | Type of engagement: passive, interactive, directive |
| Focus | Primary object or concept of attention |
| ├─ TargetType | Type of focus: object, zone, concept, actor |
| └─ TargetID | Identifier of the focused entity |
| TemporalCue | Time-related signal inferred from input |
| ├─ CueType | Nature of cue: explicit, implicit, relative |
| └─ CueValue | Time signal (e.g. “now”, “later”) |
| Trace | Provenance metadata |
| ├─ Origin | Module or subsystem that registered the state |
| └─ Timestamp | Time of this User State |
| DescrMetadata | Descriptive Metadata |
