(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
User State Directive (PGM-USD)
- Is produced by A-User Control (PGM-AUC) to guide refinement of the interpretation of the User State.
- Represents a structured instruction to the User State Refinement AIM to update engagement, affective tone, and disposition based on interaction feedback.
- Includes modulation cues, semantic alignment, override flags, and trace metadata to support state refinement.
Functional Requirements
| Function | Description |
| Engagement Cue | Indicates the inferred cognitive engagement level. |
| Affective Tone Cue | Suggests the emotional tone derived from interaction. |
| Disposition Cue | Captures inferred attitude or stance. |
| Semantic Alignment | Confirms whether the Enhanced Response aligns with user expectations. |
| Override Flags | Allows forced modulation or fallback disposition. |
| Trace Metadata | Provides provenance for auditability and control lineage. |
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/UserStateDirective.json
Semantics
| Label | Description |
|---|---|
| Header | User State Directive Header |
| ├─ Standard-USD | The characters “PGM-USD-V” indicating schema family and type |
| ├─ Version | Major version – 1 or 2 characters |
| ├─ Dot-separator | The character “.” separating version components |
| └─ Subversion | Minor version – 1 or 2 characters |
| DirectiveID | Unique identifier for this User State Directive instance |
| PersonalStatus | Reference to full multimodal user status including emotional, cognitive, and social attitude |
| EngagementCue | Inferred cognitive engagement level (low, moderate, high) |
| SemanticAlignment | Whether Enhanced Response aligns with User expectations |
| UrgencyLevel | Priority or time-sensitivity of directive |
| Modulation | Structured control settings guiding execution style and tone |
| ├─ ExecutionStyle | Style of execution: minimal, verbose, expressive, neutral |
| ├─ ResponseModality | Preferred response channel: text, speech, gesture, multi-modal |
| ├─ ToneProfile | Desired tone of response: formal, casual, directive, supportive |
| ├─ PrecisionLevel | Desired level of precision: exact, approximate, summary |
| └─ AdaptivityFlags | Runtime adjustment toggles: urgency-aware, engagement-sensitive, status-reactive |
| OverrideFlags | Modulation override controls |
| ├─ ForceSocialAttitude | Whether to override inferred social attitude |
| └─ FallbackSocialAttitude | Fallback attitude if override is triggered or inference fails |
| Trace | Provenance metadata for User State Directive |
| ├─ Origin | Module or subsystem that issued the directive |
| └─ Timestamp | Time of directive creation |
| DescrMetadata | Descriptive Metadata |
