(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
DA Action Directive (PGM-DAD)
- Is produced by A-User Control (PGM-AUC) to request domain-specific execution or arbitration.
- Represents a structured instruction to Domain Access to validate, simulate, or initiate a behavior aligned with the A-User’s intent.
- Includes the intended action, referents, contextual constraints, and trace metadata to support domain reasoning and feasibility evaluation.
Functional Requirements
| Function | Description |
| Intent | Specifies the high-level action or goal to be executed. |
| Referents | Identifies the entities or zones involved in the behavior. |
| Constraints | Communicates spatial, temporal, or logical constraints. |
| Scene Context | Anchors the directive within a specific M-Location or Scene. |
| Execution Parameters | Optional parameters required for domain execution. |
| Trace Metadata | Provides provenance for auditability and control lineage. |
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/DAActionDirective.json
Semantics
| Label | Description |
| Header | DA Action Directive Header |
| – Standard-DAD | The characters “PGM-DAD-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 DA Action Directive instance |
| Intent | Canonical identifier of the intended behavior |
| Referents | Entities and zones involved in the behavior |
| – SourceEntityID | ID of the primary entity |
| – TargetZoneID | ID of the spatial zone |
| Constraints | Feasibility and spatial conditions |
| – Reachable | Whether the entity or zone is reachable |
| – Occluded | Degree of visual obstruction (none, partial, full) |
| – FallbackUsed | Whether a fallback referent was selected |
| SceneContext | Scene and temporal anchoring |
| – SceneID | Identifier of the current scene |
| – Timestamp | Time of arbitration or emission |
| – UserFocus | ID of the entity currently focused by the user |
| ExecutionParameters | Optional parameters required for behavior execution |
| – MovementVector | Vector for movement-based actions |
| – DurationMs | Duration of the action in milliseconds |
| Trace | Provenance metadata for DA Action Directive |
| – Origin | Module or subsystem that issued the directive |
| – Timestamp | Time of directive creation |
