(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
Refined Context Guide (PGM-RCG)
- Is produced by constraint-aware behaviour modules within Domain Access (DA).
- Represents a domain-specific semantic interpretation of the User’s intent and interaction context.
- Includes validated constraints, execution parameters, and provenance metadata to support downstream reasoning and behaviour alignment.
Functional Requirements
Refined Context Guide conveys the following main information elements:
| Function | Description |
| Intent | Specifies the high-level action or goal derived from User input (e.g., move_object, query_status). |
| Entities | Identifies the source and target entities involved in the behaviour (e.g., object_17, shelf). |
| Constraints | Communicates feasibility flags such as reachability, occlusion, proximity, and validation status. |
| Scene Context | Anchors the behaviour within a specific SceneID and timestamp. |
| Execution Parameters | Includes any parameters required for behaviour execution (e.g., movement vector, duration). |
| User Engagement | Indicates user focus, attention level, or interaction state. |
| Trace Metadata | Provides provenance for auditability (e.g., originating module, version, decision path). |
| Semantic Tags | Optional domain-specific annotations for USR to interpret behaviour meaningfully. |
| Fallback Status | Indicates whether the behaviour is primary, deferred, or a fallback selection. |
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/RefinedContextGuide.json
Semantics
| Label | Description |
| Header | Refined Context Guide Header |
| ├─ Standard-RCG | The characters “PGP-RCG-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. |
| RefinedContextGuideID | Canonical identifier of the user’s intended action (e.g. move_object, query_status) |
| Intent | User Intent |
| ├─ ID | Unique Identifier of intent |
| ├─ IntentClass | High-level category of the intent (ActionIntent, QueryIntent, MetaIntent) |
| ├─ Label | Optional human-readable label for display or logging |
| └─ Confidence | Confidence score assigned by DA’s arbitration logic (range: 0–1) |
| SourceEntity | Primary object involved in the behaviour |
| ├─ ID | Unique identifier of the primary object involved in the behaviour |
| ├─ Type | Domain-specific type of the entity (e.g. container, tool, target) |
| ├─ Role | Functional role in the behaviour (e.g. movable, interactive, destination) |
| └─ SemanticTags | Optional list of domain-specific annotations (e.g. fragile, preferred) |
| TargetZone | spatial zone or destination |
| ├─ ID | Unique identifier of the spatial zone or destination |
| └─ SemanticLabel | Domain-specific label for the zone (e.g. shelf, bin, workspace) |
| Reachable | Boolean indicating whether the zone is physically reachable |
| ├─ Constraints | Zone Constraints |
| ├─ Reachable | Whether the behaviour is spatially feasible (true/false) |
| ├─ Occluded | Degree of visual obstruction (none, partial, full) |
| └─ Valid | Whether the behaviour passed all feasibility checks |
| ExecutionParameters | Optional key-value pairs for behaviour execution (e.g. speed, duration) |
| SceneID | Identifier of the current spatial or simulation scene |
| Timestamp | Timestamp of arbitration or emission |
| UserEngagement | Level of user interaction or focus (low, medium, high) |
| FallbackStatus | Indicates if the behaviour is primary, deferred, or a fallback selection |
| Trace | Provenance metadata for Adaptive Context Guide |
| └─ Origin | Module or subsystem that generated the payload (e.g. DA-Core) |
