feat(chat): render role-bound payment guidance

src/stores/chat/machine/unlock-flow.ts

@@ -22,6 +22,7 @@ const showUnlockHistoryPromptAction = sendMachineSetup.assign(
     unlockHistoryPromptVisible: true,
     lockedHistoryCount: countLockedHistoryMessages(context.messages),
     unlockHistoryError: null,
+    unlockHistoryPaymentGuidance: null,
   }),
 );
 
@@ -29,12 +30,14 @@ const dismissUnlockHistoryPromptAction = sendMachineSetup.assign(() => ({
   paymentUnlockPending: false,
   unlockHistoryPromptVisible: false,
   unlockHistoryError: null,
+  unlockHistoryPaymentGuidance: null,
 }));
 
 const markUnlockHistoryStartedAction = sendMachineSetup.assign(() => ({
   paymentUnlockPending: false,
   unlockHistoryPromptVisible: false,
   unlockHistoryError: null,
+  unlockHistoryPaymentGuidance: null,
 }));
 
 const markUnlockHistoryFailedAction = sendMachineSetup.assign(() => ({
@@ -76,6 +79,7 @@ const applyUnlockMessageSucceededAction = sendMachineSetup.assign(
       creditsCharged: output.response.creditsCharged,
       requiredCredits: 0,
       shortfallCredits: 0,
+      paymentGuidance: null,
     };
   },
 );
@@ -112,11 +116,15 @@ const requestUnlockPaymentFromOutputAction = sendMachineSetup.assign(
             creditBalance: output.response.creditBalance,
             requiredCredits: output.response.requiredCredits,
             shortfallCredits: output.response.shortfallCredits,
+            ...(output.response.paymentGuidance
+              ? { paymentGuidance: output.response.paymentGuidance }
+              : {}),
           }
         : null,
       creditBalance: output.response.creditBalance,
       requiredCredits: output.response.requiredCredits,
       shortfallCredits: output.response.shortfallCredits,
+      paymentGuidance: output.response.paymentGuidance,
     };
   },
 );
@@ -191,6 +199,9 @@ const applyUnlockHistoryOutputAction =
       unlockHistoryError: insufficientBalance
         ? `Insufficient credits. You still need ${event.output.shortfallCredits} credits.`
         : null,
+      unlockHistoryPaymentGuidance: insufficientBalance
+        ? event.output.paymentGuidance ?? null
+        : null,
     };
   });