clixad 0.0.1-beta.26 → 0.0.1-beta.27

package/dist/clixad.mjs

@@ -302,6 +302,23 @@ import { gzipSync } from "node:zlib";
 function encodeChatBody(json) {
   return gzipSync(Buffer.from(json, "utf8"));
 }
+function accessColumn(m, premium) {
+  if (m.access === void 0) return m.tier.padEnd(8);
+  if (m.access === "budget") return "budget  ";
+  return premiumLocked(premium) ? "locked  " : "premium ";
+}
+function premiumLocked(premium) {
+  return premium !== void 0 && !premium.unlocked && premium.credits <= 0;
+}
+function premiumUnlockHint(unlockUsd) {
+  return typeof unlockUsd === "number" && unlockUsd > 0 ? `premium: a survey or ${usd(unlockUsd)} unlocks it` : "premium: a survey unlocks it";
+}
+function premiumHeadline(unlockUsd) {
+  return typeof unlockUsd === "number" && unlockUsd > 0 ? `Premium: complete a survey or unlock from ${usd(unlockUsd)}.` : "Premium: complete a survey to unlock it.";
+}
+function usd(v) {
+  return Number.isInteger(v) ? `$${v}` : `$${v.toFixed(2)}`;
+}
 function adsPerTaskLabel(estAdsPerTask) {
   const effort = estAdsPerTask >= 1 ? `~${estAdsPerTask} ads/task` : "<1 ad/task";
   return `${effort} on completion (median)`;
@@ -405,16 +422,35 @@ function asSignupClosed(status, data) {
   const d = data;
   return d && d.error === "signup_closed" && typeof d.message === "string" ? { error: d.error, message: d.message, waitlist_url: d.waitlist_url ?? "https://clixad.io" } : void 0;
 }
+function premiumLockedError(message, model, body) {
+  const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : 0;
+  return new PremiumLockedError(
+    message,
+    typeof body?.model === "string" ? body.model : model,
+    num(body?.needed_credits),
+    num(body?.premium_credits),
+    typeof body?.unlock_usd === "number" && body.unlock_usd > 0 ? body.unlock_usd : null,
+    num(body?.grant_per_ad),
+    freeAlternatives(body?.free_models)
+  );
+}
 function shortfallHeadline(err, model) {
   const n = (v) => Math.max(0, Math.round(v)).toLocaleString("en-US");
   if (err.balance <= 0) return `Out of credits (this needs about ${n(err.estimatedCost)}).`;
   return `Not enough credits for this turn${model ? ` on ${model}` : ""}: it needs about ${n(err.estimatedCost)}, and the balance is ${n(err.balance)}.`;
 }
 function paywallError(body) {
-  const free = Array.isArray(body.free_models) ? body.free_models.filter(
+  return new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad, freeAlternatives(body.free_models));
+}
+function freeAlternatives(list) {
+  return Array.isArray(list) ? list.filter(
     (m) => !!m && typeof m.id === "string" && m.id.length > 0 && Number.isFinite(m.turns_left)
   ).map((m) => ({ id: m.id, turnsLeft: Math.max(0, Math.floor(m.turns_left)) })).filter((m) => m.turnsLeft > 0) : [];
-  return new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad, free);
+}
+async function refusal402(res, model) {
+  const body = await res.json();
+  if (body.error === "premium_locked") return premiumLockedError(body.message ?? "", model, body.premium);
+  return paywallError(body);
 }
 function neverConnected(code) {
   return code !== void 0 && NEVER_CONNECTED.has(code);
@@ -540,7 +576,7 @@ async function* parseSSE(body) {
     }
   }
 }
