(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
Visual Action Directive (PGM-VAD)
- Is produced by A-User Control (PGM-AUC) to initiate visual scene analysis or refinement.
- Represents a structured instruction to the Visual Scene AIM to process, annotate, or extract spatial features from the current context.
- Includes action type, scene scope, refinement flags, and trace metadata to guide visual processing.
Functional Requirements
| Function | Description |
| Action Type | Specifies the visual processing operation (e.g., extract, refine, annotate). |
| Scene Scope | Defines the spatial and temporal extent of the scene to be processed. |
| Refinement Flags | Indicates whether constraints or priorities should be applied. |
| Visual Directive Link | References the Visual Spatial Directive that modifies interpretation. |
| Context Reference | Anchors the directive to the current Context snapshot. |
| Trace Metadata | Provides provenance for auditability and control lineage. |
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/VisualActionDirective.json
Semantics
| Label | Description |
| Header | Visual Action Directive Header |
| – Standard-VAD | The characters “PGM-VAD-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 Visual Action Directive instance |
| ActionType | Type of visual processing operation (extract, refine, annotate, segment) |
| SceneScope | Spatial and temporal extent of the scene |
| – SceneID | Identifier of the scene to be processed |
| – WindowDurationMs | Time window in milliseconds (if applicable) |
| RefinementFlags | Constraints and priorities for scene interpretation |
| – ApplyConstraints | Whether to apply spatial constraints |
| – PrioritizeSalience | Whether to prioritize salient objects |
| – NormalizePerspective | Whether to normalize scene geometry to User perspective |
| VisualDirectiveLink | Reference to the Visual Spatial Directive |
| ContextReference | Reference to the Context snapshot |
| Trace | Provenance metadata for Visual Action Directive |
| – Origin | Module or subsystem that issued the directive |
| – Timestamp | Time of directive creation |
