Sync public snapshot from freebuff-private

Source: CodebuffAI/freebuff-private@5da97db00e920fae5f2f79911d451fa23ea7f915

Author: github-actions[bot]

bun.lock

@@ -2202,6 +2202,24 @@ export function freebuffWithdrawnModelAvailabilityLabel(): string {
   return `no longer offered in free mode — we recommend ${replacement}`
 }
 
+/**
+ * What a client that understands `updateRequired` says: the model is fine,
+ * the build is not, and updating costs nothing extra.
+ */
+export function freebuffUpdateRequiredModelMessage(id: string): string {
+  const model = SUPPORTED_FREEBUFF_MODELS.find((m) => m.id === id)
+  const name = model?.displayName ?? id
+  return `Update Freebuff Desktop to keep using ${name}. This version can't resume your purchased time — the model itself is fine, and updating won't charge you again.`
+}
+
+/** The same fact shaped to sit inside "<model> isn't available right now (…)",
+ *  which is the only sentence a binary that predates `updateRequired` can
+ *  build. Scopes the unavailability to the client version, so the reader is
+ *  not told the model is down. */
+export function freebuffUpdateRequiredAvailabilityLabel(): string {
+  return 'only on this version of Freebuff Desktop — update it to resume your purchased time without another charge'
+}
+
 /** Suffix-tolerant like the other model predicates, so a dated provider
  *  snapshot of a paused model cannot slip past the pause. */
 export function isFreebuffPausedFreeModelId(

common/src/constants/freebuff-models.ts

@@ -876,6 +876,19 @@ export type FreebuffSessionAdmissionResponse = (
        * the field.
        */
       withdrawn?: boolean
+      /**
+       * The MODEL is fine; this CLIENT BUILD cannot resume a purchased hour,
+       * and the server refused rather than charge the hour again. Set only on
+       * the Desktop multi-session path, for a binary too old to rotate a
+       * purchase claim.
+       *
+       * Older clients ignore it and still render `availableHours`, which is
+       * worded so the sentence they build around it does not blame the model.
+       * The refusal it replaces read "<model> isn't available right now
+       * (Update Freebuff Desktop …)", which sent a user off the model that was
+       * working onto whatever was not.
+       */
+      updateRequired?: boolean
     }
   | {
       /** Account is banned. Returned from every endpoint so banned bots can't