-var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, GatewayUnreachableError, NEVER_CONNECTED, AuthError, GatewayClient;
+var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, PremiumLockedError, GatewayUnreachableError, NEVER_CONNECTED, AuthError, GatewayClient;
 var init_client = __esm({
   "src/client.ts"() {
     "use strict";
@@ -590,6 +626,24 @@ var init_client = __esm({
       grantPerAd;
       freeModels;
     };
+    PremiumLockedError = class extends Error {
+      constructor(message, model, neededCredits, premiumCredits, unlockUsd, grantPerAd, freeModels) {
+        super(message);
+        this.model = model;
+        this.neededCredits = neededCredits;
+        this.premiumCredits = premiumCredits;
+        this.unlockUsd = unlockUsd;
+        this.grantPerAd = grantPerAd;
+        this.freeModels = freeModels;
+        this.name = "PremiumLockedError";
+      }
+      model;
+      neededCredits;
+      premiumCredits;
+      unlockUsd;
+      grantPerAd;
+      freeModels;
+    };
     GatewayUnreachableError = class extends Error {
       constructor(host, code) {
         const where = `${host}${code ? ` (${code})` : ""}`;
@@ -886,6 +940,7 @@ var init_client = __esm({
         if (!res.ok) throw new Error(`models failed: ${res.status}`);
         const data = await res.json();
         this.seen = { web_search: data.capabilities?.web_search === true };
+        this.unlockUsd = typeof data.premium_unlock_usd === "number" && data.premium_unlock_usd > 0 ? data.premium_unlock_usd : null;
         this.shape = parseTaskShape(data.task_shape);
         this.latest = typeof data.cli_latest === "string" ? data.cli_latest : void 0;
         const live = new Set(data.data.map((m) => m.id));
@@ -936,8 +991,23 @@ var init_client = __esm({
         return this.seen;
       }
       seen = { web_search: false };
-      async wallet(signal) {
-        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/wallet`, { headers: this.headers(), signal });
+      /**
+       * What unlocks premium for every credit on the account (the cheapest pack,
+       * USD), as of the last catalog fetch. Null where the gateway sells none or
+       * did not say, which the hints read as "a survey unlocks it".
+       */
+      get premiumUnlockUsd() {
+        return this.unlockUsd;
+      }
+      unlockUsd = null;
+      /**
+       * `premium: true` asks for premium access too, which costs the gateway a read
+       * of this account's whole ledger. Asked for where it is shown (`/model`,
+       * `clixad models`), never by the polls `/earn` and a purchase run.
+       */
+      async wallet(signal, opts = {}) {
+        const url = `${this.config.gatewayUrl}/v1/wallet${opts.premium ? "?premium=1" : ""}`;
+        const res = await gatewayFetch(url, { headers: this.headers(), signal });
         if (res.status === 401) throw await authFailure(res, "wallet");
         if (!res.ok) throw new Error(`wallet failed: ${res.status}`);
         return res.json();
@@ -1234,9 +1304,7 @@ var init_client = __esm({
           signal
         );
         if (res.status === 401) throw await authFailure(res, "chat");
-        if (res.status === 402) {
-          throw paywallError(await res.json());
-        }
+        if (res.status === 402) throw await refusal402(res, model);
         if (!res.ok) throw new Error(await httpFailure(res, "chat"));
         const data = await res.json();
         const choice = data.choices[0];
@@ -1267,9 +1335,7 @@ var init_client = __esm({
           opts.signal
         );
         if (res.status === 401) throw await authFailure(res, "chat");
-        if (res.status === 402) {
-          throw paywallError(await res.json());
-        }
+        if (res.status === 402) throw await refusal402(res, model);
         if (!res.ok || !res.body) throw new Error(await httpFailure(res, "chat"));
         let content = "";
         let finishReason = "stop";
@@ -1277,6 +1343,7 @@ var init_client = __esm({
         let free = {};
         let balance = 0;
         let streamError;
+        let premiumRefusal;
         const calls = /* @__PURE__ */ new Map();
         const reasoning = [];
         for await (const evt of parseSSE(res.body)) {
@@ -1299,12 +1366,16 @@ var init_client = __esm({
           mergeReasoningDetails(reasoning, choice?.delta?.reasoning_details);
           if (choice?.finish_reason) finishReason = choice.finish_reason;
           if (json.error) streamError = json.error.message || "the model stream failed";
+          if (json.error?.type === "premium_locked") {
+            premiumRefusal = premiumLockedError(streamError ?? "", model, json.clixad?.premium);
+          }
           if (json.clixad) {
             creditsCharged = json.clixad.credits_charged;
             balance = json.clixad.balance;
             free = freeMeta(json.clixad);
           }
         }
+        if (premiumRefusal) throw premiumRefusal;
         if (streamError) throw new Error(streamError);
         const message = { role: "assistant", content: content || null };
         if (calls.size > 0) {
@@ -6150,6 +6221,16 @@ function App({
   const pendingFreeRef = useRef([]);
   const pendingGrantRef = useRef(0);
   const pendingBalanceRef = useRef(void 0);
+  const pendingPremiumRef = useRef(null);
+  const [premium, setPremiumState] = useState(wallet?.premium);
+  const premiumRef = useRef(wallet?.premium);
+  const setPremium = useCallback((next) => {
+    premiumRef.current = next;
+    setPremiumState(next);
+  }, []);
+  const refreshPremium = useCallback(() => {
+    void client.wallet(void 0, { premium: true }).then((w) => setPremium(w.premium)).catch(() => void 0);
+  }, [client, setPremium]);
   const mcpRef = useRef(McpHub.empty());
   const todosRef = useRef(new TodoList());
   const lastTurnRef = useRef(null);
@@ -6259,9 +6340,10 @@ function App({
   useEffect(() => {
     if (wallet) return;
     const ctl = new AbortController();
-    void client.wallet(ctl.signal).then((w) => {
+    void client.wallet(ctl.signal, { premium: true }).then((w) => {
       setBalance((current) => current ?? w.balance);
       setFreeTier((current) => current ?? w.free_tier);
+      if (premiumRef.current === void 0) setPremium(w.premium);
     }).catch(() => void 0);
     return () => ctl.abort();
   }, []);
@@ -6556,6 +6638,13 @@ function App({
           return;
         case "usage":
           setBalance(event.balance);
+          if (event.creditsCharged > 0 && premiumRef.current) {
+            const p = premiumRef.current;
+            setPremium({
+              unlocked: p.unlocked,
+              credits: Math.max(0, p.unlocked ? event.balance : Math.min(event.balance, p.credits - event.creditsCharged))
+            });
+          }
           setSpent((s) => s + event.creditsCharged);
           if (event.free) {
             setFreeTier(
@@ -6567,11 +6656,12 @@ function App({
           return;
       }
     },
-    [cols, flushDelta, push]
+    [cols, flushDelta, push, setPremium]
   );
   const runTurn2 = useCallback(
     async (task, images = []) => {
       pendingFreeRef.current = [];
+      pendingPremiumRef.current = null;
       const model2 = modelRef.current;
       const ac = new AbortController();
       abortRef.current = ac;
@@ -6703,7 +6793,20 @@ ${NO_SEARCH_INSTRUCTION}`),
           }
         }
       } catch (err) {
-        if (err instanceof PaywallError) {
+        if (err instanceof PremiumLockedError) {
+          pendingTaskRef.current = { task, images };
+          pendingPremiumRef.current = err;
+          setPremium({ unlocked: false, credits: err.premiumCredits });
+          const short2 = err.premiumCredits > 0 ? `  This turn needs about ${err.neededCredits.toLocaleString("en-US")} of those credits, and you have ${err.premiumCredits.toLocaleString("en-US")}.
+` : "";
+          push({
+            kind: "notice",
+            tone: "warn",
+            text: `  ${premiumHeadline(err.unlockUsd)}
+  ${err.model} is a premium model. It runs on credits you earned on the offer walls or bought.
+` + short2 + "  Your bonus credits (the signup bonus, our own surveys) still work on budget models.\n  Press enter to unlock it or to switch to a budget model. Your request is kept."
+          });
+        } else if (err instanceof PaywallError) {
           pendingTaskRef.current = { task, images };
           pendingFreeRef.current = err.freeModels;
           pendingGrantRef.current = err.grantPerAd;
@@ -6898,8 +7001,9 @@ ${NO_SEARCH_INSTRUCTION}`),
         text: "  no credit yet \u2014 offers take a while to confirm, and a screenout pays nothing.\n  That is normal: start another with /earn, or check /wallet later."
       });
     push({ kind: "notice", tone: "good", text: "  credits added \u2014 continuing" });
+    refreshPremium();
     if (pending) await runTurn2(pending.task, pending.images);
-  }, [balance, client, config.dashboardUrl, push, runBusy, runTurn2]);
+  }, [balance, client, config.dashboardUrl, push, refreshPremium, runBusy, runTurn2]);
   const runPaywallChoice = useCallback(() => {
     const free = pendingFreeRef.current.filter((m) => m.id !== EARN_ROW);
     if (free.length === 0) return void runAdWall();
@@ -6969,6 +7073,47 @@ ${NO_SEARCH_INSTRUCTION}`),
       });
     });
   }, [client, push, runBusy]);
+  const runPremiumChoice = useCallback(() => {
+    const refusal = pendingPremiumRef.current;
+    if (!refusal) return void runPaywallChoice();
+    const items = [
+      {
+        value: EARN_ROW,
+        label: "complete a survey",
+        hint: `opens the offer walls, offers pay ${grantLabel(refusal.grantPerAd)}`
+      },
+      ...refusal.unlockUsd ? [
+        {
+          value: BUY_ROW,
+          label: `unlock from ${usd(refusal.unlockUsd)}`,
+          hint: "any pack, and premium then takes all your credits"
+        }
+      ] : [],
+      ...refusal.freeModels.filter((m) => m.id !== EARN_ROW && m.id !== BUY_ROW).map((m) => ({
+        value: m.id,
+        label: m.id,
+        hint: `budget, free: ~${m.turnsLeft} turn${m.turnsLeft === 1 ? "" : "s"} left today`
+      }))
+    ];
+    setPickerSel(0);
+    setPicker({
+      title: premiumHeadline(refusal.unlockUsd),
+      subtitle: "Unlock premium, or carry on with a budget model.",
+      items,
+      onPick: (choice) => {
+        if (choice.value === EARN_ROW) return void runAdWall();
+        if (choice.value === BUY_ROW) return void runBuy();
+        const pending = pendingTaskRef.current;
+        pendingTaskRef.current = null;
+        pendingPremiumRef.current = null;
+        config.model = choice.value;
+        saveConfig(config);
+        switchModel(choice.value);
+        push({ kind: "notice", tone: "good", text: `  model \u2192 ${choice.value} (budget) \xB7 continuing where you left off` });
+        if (pending) void runTurn2(pending.task, pending.images);
+      }
+    });
+  }, [config, push, runAdWall, runBuy, runPaywallChoice, runTurn2, switchModel]);
   const runCheckout = useCallback(
     async (pack) => {
       let before = balance ?? (await client.wallet().catch(() => void 0))?.balance;
@@ -7006,11 +7151,20 @@ ${NO_SEARCH_INSTRUCTION}`),
         stopped = signal.aborted;
       });
       if (credited) {
-        return push({
+        push({
           kind: "notice",
           tone: "good",
           text: "  credits added \u2014 an invoice is on its way to the address on the payment."
         });
+        refreshPremium();
+        const pending = pendingPremiumRef.current ? pendingTaskRef.current : null;
+        if (pending) {
+          pendingTaskRef.current = null;
+          pendingPremiumRef.current = null;
+          push({ kind: "notice", tone: "good", text: "  premium is unlocked \xB7 continuing where you left off" });
+          await runTurn2(pending.task, pending.images);
+        }
+        return;
       }
       push({
         kind: "notice",
@@ -7018,7 +7172,7 @@ ${NO_SEARCH_INSTRUCTION}`),
         text: stopped ? "  stopped waiting. Credits still land when the payment clears \u2014 /wallet checks the balance." : "  no credits yet \u2014 the payment may still be clearing. /wallet checks the balance."
       });
     },
