Function
Ref. Model
I/O Data
SubAIMs
JSON MData
Profiles
Ref. Software
Conformance
Performance
1 Functions
The User State Refinement (PGM‑USR) AIM improves the A‑User’s understanding of the evolving User State. It refines the baseline User State produced by Context Description into an authoritative, up‑to‑date USR Status, and derives expressive guidance that informs Personality Alignment. It refines Engagement (level and mode) and Entity State (affective tone, motivation, and disposition).
User State Refinement operates through one operative interface and one semantic interface:
- Operative Interface — receives a USR Directive from A‑User Control and returns the USR Status. The Directive specifies refinement goals, urgency, override conditions, and the A‑User Control mode (Overseer or Micromanager). Non‑MCP.
- Semantic Interface (MCP) — exchanges BKNToUSR / USRToBKN with Basic Knowledge, incorporating deliberation feedback and supplying the refined user state for the next deliberation cycle.
The AIM additionally reads and writes prior User State content through Interaction History (User IH Response / User IH Request) with A‑User Storage, and produces the Expressive State Guide consumed by Personality Alignment. The USR Status is the single authoritative refined User State, reported to A‑User Control and made available to consumers such as Personality Alignment and A‑User Formation.
| Receives | USR Directive | Instructions from A‑User Control specifying refinement goals, urgency, override conditions, and control mode. |
| User State | Baseline User State produced by Context Description, to be refined. | |
| BKN-USR Request | Deliberation feedback from Basic Knowledge via MCP. Defined within the BKN-USR Interaction schema. | |
| User IH Response | Prior User State content read from A‑User Storage (cadence history, prior state). | |
| Produces | USR Status | Authoritative refined User State (engagement, affective tone, disposition, override report, provenance). |
| Expressive State Guide | Modulation hints for Personality Alignment (tone, style, verbosity, safety and override flags), with provenance. | |
| BKN-USR Response | Refined User State supplied to Basic Knowledge via MCP for the next deliberation cycle. Defined within the BKN-USR Interaction schema. | |
| User IH Request | Request to A‑User Storage to write the refined User State and read prior cadence and state. |
2 Reference Model
Figure 1 depicts the Reference Model of the User State Refinement (PGM‑USR) AIM.
Figure 1 – Reference Model of the User State Refinement (PGM‑USR) AIM
3 I/O Data
Table 1 specifies the Input and Output Data of the User State Refinement (PGM‑USR) AIM.
| Input | Description |
|---|---|
| USR Directive | Instructions from A‑User Control specifying refinement goals, urgency, override conditions, and control mode. |
| User State | Baseline User State produced by Context Description, to be refined. |
| BKN-USR Request | Deliberation feedback from Basic Knowledge via MCP. Defined within the BKN-USR Interaction schema. |
| User Interaction History Response | Prior User State content read from A‑User Storage (cadence history, prior state). |
| Output | Description |
| USR Status | Authoritative refined User State (engagement, affective tone, disposition, override report, provenance); reported to A‑User Control and supplied to consumers such as Personality Alignment and A‑User Formation. |
| Expressive State Guide | Modulation hints for Personality Alignment (tone, style, verbosity, safety and override flags), with provenance. |
| BKN-USR Response | Refined User State supplied to Basic Knowledge via MCP for the next deliberation cycle. Defined within the BKN-USR Interaction schema. |
| User Interaction History Request | Request to A‑User Storage to write the refined User State and read prior cadence and state. |
4 SubAIMs (informative)
This section is informative. The decomposition into SubAIMs described below illustrates one conformant architecture for producing the normative outputs of PGM‑USR. Implementations may adopt alternative internal structures provided they satisfy the conformance requirements of Section 8.
4.1 Reference Model
Figure 2 depicts the Reference Model of the User State Refinement (PGM‑USR) Composite AIM.
[Figure 2 image to be inserted]
Figure 2 – Reference Model of the User State Refinement (PGM‑USR) Composite AIM
4.2 Operation
The USR operation includes the following SubAIMs:
- Engagement Recalibrator — computes engagement level and mode from the baseline User State, cadence history (from Interaction History), and the USR Directive.
- Entity State Refiner — refines affective tone, motivation, and disposition (the Entity State), incorporating the deliberation feedback received from Basic Knowledge (BKN-USR Request) and returning the Refined Entity State to Basic Knowledge (BKN-USR Response) for the next deliberation cycle.
- User State Synthesiser — consolidates baseline User State, engagement, and Refined Entity State into the authoritative USR Status, resolving overrides and recording provenance; reads prior state through Interaction History (User IH Response) and issues the Interaction History write (User IH Request).
- Expressive State Guide Composer — composes the Expressive State Guide for Personality Alignment and assembles the outgoing message to Basic Knowledge (USR-BKN Response) for the next deliberation cycle.
4.3 Functions of SubAIMs
Table 2 specifies the functions of the User State Refinement (PGM‑USR) SubAIMs.
| SubAIM | Function |
|---|---|
| Engagement Recalibrator | Computes engagement level and mode from the baseline User State, cadence history, and directive. |
| Entity State Refiner | Refines affective tone, motivation, and disposition, incorporating Basic Knowledge deliberation feedback (BKN-USR Request) and returning the Refined Entity State (BKN-USR Response) for the next cycle. |
| User State Synthesiser | Consolidates baseline User State, engagement, and Refined Entity State into the authoritative USR Status with override resolution and provenance; issues the Interaction History write. |
| Expressive State Guide Composer | Composes the Expressive State Guide for Personality Alignment and assembles the outgoing message to Basic Knowledge for the next deliberation cycle. |
4.4 I/O Data of SubAIMs
Table 3 gives the Input and Output Data of the User State Refinement (PGM‑USR) SubAIMs.
| SubAIM | Input | Output |
|---|---|---|
| Engagement Recalibrator | USR Directive User State User IH Response |
USR Status Engagement Metrics User IH Request |
| Entity State Refiner | USR Directive User State Engagement Metrics BKN-USR Request |
USR Status Refined Entity State BKN-USR Response |
| User State Synthesiser | USR Directive User IH Response User State Engagement Metrics Refined Entity State |
USR Status User IH Request |
| Expressive State Guide Composer | USR Directive | USR Status Expressive State Guide USR-BKN Response |
4.5 AIMs and JSON Metadata
Table 4 provides the links to the AIM specifications and JSON schemas. AIM1 indicates the Composite AIM and AIM2 its SubAIMs.
| AIM1 | AIM2 | Name | JSON |
|---|---|---|---|
| PGM‑USR | User State Refinement | X | |
| PGM‑ENG | Engagement Recalibrator | X | |
| PGM‑ESR | Entity State Refiner | X | |
| PGM‑USY | User State Synthesiser | X | |
| PGM‑ESG | Expressive State Guide Composer | X |
5 JSON Metadata
https://schemas.mpai.community/PGM1/V1.0/AIMs/UserStateRefinement.json
6 Profiles
No Profiles.
7 Reference Software
Not part of this specification.
8 Conformance Testing
Table 5 provides the Conformance Testing Method for the User State Refinement (PGM‑USR) AIM. Conformance Testing of the individual SubAIMs is given by the individual AIM specifications.
If a schema contains references to other schemas, conformance of data for the primary schema implies that any data referencing a secondary schema shall also validate against the relevant schema, if present, and conform with the Qualifier, if present.
| Receives | USR Directive | Shall validate against USR Directive schema. |
| User State | Shall validate against User State schema. | |
| BKN-USR Request | Shall validate against BKN-USR Interaction schema. | |
| User Interaction History Response | Shall validate against Interaction History schema. | |
| Produces | USR Status | Shall validate against USR Status schema. |
| Expressive State Guide | Shall validate against Expressive State Guide schema. | |
| BKN-USR Response | Shall validate against BKN-USR Interaction schema. | |
| User Interaction History Request | Shall validate against Interaction History schema. |
9 Performance Assessment
Not part of this specification.
