(Tentative)
| Definition | Functional Requirements | Syntax | Semantics |
Definition
DA-Input (PGM-DAI)
- Is produced by Basic Knowledge (BKN) from the PC-Prompt generated by Prompt Creation.
- Represents a structured semantic interpretation of the User’s intent, referential focus, and contextual framing.
- Includes validated intent, target item, temporal and spatial context, disambiguation cues, and trace metadata to support Domain Access reasoning and constraint validation.
Functional Requirements
DA-Input 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). |
| Target Item | Identifies the primary entity referenced in the prompt, including type and attributes. |
| ItemID | Unique identifier of the referenced Item. |
| ItemType | Semantic category of the Item (e.g., object, zone, actor). |
| Attributes | Optional key-value metadata describing the Item (e.g., color: red, status: open). |
| Temporal Context | Indicates the time reference of the intent (e.g., past, present, future, unclear). |
| Spatial Context | Anchors the intent within a spatial frame and attitude. |
| ReferenceFrame | Named spatial anchor (e.g., UserView, SceneOrigin). |
| SpatialAttitude | Position, orientation, and viewpoint metadata. |
| Disambiguation Hints | Optional cues to resolve ambiguity (e.g., synonyms, aliases, related Items). |
| Trace Metadata | Provides provenance for auditability. |
| PCPromptHash | Hash of the originating PC-Prompt. |
| BKFragmentID | Identifier of the Basic Knowledge fragment that produced the Initial Response. |
| Timestamp | Time of generation. |
Syntax
https://schemas.mpai.community/PGM1/V1.0/data/DAInput.json
Semantics
| Label | Description |
| Header | DA-Input Header |
| ├─ Standard-DAInput | The characters “PGM-DAI-V” indicating the 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 |
| UserIntent | Structured representation of the user’s communicative goal or action |
| TargetItem | Primary Item referenced in the user’s goal or query |
| ├─ ItemID | Unique identifier of the referenced Item |
| ├─ ItemType | Semantic category of the Item (from ItemTypeTaxonomy) |
| └─ Attributes | Optional key-value metadata describing the Item (e.g., color, status) |
| TemporalContext | Temporal reference inferred from PC-Prompt or Basic Knowledge |
| └─ Value | One of: past, present, future, unclear |
| SpatialContext | Spatial reference or location context relevant to the intent |
| ├─ ReferenceFrame | Named spatial anchor (e.g., UserView, SceneOrigin) |
| └─ SpatialAttitude | Position, orientation, and viewpoint metadata (from SpatialAttitude schema) |
| DisambiguationHints | Optional cues to resolve ambiguity (e.g., synonyms, aliases, related Items) |
| Trace | Provenance metadata for debugging and audit |
| ├─ PCPromptHash | Hash of the originating PC-Prompt |
| ├─ BKFragmentID | Identifier of the Basic Knowledge fragment that produced the Initial Response |
| └─ Timestamp | Time of generation (from Time schema) |