-    [balance, client, push, runBusy]
+    [balance, client, push, refreshPremium, runBusy, runTurn2]
   );
   const runCommand = useCallback(
     async (line2) => {
@@ -7099,15 +7253,21 @@ ${NO_SEARCH_INSTRUCTION}`),
             if (arg && !models.some((m) => m.id === arg)) {
               push({ kind: "notice", tone: "warn", text: `  unknown model: ${arg}` });
             }
-            const free = await client.wallet(signal).then((w) => {
+            const free = await client.wallet(signal, { premium: true }).then((w) => {
               setBalance(w.balance);
               setFreeTier(w.free_tier);
+              setPremium(w.premium);
               return w.free_tier;
-            }).catch(() => freeTier);
+            }).catch(() => {
+              setPremium(void 0);
+              return freeTier;
+            });
+            const premium2 = premiumRef.current;
+            const unlockUsd = client.premiumUnlockUsd;
             const items = models.map((m) => ({
               value: m.id,
               label: m.id,
-              hint: `${m.tier.padEnd(8)}${modelHint(m, free)}`,
+              hint: accessColumn(m, premium2) + (m.access === "premium" && premiumLocked(premium2) ? premiumUnlockHint(unlockUsd) : modelHint(m, free)),
               current: m.id === model
             }));
             const preselect = items.findIndex((i) => i.value === arg);
@@ -7121,6 +7281,16 @@ ${NO_SEARCH_INSTRUCTION}`),
                 saveConfig(config);
                 switchModel(choice.value);
                 push({ kind: "notice", text: `  model \u2192 ${choice.value}` });
+                const picked = models.find((m) => m.id === choice.value);
+                if (picked?.access === "premium" && premiumLocked(premium2)) {
+                  push({
+                    kind: "notice",
+                    tone: "warn",
+                    text: `  ${premiumHeadline(unlockUsd)}
+  ${choice.value} runs on credits you earned on the offer walls or bought.
+  /earn opens the offer walls` + (unlockUsd ? `, /buy unlocks premium from ${usd(unlockUsd)}.` : ".") + " Your bonus credits work on budget models."
+                  });
+                }
               }
             });
           });
