Go to PGM-AUA V1.0 AI Modules

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’ Entity State. It refines the baseline User State produced by Context Enhancement into an authoritative, up‑to‑date User State, and derives expressive guidance that informs Personality Alignment. It refines Engagement (level and mode) and Personal Status (affective tone, motivation, and disposition).

User State Refinement operates through two operative interfaces and one semantic interface:

  • Operative Interface — receives a USR Directive from A‑User Control and returns the User State Status (as the USR Status). The Directive specifies refinement goals, urgency, override conditions, and the A‑User Control mode (Overseer or Micromanager). Non‑MCP.
  • User State Query Interface — receives a User State Query and returns the current User State Status, supplying the A‑User Personal Status to consumers such as Personality Alignment and A‑User Formation that need it to frame expressive delivery. 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.

User State Refinement also produces the Expressive State Guide consumed by Personality Alignment.

The PGM‑USR AIM:

Receives USR Directive Instructions from A‑User Control specifying refinement goals, urgency, override conditions, and control mode (Overseer | Micromanager).
User State Query Operative request from a consumer (e.g. Personality Alignment, A‑User Formation) for the current refined user state.
User Entity State Baseline user state produced by Context Enhancement, to be refined.
BKNToUSR Deliberation feedback from Basic Knowledge via MCP. Defined within the BKN-USR Interaction schema.
Produces User State Status Authoritative refined user state (engagement, affective tone, disposition, override report, provenance); returned through the User State Query interface and reported to A‑User Control as the USR Status.
Expressive State Guide Modulation hints for Personality Alignment (tone, style, verbosity, safety and override flags), with provenance.
USRToBKN Refined user state supplied to Basic Knowledge via MCP for the next deliberation cycle. Defined within the BKN-USR Interaction schema.

2 Reference Model

Figure 1 depicts the Reference Model of the User State Refinement (PGM‑USR) AIM.

[Figure 1 image to be inserted]

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.

Table 1 – 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 (Overseer | Micromanager).
User State Query Operative request from a consumer (e.g. Personality Alignment, A‑User Formation) for the current refined user state.
User Entity State Baseline user state produced by Context Enhancement, to be refined.
BKNToUSR Deliberation feedback from Basic Knowledge via MCP. Defined within the BKN-USR Interaction schema.
Output Description
User State Status Authoritative refined user state (engagement, affective tone, disposition, override report, provenance); returned through the User State Query interface and reported to A‑User Control as the USR Status.
Expressive State Guide Modulation hints for Personality Alignment (tone, style, verbosity, safety and override flags), with provenance.
USRToBKN Refined user state supplied to Basic Knowledge via MCP for the next deliberation cycle. Defined within the BKN-USR Interaction schema.

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 Functions of SubAIMs

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:

  1. Entity State Merger
    • Merges the baseline User Entity State with prior state and directive refinements, ensuring consistency before recalibration.
  2. Engagement Recalibrator
    • Computes engagement level and mode using cadence history and directives.
  3. Personal Status Refiner
    • Refines affective tone, motivation, and disposition, blending engagement metrics with deliberation feedback.
  4. User State Synthesiser
    • Consolidates entity state, engagement, and personal status into the authoritative User State Status with provenance.
  5. Expressive State Guide Composer
    • Generates tone, style, verbosity, and safety overrides for Personality Alignment from the User State Status.
  6. UR-Prompt Assembler
    • Builds the USRToBKN message embedding the refined state and expressive cues for the next deliberation cycle.

4.3 Functions of SubAIMs

Table 2 specifies the functions of the User State Refinement (PGM‑USR) SubAIMs.

Table 2 – Functions of the User State Refinement (PGM‑USR) SubAIMs

SubAIM Function
Entity State Merger Merges baseline User Entity State with prior state and directive refinements, ensuring consistency before recalibration.
Engagement Recalibrator Computes engagement level and mode.
Personal Status Refiner Refines affective tone, motivation, and disposition.
User State Synthesiser Consolidates into the authoritative User State Status with provenance.
Expressive State Guide Composer Composes the Expressive State Guide for Personality Alignment.
UR-Prompt Assembler Assembles the USRToBKN message 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.

Table 3 – Input and Output Data of the User State Refinement (PGM‑USR) SubAIMs

SubAIM Input Output
Entity State Merger User State
USR Directive
Prior User State Status		 Merged Entity State
Engagement Recalibrator Merged Entity State
USR Directive		 Engagement Metrics
Personal Status Refiner Engagement Metrics
BKNToUSR
USR Directive		 Refined Personal Status
User State Synthesiser Refined Personal Status
Engagement Metrics		 User State Status
Expressive State Guide Composer User State Status Expressive State Guide
UR-Prompt Assembler User State Status
Expressive State Guide		 USRToBKN

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.

Table 4 – AIMs and JSON Metadata of the User State Refinement (PGM‑USR)

AIM1 AIM2 Name JSON
PGM‑USR User State Refinement X
PGM‑ESM Entity State Merger X
PGM‑ENG Engagement Recalibrator X
PGM‑PST Personal Status Refiner X
PGM‑USY User State Synthesiser X
PGM‑ESG Expressive State Guide Composer X
PGM‑URP UR-Prompt Assembler 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.

Table 5 – Conformance Testing Method for the User State Refinement (PGM‑USR) AIM

Receives USR Directive Shall validate against USR Directive schema.
User State Query Shall validate against User State Query schema.
User Entity State Shall validate against User Entity State schema.
BKNToUSR Shall validate against BKN-USR Interaction schema.
Produces User State Status Shall validate against User State Status schema.
Expressive State Guide Shall validate against Expressive State Guide schema.
USRToBKN Shall validate against BKN-USR Interaction schema.

9 Performance Assessment

Not part of this specification.

Go to PGM-AUA V1.0 AI Modules