Sync public snapshot from freebuff-private

Source: CodebuffAI/freebuff-private@4dd10600f6584cc42c528846789d0c0c21166b38

Author: github-actions[bot]

common/src/constants/__tests__/freebuff-free-promotions.test.ts

@@ -26,7 +26,7 @@ describe('free-promotion spend windows', () => {
       {
         modelId: FREEBUFF_SOLAR_PRO_4_MODEL_ID,
         from: '2026-09-09T15:49:00.000Z',
-        to: '2099-01-01T00:00:00.000Z',
+        to: '2026-09-13T05:00:00.000Z',
       },
     ])
   })

common/src/constants/freebuff-models.ts

@@ -315,24 +315,25 @@ export const FREEBUFF_GPT_5_6_LUNA_REASONING_EFFORT = 'high' as const
  *  by `applyOpenRouterProviderRouting`. Context 524,288, text in / text out,
  *  using Upstage's non-ZDR endpoint for provider-side debugging.
  *
- *  PRICE: Upstage's LIST card is $0.30/M in, $0.06/M cached, $1.20/M out.
- *  OpenRouter's card shows $0.03/$0.006/$0.12 with `"discount": 0.9` — that is
- *  Upstage's own launch promo ("Solar Pro 4: 90% off through Sep 10 (UTC)" on
- *  the Upstage console), not an OpenRouter-only price.
+ *  PRICE: Upstage's LIST card is $0.30/M in, $0.06/M cached, $1.20/M out, and
+ *  Upstage bills our key 90% off it ($0.03/$0.006/$0.12). That began as a
+ *  launch promo ("Solar Pro 4: 90% off through Sep 10 (UTC)" on the Upstage
+ *  console; OpenRouter shows `"discount": 0.9`) and our rate outlived the
+ *  banner's date. It is not an OpenRouter-only price.
  *
  *  The route is BYOK (`usage.is_byok: true`): OpenRouter serves it with our
  *  own Upstage key, bills nothing itself (`usage.cost` is 0) and reports an
  *  ESTIMATE of the upstream charge in `cost_details.upstream_inference_cost`,
- *  computed at the LIST card. It does not know our key is on the promo, so
- *  through 2026-09-10 that estimate is ten times Upstage's invoice. An earlier
- *  version of this comment read the estimate as "what we are billed" and
- *  concluded BYOK forfeits the discount; Upstage's invoice says otherwise.
- *
- *  The OpenRouter lane therefore reprices this model from tokens while the
- *  promo runs (web/src/llm-api/openrouter-price-overrides.ts, with the dates),
- *  and falls back to OpenRouter's figure — correct again at list — when it
- *  ends. Re-evaluate the row before then rather than silently changing what
- *  "unmetered" means when the price changes. */
+ *  computed at the LIST card. It does not know our key's rate, so that
+ *  estimate is ten times Upstage's invoice. An earlier version of this comment
+ *  read the estimate as "what we are billed" and concluded BYOK forfeits the
+ *  discount; Upstage's invoice says otherwise.
+ *
+ *  The OpenRouter lane therefore reprices this model from tokens
+ *  (web/src/llm-api/openrouter-price-overrides.ts), with no expiry while the
+ *  discount holds. Date or remove that entry when Upstage's invoice changes.
+ *  The Freebucks price is a separate, operator-set decision
+ *  (freebuff-solar-promo.ts). */
 /** Upstage's requested non-ZDR route for debugging. Pair with
  *  `allow_fallbacks: false` in applyOpenRouterProviderRouting. */
 export const SOLAR_PRO_4_OPENROUTER_ENDPOINT = 'upstage'

common/src/constants/freebuff-solar-promo.ts

@@ -25,6 +25,12 @@ export const SOLAR_PRICE_CHANGES = [
     price: 0,
     tagline: '0 Freebucks',
   },
+  {
+    // Metered again. Takes effect as each server deploys it.
+    at: '2026-09-13T05:00:00Z',
+    modelId: FREEBUFF_SOLAR_PRO_4_MODEL_ID,
+    ...SOLAR_REGULAR_OFFER,
+  },
 ] as const
 
 export function solarOfferAt(now: number = Date.now()) {

common/src/util/__tests__/freebuff-price-changes.test.ts

@@ -14,6 +14,7 @@ const solar = 'upstage/solar-pro4'
 const start = Date.parse('2026-09-05T07:00:00Z')
 const end = Date.parse('2026-09-08T07:00:00Z')
 const restored = Date.parse('2026-09-09T15:49:00Z')
+const metered = Date.parse('2026-09-13T05:00:00Z')
 const quoteBeforeStart = () => ({
   ...freebucksFixture(0, { [solar]: SOLAR_REGULAR_OFFER.price }),
   priceNotices: { [solar]: SOLAR_REGULAR_OFFER.tagline },
@@ -38,16 +39,21 @@ describe('announced Freebucks price changes', () => {
     const freeAgain = applyFreebucksPriceChanges(expired, restored)
     expect(freeAgain.prices[solar]).toBe(0)
     expect(freeAgain.priceNotices[solar]).toBe('0 Freebucks')
-    expect(nextFreebucksPriceChange(freeAgain)).toBe(Infinity)
+    expect(nextFreebucksPriceChange(freeAgain)).toBe(metered)
+    const meteredAgain = applyFreebucksPriceChanges(freeAgain, metered)
+    expect(meteredAgain.prices[solar]).toBe(5)
+    expect(meteredAgain.priceNotices[solar]).toBe('Limited-time trial')
+    expect(nextFreebucksPriceChange(meteredAgain)).toBe(Infinity)
     expect(quote.prices[solar]).toBe(5)
-    expect(quote.priceChanges).toHaveLength(3)
+    expect(quote.priceChanges).toHaveLength(4)
   })
 
   it('catches up across all transitions, even when a delayed response lists them out of order', () => {
     const quote = quoteBeforeStart()
     quote.priceChanges.reverse()
     expect(applyFreebucksPriceChanges(quote, end).prices[solar]).toBe(5)
     expect(applyFreebucksPriceChanges(quote, restored).prices[solar]).toBe(0)
+    expect(applyFreebucksPriceChanges(quote, metered).prices[solar]).toBe(5)
   })
 
   it('does not add an unpriced model or invent metadata on older server responses', () => {