@@ -7189,7 +7359,7 @@ ${NO_SEARCH_INSTRUCTION}`),
             catalogRef.current = ms;
             push({
               kind: "notice",
-              text: ms.map((m) => `  ${m.id.padEnd(24)} ${modelHint(m, freeTier)}`).join("\n")
+              text: ms.map((m) => `  ${m.id.padEnd(24)} ${accessColumn(m, premium)}${modelHint(m, freeTier)}`).join("\n")
             });
           });
           return;
@@ -7351,7 +7521,7 @@ ${NO_SEARCH_INSTRUCTION}`),
           push({ kind: "notice", tone: "warn", text: `  unknown command: /${cmd} \u2014 try /help` });
       }
     },
-    [client, cols, config, cycleMode, exit, model, push, root, runAdWall, runBusy, runBuy, runLogin, runTurn2, writeToStdout]
+    [client, cols, config, cycleMode, exit, model, premium, push, root, runAdWall, runBusy, runBuy, runLogin, runTurn2, setPremium, writeToStdout]
   );
   const runShell = useCallback(
     async (command) => {
@@ -7681,7 +7851,9 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
     if (key.return) {
       if (key.meta || key.shift) return setEditor(newline(editor));
       if (endsWithContinuation(editor)) return setEditor(continueLine(editor));
-      if (!busy && pendingTaskRef.current && isEmpty(editor)) return void runPaywallChoice();
+      if (!busy && pendingTaskRef.current && isEmpty(editor)) {
+        return void (pendingPremiumRef.current ? runPremiumChoice() : runPaywallChoice());
+      }
       return void submit(toText(editor));
     }
     if (key.ctrl && ch === "j") return setEditor(newline(editor));
@@ -7862,7 +8034,11 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   if (!busy && info && shape && balance !== void 0 && !effortRaised(info, resolveEffort(info, effortBy[model])) && typed.trim() !== "" && !/^[/!]/.test(typed.trimStart())) {
     const range = estimateTask(info, conversationUsed + schemaTokens + estimateTokens(typed), shape);
     const onFree = Boolean(info.free && freeTier?.models.includes(model));
-    const verdict = taskVerdict(range, { balance, ...onFree ? { freeLeft: freeTier.credits_left } : {} });
+    const spendable = info.access === "premium" && premium && !premium.unlocked ? Math.min(balance, premium.credits) : balance;
+    const verdict = taskVerdict(range, {
+      balance: spendable,
+      ...onFree ? { freeLeft: freeTier.credits_left } : {}
+    });
     estimate = estimateClause(range, verdict, !onFree && (freeTier?.credits_left ?? 0) > 0);
   }
   const modeText = `  ${MODE_STYLE[mode].glyph} ${MODE_LABEL[mode]}`;
@@ -8147,7 +8323,7 @@ function tailLines(text, max) {
   const lines = text.split("\n");
   return lines.length <= max ? text : lines.slice(-max).join("\n");
 }
-var WORKING, WAITING_FOR_REWARD, LOADING, COMPACTING, SIGNING_IN, RUNNING, SENDING_FEEDBACK, WAITING_FOR_PAYMENT, FEEDBACK_TURN_INTERVAL, NOT_SIGNED_IN, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES, DELTA_FLUSH_MS, MAX_INPUT_ROWS, MAX_PICKER_ROWS, MAX_QUEUE_ROWS, QUEUE_MARKER, PICKER_CURRENT, MIN_PICKER_LABEL_COLS, PICKER_CHROME, PICKER_CHROME_COMPACT, ASK_CHROME, PLAN_CHROME, BUY_CHROME, BUY_CHROME_COMPACT, ASK_HINT, PLAN_HINT, BUY_HINT, BUY_CONFIRM_WORD, BUY_TYPED_MAX, BUY_TOO_SHORT, EXPAND_MAX_LINES, FALLBACK_ROWS, FALLBACK_COLS, INIT_HINT_AFTER_TURNS, EARN_ROW, CONTEXT_NOTICE_AT, KEEP_ALWAYS;
+var WORKING, WAITING_FOR_REWARD, LOADING, COMPACTING, SIGNING_IN, RUNNING, SENDING_FEEDBACK, WAITING_FOR_PAYMENT, FEEDBACK_TURN_INTERVAL, NOT_SIGNED_IN, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES, DELTA_FLUSH_MS, MAX_INPUT_ROWS, MAX_PICKER_ROWS, MAX_QUEUE_ROWS, QUEUE_MARKER, PICKER_CURRENT, MIN_PICKER_LABEL_COLS, PICKER_CHROME, PICKER_CHROME_COMPACT, ASK_CHROME, PLAN_CHROME, BUY_CHROME, BUY_CHROME_COMPACT, ASK_HINT, PLAN_HINT, BUY_HINT, BUY_CONFIRM_WORD, BUY_TYPED_MAX, BUY_TOO_SHORT, EXPAND_MAX_LINES, FALLBACK_ROWS, FALLBACK_COLS, INIT_HINT_AFTER_TURNS, EARN_ROW, BUY_ROW, CONTEXT_NOTICE_AT, KEEP_ALWAYS;
 var init_app = __esm({
   "src/tui/app.tsx"() {
     "use strict";
@@ -8231,6 +8407,7 @@ var init_app = __esm({
     FALLBACK_COLS = 80;
     INIT_HINT_AFTER_TURNS = 3;
     EARN_ROW = "\0earn";
+    BUY_ROW = "\0buy";
     CONTEXT_NOTICE_AT = 0.6;
     KEEP_ALWAYS = Number.POSITIVE_INFINITY;
   }
@@ -8469,16 +8646,39 @@ function earnedToday(w) {
 }
 async function listModels(client) {
   const models = await client.models();
-  const free = await client.wallet().then((w) => w.free_tier).catch(() => void 0);
+  const wallet = await client.wallet(void 0, { premium: true }).catch(() => void 0);
+  const free = wallet?.free_tier;
+  const premium = wallet?.premium;
   console.log(c.bold("Models  (credit prices per 1M tokens)"));
   for (const m of models) {
     const tag = m.ad_fundable ? "" : c.dim(" [paid/BYOK]");
     const turns2 = free?.models.includes(m.id) ? free.turns_left[m.id] ?? 0 : void 0;
     const freeTag = !m.free ? "" : turns2 === void 0 ? c.green(" [free]") : turns2 > 0 ? c.green(` [free: ~${turns2} turn${turns2 === 1 ? "" : "s"} left today]`) : c.dim(" [free: none left today]");
+    const lockTag = m.access === "premium" && premiumLocked(premium) ? c.yellow(` [${premiumHeadline(client.premiumUnlockUsd).replace(/\.$/, "")}]`) : "";
+    console.log(
+      `  ${c.cyan(m.id.padEnd(22))} ${accessColumn(m, premium)} in ${String(m.credits_per_mtoken_input).padStart(9)}  out ${String(m.credits_per_mtoken_output).padStart(9)}  ${adsPerTaskLabel(m.est_ads_per_task)}${tag}${freeTag}${lockTag}`
+    );
+  }
+}
+function printPremiumRefusal(err) {
+  console.log(c.yellow(premiumHeadline(err.unlockUsd)));
+  console.log(
+    c.yellow(`${err.model} is a premium model. It runs on credits you earned on the offer walls or bought.`)
+  );
+  if (err.premiumCredits > 0) {
     console.log(
-      `  ${c.cyan(m.id.padEnd(22))} ${m.tier.padEnd(8)} in ${String(m.credits_per_mtoken_input).padStart(9)}  out ${String(m.credits_per_mtoken_output).padStart(9)}  ${adsPerTaskLabel(m.est_ads_per_task)}${tag}${freeTag}`
+      c.yellow(
+        `This turn needs about ${err.neededCredits.toLocaleString("en-US")} of those credits, and you have ${err.premiumCredits.toLocaleString("en-US")}.`
+      )
     );
   }
+  console.log(c.yellow(`Run \`clixad earn\` for a survey on the offer walls. Offers pay ${grantLabel(err.grantPerAd)}.`));
+  if (err.unlockUsd) {
+    console.log(c.yellow(`Or unlock premium from ${usd(err.unlockUsd)}: start \`clixad\` and type /buy.`));
+  }
+  const freeLine = freeAlternativeLine(err.freeModels);
+  console.log(c.green(freeLine ?? "Your bonus credits still work on budget models: `clixad models` lists them."));
+  console.log(c.dim("  Nothing was charged for this request."));
 }
 async function setModel(client, config, model) {
   if (!model) return console.log(`current model: ${c.cyan(config.model)}`);
@@ -8493,6 +8693,18 @@ async function setModel(client, config, model) {
   config.model = model;
   saveConfig(config);
   console.log(c.green(`\u2713 model set to ${model}`));
+  const picked = known?.find((m) => m.id === model);
+  if (picked?.access === "premium") {
+    const w = await client.wallet(void 0, { premium: true }).catch(() => void 0);
+    if (premiumLocked(w?.premium)) {
+      console.log(c.yellow(premiumHeadline(client.premiumUnlockUsd)));
+      console.log(
+        c.yellow(
+          `${model} runs on credits you earned on the offer walls or bought. Run \`clixad earn\` for a survey` + (client.premiumUnlockUsd ? `, or start \`clixad\` and type /buy.` : ".")
+        )
+      );
+    }
+  }
 }
 async function showWallet(client) {
   const streak = await client.claimStreak();
@@ -8626,7 +8838,10 @@ ${NO_SEARCH_INSTRUCTION}`),
   [${cost} \xB7 balance ${res.balance} \xB7 ${res.steps} step(s)]`)
     );
   } catch (err) {
-    if (err instanceof PaywallError) {
+    if (err instanceof PremiumLockedError) {
+      console.log("");
+      printPremiumRefusal(err);
+    } else if (err instanceof PaywallError) {
       console.log(c.yellow(`
 ${shortfallHeadline(err, config.model)}`));
       const freeLine = freeAlternativeLine(err.freeModels);
@@ -8761,7 +8976,9 @@ async function runTurn(client, config, messages) {
     return result;
   } catch (err) {
     if (started) process.stdout.write("\n");
-    if (err instanceof PaywallError) {
+    if (err instanceof PremiumLockedError) {
+      printPremiumRefusal(err);
+    } else if (err instanceof PaywallError) {
       console.log(c.yellow(shortfallHeadline(err, config.model)));
       const freeLine = freeAlternativeLine(err.freeModels);
       if (freeLine) console.log(c.green(freeLine));
@@ -8785,9 +9002,9 @@ async function showStreak(client) {
   console.log(streak.claimed ? c.green(`  ${line2}`) : c.dim(`  ${line2}`));
   return streak;
 }
-async function safeWallet(client) {
+async function safeWallet(client, opts = {}) {
   try {
-    return await client.wallet();
+    return await client.wallet(void 0, opts);
   } catch {
     return void 0;
   }
@@ -8813,7 +9030,7 @@ async function startupReads(client, gatewayUrl) {
     )
   ];
   try {
-    const [streak, wallet] = await Promise.all([client.claimStreak(), safeWallet(client)]);
+    const [streak, wallet] = await Promise.all([client.claimStreak(), safeWallet(client, { premium: true })]);
     const balance = streak?.claimed ? streak.balance : wallet?.balance;
     return {
       streak,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clixad",
-  "version": "0.0.1-beta.26",
+  "version": "0.0.1-beta.27",
   "description": "Free AI coding agent in your terminal, funded by rewarded ads.",
   "license": "UNLICENSED",
   "type": "module",