clixad 0.0.1-beta.30 → 0.0.1-beta.32

package/README.md

@@ -15,6 +15,10 @@ cover it, for example `task ≈ 560–3.1k · free` or `task ≈ 7.5k–47k · n
 estimate from the size of the conversation and how tasks usually run; what is charged is what the
 model actually used.
 
+The same account also works in the browser, at <https://clixad.onrender.com/chat>: sign in with the
+GitHub account you use here. A model, a reasoning setting, your name and instructions set there or on
+its account page hold here too (from 0.0.1-beta.31), and `/model` and `/effort` here hold there.
+
 `/effort` sets how long the model thinks before it answers, saved separately for each model.
 Thinking is billed as output tokens like the answer, so a higher setting costs more credits per turn
 and a lower one costs less. `auto` leaves the model at its own default, and a model with nothing to

package/dist/clixad.mjs

@@ -324,6 +324,13 @@ function usd(v) {
 function packsFromClause(cheapestUsd) {
   return typeof cheapestUsd === "number" && cheapestUsd > 0 ? `, from ${usd(cheapestUsd)}` : "";
 }
+function parseSpendable(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const r = raw;
+  const ok = (v) => typeof v === "number" && Number.isFinite(v) && v >= 0;
+  if (!ok(r.budget) || !ok(r.premium) || !ok(r.budget_after_reset)) return void 0;
+  return { budget: r.budget, premium: r.premium, budgetAfterReset: r.budget_after_reset };
+}
 function usableStreak(streak) {
   if (typeof streak !== "object" || streak === null) return void 0;
   const s = streak;
@@ -432,6 +439,22 @@ function extraFormatIds(raw) {
   }
   return out;
 }
+function parseAccountSettings(body) {
+  if (!body || typeof body !== "object") return null;
+  const b = body;
+  const efforts = {};
+  if (b.efforts && typeof b.efforts === "object" && !Array.isArray(b.efforts)) {
+    for (const [k, v] of Object.entries(b.efforts)) if (typeof v === "string") efforts[k] = v;
+  }
+  const str = (v) => typeof v === "string" && v.trim() ? v : null;
+  return {
+    model: str(b.model),
+    efforts,
+    name: str(b.name),
+    instructions: str(b.instructions),
+    sponsorLine: typeof b.sponsor_line === "boolean" ? b.sponsor_line : null
+  };
+}
 function imagePart(image) {
   return { type: "image_url", image_url: { url: `data:${image.mimeType};base64,${image.data}` } };
 }
@@ -465,7 +488,11 @@ 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) {
+function spendableAt(raw, balance) {
+  const figures = parseSpendable(raw);
+  return figures && typeof balance === "number" && Number.isFinite(balance) ? { figures, balance } : void 0;
+}
+function premiumLockedError(message, model, body, spendable) {
   const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : 0;
   return new PremiumLockedError(
     message,
@@ -475,7 +502,8 @@ function premiumLockedError(message, model, body) {
     typeof body?.unlock_usd === "number" && body.unlock_usd > 0 ? body.unlock_usd : null,
     num(body?.grant_per_ad),
     freeAlternatives(body?.free_models),
-    usableStreak(body?.streak)
+    usableStreak(body?.streak),
+    spendable
   );
 }
 function shortfallHeadline(err, model) {
@@ -500,9 +528,23 @@ function freeAlternatives(list) {
 }
 async function refusal402(res, model) {
   const body = await res.json();
-  if (body.error === "premium_locked") return premiumLockedError(body.message ?? "", model, body.premium);
+  if (body.error === "premium_locked") {
+    return premiumLockedError(body.message ?? "", model, body.premium, spendableAt(body.spendable, body.balance));
+  }
   return paywallError(body);
 }
+async function refusal429(res) {
+  const text = await res.text().catch(() => "");
+  try {
+    const body = JSON.parse(text);
+    if (typeof body.error === "string" && LIMIT_REFUSALS.has(body.error) && typeof body.message === "string") {
+      return new LimitRefusalError(body.message, body.error, spendableAt(body.spendable, body.balance));
+    }
+  } catch {
+  }
+  const detail = safeDetail(text);
+  return new Error(detail ? `chat failed: 429 \u2014 ${detail}` : "chat failed: 429");
+}
 function neverConnected(code) {
   return code !== void 0 && NEVER_CONNECTED.has(code);
 }
@@ -627,7 +669,7 @@ async function* parseSSE(body) {
     }
   }
 }
-var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, PremiumLockedError, GatewayUnreachableError, NEVER_CONNECTED, AuthError, GatewayClient;
+var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, PremiumLockedError, LimitRefusalError, LIMIT_REFUSALS, GatewayUnreachableError, NEVER_CONNECTED, AuthError, GatewayClient;
 var init_client = __esm({
   "src/client.ts"() {
     "use strict";
@@ -680,7 +722,7 @@ var init_client = __esm({
       cheapestPackUsd;
     };
     PremiumLockedError = class extends Error {
-      constructor(message, model, neededCredits, premiumCredits, unlockUsd, grantPerAd, freeModels, streak) {
+      constructor(message, model, neededCredits, premiumCredits, unlockUsd, grantPerAd, freeModels, streak, spendable) {
         super(message);
         this.model = model;
         this.neededCredits = neededCredits;
@@ -689,6 +731,7 @@ var init_client = __esm({
         this.grantPerAd = grantPerAd;
         this.freeModels = freeModels;
         this.streak = streak;
+        this.spendable = spendable;
         this.name = "PremiumLockedError";
       }
       model;
@@ -698,7 +741,19 @@ var init_client = __esm({
       grantPerAd;
       freeModels;
       streak;
+      spendable;
     };
+    LimitRefusalError = class extends Error {
+      constructor(message, type, spendable) {
+        super(message);
+        this.type = type;
+        this.spendable = spendable;
+        this.name = "LimitRefusalError";
+      }
+      type;
+      spendable;
+    };
+    LIMIT_REFUSALS = /* @__PURE__ */ new Set(["paid_user_limit_reached", "paid_budget_spent", "paid_budget_unavailable"]);
     GatewayUnreachableError = class extends Error {
       constructor(host, code) {
         const where = `${host}${code ? ` (${code})` : ""}`;
@@ -840,6 +895,42 @@ var init_client = __esm({
        * is "say nothing about a streak". A missed grant is claimed by the next
        * command; a session that died over one would be a real loss.
        */
+      /**
+       * The account's preferences (gateway 0039), kept with the account so they
+       * hold in the browser's chat and here. Null when they cannot be read, and on
+       * a gateway too old to have them (404): a preference is never a reason for
+       * the REPL not to open.
+       */
+      async getSettings(signal) {
+        try {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/account/settings`, {
+            headers: this.headers(),
+            ...signal ? { signal } : {}
+          });
+          if (!res.ok) return null;
+          return parseAccountSettings(await res.json());
+        } catch {
+          return null;
+        }
+      }
+      /**
+       * Change the preferences a request names. Best-effort and never throws: a
+       * model picked here is saved locally whatever the gateway says, and a
+       * failed sync costs only that the browser's chat does not follow.
+       */
+      async saveSettings(change) {
+        try {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/account/settings`, {
+            method: "PUT",
+            headers: { ...this.headers(), "Content-Type": "application/json" },
+            body: JSON.stringify(change)
+          });
+          if (!res.ok) return null;
+          return parseAccountSettings(await res.json());
+        } catch {
+          return null;
+        }
+      }
       async claimStreak(signal) {
         try {
           const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/streak/claim`, {
@@ -1361,16 +1452,19 @@ var init_client = __esm({
         );
         if (res.status === 401) throw await authFailure(res, "chat");
         if (res.status === 402) throw await refusal402(res, model);
+        if (res.status === 429) throw await refusal429(res);
         if (!res.ok) throw new Error(await httpFailure(res, "chat"));
         const data = await res.json();
         const choice = data.choices[0];
         if (!choice) throw new Error("chat: no choices in response");
+        const spendable = parseSpendable(data.clixad.spendable);
         return {
           message: choice.message,
           finishReason: choice.finish_reason,
           creditsCharged: data.clixad.credits_charged,
           balance: data.clixad.balance,
-          ...freeMeta(data.clixad)
+          ...freeMeta(data.clixad),
+          ...spendable ? { spendable } : {}
         };
       }
       /**
@@ -1399,6 +1493,8 @@ var init_client = __esm({
         let free = {};
         let balance = 0;
         let streamError;
+        let streamErrorType;
+        let spendable;
         let premiumRefusal;
         const calls = /* @__PURE__ */ new Map();
         const reasoning = [];
@@ -1421,24 +1517,36 @@ 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) {
+            streamError = json.error.message || "the model stream failed";
+            streamErrorType = json.error.type;
+          }
           if (json.error?.type === "premium_locked") {
-            premiumRefusal = premiumLockedError(streamError ?? "", model, json.clixad?.premium);
+            premiumRefusal = premiumLockedError(
+              streamError ?? "",
+              model,
+              json.clixad?.premium,
+              spendableAt(json.clixad?.spendable, json.clixad?.balance)
+            );
           }
           if (json.clixad) {
             creditsCharged = json.clixad.credits_charged;
             balance = json.clixad.balance;
             free = freeMeta(json.clixad);
+            spendable = parseSpendable(json.clixad.spendable);
           }
         }
         if (premiumRefusal) throw premiumRefusal;
+        if (streamError && streamErrorType && LIMIT_REFUSALS.has(streamErrorType)) {
+          throw new LimitRefusalError(streamError, streamErrorType, spendable ? { figures: spendable, balance } : void 0);
+        }
         if (streamError) throw new Error(streamError);
         const message = { role: "assistant", content: content || null };
         if (calls.size > 0) {
           message.tool_calls = [...calls.entries()].sort(([a], [b]) => a - b).map(([, c2]) => c2);
           if (reasoning.length) message.reasoning_details = reasoning;
         }
-        return { message, finishReason, creditsCharged, balance, ...free };
+        return { message, finishReason, creditsCharged, balance, ...free, ...spendable ? { spendable } : {} };
       }
     };
   }
@@ -1638,6 +1746,46 @@ var init_config = __esm({
   }
 });
 
+// src/preferences.ts
+async function syncPreferences(client, config, settings) {
+  if (!settings) return { name: null, instructions: null, sponsorLine: null };
+  const upload = {};
+  if (settings.model && settings.model !== config.model) {
+    config.model = settings.model;
+    saveConfig(config);
+  } else if (!settings.model && config.model && config.model !== FALLBACK_MODEL) {
+    upload.model = config.model;
+  }
+  const local = config.effort ?? {};
+  for (const [model, level] of Object.entries(settings.efforts)) {
+    if (local[model] !== level) saveEffort(config, model, level);
+  }
+  const localOnly = {};
+  for (const [model, level] of Object.entries(local)) {
+    if (!(model in settings.efforts)) localOnly[model] = level;
+  }
+  if (Object.keys(localOnly).length) upload.efforts = localOnly;
+  if (Object.keys(upload).length) await client.saveSettings(upload).catch(() => null);
+  return { name: settings.name, instructions: settings.instructions, sponsorLine: settings.sponsorLine };
+}
+function preferencesInstruction(prefs) {
+  if (!prefs) return "";
+  const parts = [];
+  if (prefs.name) parts.push(`The person's name is ${prefs.name}.`);
+  if (prefs.instructions) parts.push(`What the person wants you to keep in mind in every answer:
+${prefs.instructions}`);
+  return parts.join("\n\n");
+}
+function sponsorPreference(config, prefs) {
+  return prefs?.sponsorLine === false ? false : config.sponsor;
+}
+var init_preferences = __esm({
+  "src/preferences.ts"() {
+    "use strict";
+    init_config();
+  }
+});
+
 // src/browser.ts
 import { spawn } from "node:child_process";
 function openBrowser(url) {
@@ -4368,7 +4516,8 @@ ${NO_SEARCH_INSTRUCTION}`,
         free: true,
         creditsWaived: turn.creditsWaived ?? 0,
         freeCreditsLeft: turn.freeCreditsLeft ?? 0
-      } : {}
+      } : {},
+      ...turn.spendable ? { spendable: turn.spendable } : {}
     });
   }
   let retriedEmpty = false;
@@ -4940,12 +5089,12 @@ var init_kimi = __esm({
     CONTEXT_TOKENS = {
       "gpt-5-nano": 4e5,
       "gemini-2.5-flash-lite": 1048576,
+      "claude-haiku-5.5": 1e6,
       "deepseek-v4-flash": 1048576,
       "gemini-3.5-flash-lite": 1048576,
       "kimi-k2.5": 262144,
       "gemini-3.8-flash": 1048576,
       "kimi-k2.7-code": 262144,
-      "claude-haiku-4.5": 2e5,
       "claude-sonnet-5.5": 1e6,
       "gpt-6-sol": 105e4,
       "kimi-k3": 1048576,
@@ -4955,14 +5104,17 @@ var init_kimi = __esm({
       // packages/pricing), so an install still configured with one compacts
       // against the window of the model that actually answers.
       "gemini-3.1-flash-lite": 1048576,
-      "kimi-k2": 262144,
+      // Served by Claude Haiku 5.5 since 2026-10-12, when Kimi K2.5 left the free set.
+      "kimi-k2": 1e6,
       "gemini-3.6-flash": 1048576,
       "gpt-5.2": 105e4,
       "claude-opus-5": 1e6,
       "gpt-5.5": 105e4,
       "gpt-5.2-pro": 105e4,
       // Retired on 2026-09-29 for Claude Sonnet 5.5, same window.
-      "claude-sonnet-5": 1e6
+      "claude-sonnet-5": 1e6,
+      // Retired on 2026-10-12 for Claude Haiku 5.5.
+      "claude-haiku-4.5": 1e6
     };
     DEFAULT_CONTEXT_TOKENS = 256e3;
     INSTALL_HELP = `Kimi CLI is not installed (or not on PATH).
@@ -5401,6 +5553,7 @@ ${summary}` },
     summary,
     creditsCharged: turn.creditsCharged,
     balance: turn.balance,
+    ...turn.spendable ? { spendable: turn.spendable } : {},
     before,
     after: conversationTokens(compacted)
   };
@@ -6090,12 +6243,22 @@ function headRows(text, cols, max) {
   if (rows.length <= max) return text;
   return rows.slice(0, max).join("\n");
 }
-function errorNotice(message, rows = ERROR_NOTICE_ROWS) {
+function errorNotice(message, rows = ERROR_NOTICE_ROWS, indent = "") {
   const clean = message.replace(/\u001b\][^\u0007]*(?:\u0007|\u001b\\)?/g, " ").replace(/\u001b\[[0-9;?]*[ -\/]*[@-~]/g, " ").replace(/[\u0000-\u0009\u000b-\u001f\u007f-\u009f]/g, " ");
   const lines = clean.split("\n");
-  const kept = lines.slice(0, rows).map((l) => l.length > ERROR_NOTICE_COLS ? `${l.slice(0, ERROR_NOTICE_COLS - 1)}\u2026` : l);
-  if (lines.length > rows) kept.push(`  \u2026 +${lines.length - rows} more lines`);
-  return kept.join("\n");
+  const kept = [];
+  let left = ERROR_NOTICE_CHARS;
+  for (const line2 of lines.slice(0, rows)) {
+    if (line2.length > left) {
+      kept.push(`${line2.slice(0, Math.max(0, left - 1))}\u2026`);
+      break;
+    }
+    kept.push(line2);
+    left -= line2.length;
+  }
+  if (lines.length > kept.length) kept.push(`\u2026 +${lines.length - kept.length} more lines`);
+  return kept.join(`
+${indent}`);
 }
 function entryHeight(entry, cols) {
   const margin = entry.kind === "banner" ? 0 : 1;
@@ -6143,7 +6306,7 @@ function EntryView({ entry }) {
       ) });
   }
 }
-var MANGO3, MANGO_BRIGHT, SLATE, AD_TEXT, AD_MARK, MODE_STYLE, WRAP_LIKE_INK, DIALOG_CHROME_COLS, ERROR_NOTICE_ROWS, ERROR_NOTICE_COLS;
+var MANGO3, MANGO_BRIGHT, SLATE, AD_TEXT, AD_MARK, MODE_STYLE, WRAP_LIKE_INK, DIALOG_CHROME_COLS, ERROR_NOTICE_ROWS, ERROR_NOTICE_CHARS;
 var init_views = __esm({
   "src/tui/views.tsx"() {
     "use strict";
@@ -6162,7 +6325,7 @@ var init_views = __esm({
     WRAP_LIKE_INK = { trim: false, hard: true };
     DIALOG_CHROME_COLS = 4;
     ERROR_NOTICE_ROWS = 12;
-    ERROR_NOTICE_COLS = 200;
+    ERROR_NOTICE_CHARS = 2400;
   }
 });
 
@@ -6187,6 +6350,9 @@ function buyConfirmLines(pack) {
     `Terms: ${TERMS_URL}`
   ].join("\n");
 }
+function utcDay(t = Date.now()) {
+  return new Date(t).toISOString().slice(0, 10);
+}
 function useTerminalSize() {
   const { stdout } = useStdout();
   const snapshot2 = useRef({
@@ -6224,9 +6390,11 @@ function App({
   sponsorServe,
   sponsorFormats,
   sponsorDirect,
-  initHint
+  initHint,
+  preferences
 }) {
   const { exit } = useApp();
+  const preferencesText = preferencesInstruction(preferences);
   const { stdout, write: writeToStdout } = useStdout();
   const idRef = useRef(1);
   const { rows, cols } = useTerminalSize();
@@ -6270,7 +6438,8 @@ function App({
   const switchModel = useCallback((id) => {
     modelRef.current = id;
     setModel2(id);
-  }, []);
+    void client.saveSettings?.({ model: id });
+  }, [client]);
   const [hist, setHist] = useState(() => loadHistory());
   const [histIdx, setHistIdx] = useState(-1);
   const [sel, setSel] = useState(0);
@@ -6307,6 +6476,7 @@ function App({
   const runStartedAtRef = useRef(Date.now());
   const contextRef = useRef(collectContext(root));
   const catalogRef = useRef([]);
+  const [, setCatalogArrived] = useState(0);
   const searchRef = useRef(false);
   const outputsRef = useRef([]);
   const expandedRef = useRef(/* @__PURE__ */ new Set());
@@ -6328,6 +6498,52 @@ function App({
   const refreshPremium = useCallback(() => {
     void client.wallet(void 0, { premium: true }).then((w) => setPremium(w.premium)).catch(() => void 0);
   }, [client, setPremium]);
+  const initialSpendable = useMemo(() => {
+    const figures = parseSpendable(wallet?.spendable);
+    return figures && wallet ? { figures, balance: wallet.balance, day: utcDay() } : void 0;
+  }, []);
+  const [spendable, setSpendableState] = useState(initialSpendable);
+  const spendableRef = useRef(initialSpendable);
+  const takeSpendable = useCallback(
+    (figures, balance2) => {
+      const next = { figures, balance: balance2, day: utcDay() };
+      spendableRef.current = next;
+      setSpendableState(next);
+      setBalance(balance2);
+      const p = premiumRef.current;
+      if (p) setPremium({ ...p, credits: figures.premium });
+    },
+    [setPremium]
+  );
+  const balanceSeqRef = useRef(0);
+  const spendableInFlightRef = useRef(false);
+  const spendableAskedRef = useRef(null);
+  const refreshSpendable = useCallback(() => {
+    if (spendableInFlightRef.current) return;
+    spendableInFlightRef.current = true;
+    const seq = balanceSeqRef.current;
+    void client.wallet(void 0, { premium: true }).then((w) => {
+      if (balanceSeqRef.current !== seq) return;
+      const figures = parseSpendable(w.spendable);
+      if (figures) takeSpendable(figures, w.balance);
+      else setBalance(w.balance);
+      if (w.premium) setPremium(w.premium);
+    }).catch(() => void 0).finally(() => {
+      spendableInFlightRef.current = false;
+    });
+  }, [client, setPremium, takeSpendable]);
+  const [dayTick, setDayTick] = useState(0);
+  useEffect(() => {
+    const now = Date.now();
+    const next = Date.UTC(
+      new Date(now).getUTCFullYear(),
+      new Date(now).getUTCMonth(),
+      new Date(now).getUTCDate() + 1
+    );
+    const timer = setTimeout(() => setDayTick((t) => t + 1), next - now + 1e3);
+    timer.unref?.();
+    return () => clearTimeout(timer);
+  }, [dayTick]);
   const mcpRef = useRef(McpHub.empty());
   const todosRef = useRef(new TodoList());
   const lastTurnRef = useRef(null);
@@ -6482,6 +6698,7 @@ function App({
     }
     client.models().then((m) => {
       catalogRef.current = m;
+      setCatalogArrived((n) => n + 1);
       searchRef.current = client.capabilities?.web_search === true;
       const successor = client.retiredModels[modelRef.current];
       if (successor) {
@@ -6544,7 +6761,7 @@ function App({
       if (!sponsorEnabled({
         isTTY: stdout.isTTY,
         env: process.env,
-        configEnabled: config.sponsor
+        configEnabled: sponsorPreference(config, preferences)
       })) {
         setSponsor(null);
         setAdSlots({});
@@ -6746,8 +6963,11 @@ function App({
           push({ kind: "notice", text: `  showing the model: ${event.labels.join(", ")}` });
           return;
         case "usage":
+          balanceSeqRef.current++;
           setBalance(event.balance);
-          if (event.creditsCharged > 0 && premiumRef.current) {
+          if (event.spendable) {
+            takeSpendable(event.spendable, event.balance);
+          } else if (event.creditsCharged > 0 && premiumRef.current) {
             const p = premiumRef.current;
             setPremium({
               ...p,
@@ -6765,8 +6985,18 @@ function App({
           return;
       }
     },
-    [cols, flushDelta, push, setPremium]
+    [cols, flushDelta, push, setPremium, takeSpendable]
   );
+  useEffect(() => {
+    if (balance === void 0) return;
+    const s = spendableRef.current;
+    const day = utcDay();
+    if (s && s.balance === balance && s.day === day) return;
+    const key = `${balance}|${day}`;
+    if (spendableAskedRef.current === key) return;
+    spendableAskedRef.current = key;
+    refreshSpendable();
+  }, [balance, spendable, dayTick, refreshSpendable]);
   const runTurn2 = useCallback(
     async (task, images = []) => {
       pendingFreeRef.current = [];
@@ -6789,7 +7019,9 @@ function App({
           if (res) {
             history = res.messages.slice(1);
             setMessages(history);
+            balanceSeqRef.current++;
             setBalance(res.balance);
+            if (res.spendable) takeSpendable(res.spendable, res.balance);
             setSpent((s) => s + res.creditsCharged);
             push({
               kind: "notice",
@@ -6817,7 +7049,11 @@ function App({
 
 ${modeInstruction(permRef.current.mode)}` + (searchRef.current ? "" : `
 
-${NO_SEARCH_INSTRUCTION}`),
+${NO_SEARCH_INSTRUCTION}`) + // The account's name and instructions (gateway 0039), set in the
+          // browser or on the account page, said on every turn.
+          (preferencesText ? `
+
+${preferencesText}` : ""),
           permit,
           approvePlan,
           askUser: askQuestion,
@@ -6907,6 +7143,10 @@ ${NO_SEARCH_INSTRUCTION}`),
           }
         }
       } catch (err) {
+        if ((err instanceof LimitRefusalError || err instanceof PremiumLockedError) && err.spendable) {
+          balanceSeqRef.current++;
+          takeSpendable(err.spendable.figures, err.spendable.balance);
+        }
         if (err instanceof PremiumLockedError) {
           pendingTaskRef.current = { task, images };
           pendingPremiumRef.current = err;
@@ -6956,7 +7196,7 @@ ${NO_SEARCH_INSTRUCTION}`),
         } else if (err instanceof AuthError) {
           push({ kind: "notice", tone: "error", text: NOT_SIGNED_IN });
         } else {
-          push({ kind: "notice", tone: "error", text: `  error: ${errorNotice(err.message)}` });
+          push({ kind: "notice", tone: "error", text: `  error: ${errorNotice(err.message, void 0, "  ")}` });
         }
       } finally {
         abortRef.current = null;
@@ -6981,7 +7221,8 @@ ${NO_SEARCH_INSTRUCTION}`),
       nextSponsor,
       permit,
       push,
-      root
+      root,
+      takeSpendable
     ]
   );
   const stopCurrent = useCallback(() => {
@@ -7000,7 +7241,7 @@ ${NO_SEARCH_INSTRUCTION}`),
       } catch (err) {
         if (ac.signal.aborted) push({ kind: "notice", tone: "warn", text: "  (stopped)" });
         else if (err instanceof AuthError) push({ kind: "notice", tone: "error", text: NOT_SIGNED_IN });
-        else push({ kind: "notice", tone: "error", text: `  ${errorNotice(err.message)}` });
+        else push({ kind: "notice", tone: "error", text: `  ${errorNotice(err.message, void 0, "  ")}` });
       } finally {
         busyAbortRef.current = null;
         setBusyLabel(WORKING);
@@ -7442,6 +7683,7 @@ ${NO_SEARCH_INSTRUCTION}`),
             const defaultWords = fallback ? effortLabel(fallback) : "its default";
             const apply2 = (choice, note = "") => {
               saveEffort(config, model, choice);
+              void client.saveSettings?.({ efforts: { [model]: choice ?? "auto" } });
               setEffortBy({ ...config.effort ?? {} });
               const now = choice ? effortLabel(choice) : `auto (${defaultWords})`;
               push({ kind: "notice", text: `  ${name}: ${now}${note}` });
@@ -7492,8 +7734,13 @@ ${NO_SEARCH_INSTRUCTION}`),
         case "wallet":
           await runBusy(LOADING, async (signal) => {
             const streakNow = await client.claimStreak(signal);
-            const w = await client.wallet(signal);
-            setBalance(w.balance);
+            const w = await client.wallet(signal, { premium: true });
+            const figures = parseSpendable(w.spendable);
+            balanceSeqRef.current++;
+            if (figures) takeSpendable(figures, w.balance);
+            else setBalance(w.balance);
+            if (w.premium) setPremium(w.premium);
+            const usableNow = figures ? walletUsableLines(w.balance, figures) : [];
             const reversals = w.ledger.filter((e) => e.reason === "ad_reversal");
             const reversed = reversals.reduce((sum, e) => sum + Math.abs(e.delta), 0);
             const screenouts = w.screenouts_today ?? 0;
@@ -7501,7 +7748,8 @@ ${NO_SEARCH_INSTRUCTION}`),
             const streakLine = streakNow && streakLabel(streakNow);
             push({
               kind: "notice",
-              text: `  balance ${w.balance.toLocaleString("en-US")} credits \xB7 ${w.ads_today} offers today \xB7 $${w.earned_usd_today.toFixed(2)}/$${w.max_reward_usd_per_day.toFixed(2)} earned` + (screenouts ? `
+              text: `  balance ${w.balance.toLocaleString("en-US")} credits \xB7 ${w.ads_today} offers today \xB7 $${w.earned_usd_today.toFixed(2)}/$${w.max_reward_usd_per_day.toFixed(2)} earned` + usableNow.map((l) => `
+  ${l}`).join("") + (screenouts ? `
   plus ${screenoutCredits.toLocaleString("en-US")} credits from ${screenouts} screenout bonus${screenouts === 1 ? "" : "es"} \u2014 attempts that didn't qualify, which CPX pays a little for anyway.` : "") + (streakLine ? `
   ${streakLine}` : "") + (reversals.length ? `
   recently: ${reversed.toLocaleString("en-US")} credits from ${reversals.length} offer${reversals.length === 1 ? "" : "s"} were reversed by the provider. Run \`clixad wallet\` for the full ledger.` : "")
@@ -8156,14 +8404,25 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   const typed = toText(editor);
   let estimate;
   const info = catalogRef.current.find((m) => m.id === model);
+  const usable = (() => {
+    const s = spendable;
+    if (!s || balance === void 0 || s.balance !== balance || s.day !== utcDay() || !info?.access) return void 0;
+    const credits2 = Math.max(0, Math.min(balance, info.access === "premium" ? s.figures.premium : s.figures.budget));
+    return {
+      kind: info.access,
+      credits: credits2,
+      locked: Math.max(0, balance - credits2),
+      afterReset: Math.max(credits2, Math.min(balance, s.figures.budgetAfterReset))
+    };
+  })();
   const effortNow = info ? resolveEffort(info, effortBy[model]) : effortBy[model];
   const shape = client.taskShape;
   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 spendable = info.access === "premium" && premium && !premium.unlocked ? Math.min(balance, premium.credits) : balance;
+    const canSpend = usable ? usable.credits : info.access === "premium" && premium && !premium.unlocked ? Math.min(balance, premium.credits) : balance;
     const verdict = taskVerdict(range, {
-      balance: spendable,
+      balance: canSpend,
       ...onFree ? { freeLeft: freeTier.credits_left } : {}
     });
     estimate = estimateClause(range, verdict, !onFree && (freeTier?.credits_left ?? 0) > 0);
@@ -8175,6 +8434,7 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
         model,
         ...effortNow ? { effort: effortNow } : {},
         balance,
+        ...usable ? { usable } : {},
         spent,
         contextPct,
         minutes: (Date.now() - runStartedAtRef.current) / 6e4,
@@ -8360,15 +8620,41 @@ function turnMeta(result) {
   }
   return `[free \xB7 ${n(result.creditsWaived)} credits waived${left}]`;
 }
+function lockedPhrasings(u) {
+  if (!u || u.locked <= 0) return [];
+  const n = (v) => v.toLocaleString("en-US");
+  const locked = `${n(u.locked)} bonus locked`;
+  if (u.kind === "premium") return [`${locked} on premium`, locked];
+  const back = u.afterReset - u.credits;
+  return back >= u.locked ? [`${locked} until 00:00 UTC`, locked] : back > 0 ? [`${locked}, ${n(back)} usable from 00:00 UTC`, locked] : [locked];
+}
+function walletUsableLines(balance, f) {
+  const n = (v) => Math.max(0, v).toLocaleString("en-US");
+  const budget = Math.min(balance, f.budget);
+  const premium = Math.min(balance, f.premium);
+  if (budget >= balance && premium >= balance) return [];
+  const lines = [`usable now: ${n(budget)} credits on budget models, ${n(premium)} on premium models`];
+  const locked = balance - budget;
+  if (locked > 0) {
+    const back = Math.min(balance, Math.max(budget, f.budgetAfterReset)) - budget;
+    lines.push(
+      back >= locked ? `${n(locked)} bonus credits are over today's limit and become usable at 00:00 UTC` : back > 0 ? `${n(locked)} bonus credits are over today's limit: ${n(back)} become usable at 00:00 UTC, the rest on later days` : `${n(locked)} bonus credits are over today's limit`
+    );
+  }
+  return lines;
+}
 function statusLine(o, cols) {
   const phrasings = o.estimate === void 0 ? [] : typeof o.estimate === "string" ? [o.estimate] : [...o.estimate];
+  const locked = lockedPhrasings(o.usable);
   for (const estimate of [...phrasings, void 0]) {
-    const line2 = statusRow(o, estimate, cols);
-    if (estimate === void 0 || visibleLength(line2) <= cols) return fitRow(line2, cols);
+    for (const held of [...locked, void 0]) {
+      const line2 = statusRow(o, estimate, held, cols);
+      if (visibleLength(line2) <= cols) return line2;
+    }
   }
-  return fitRow(statusRow(o, void 0, cols), cols);
+  return fitRow(statusRow(o, void 0, void 0, cols), cols);
 }
-function statusRow(o, estimate, cols) {
+function statusRow(o, estimate, locked, cols) {
   const burn = o.spent > 0 && o.minutes >= 1 ? `${Math.round(o.spent / o.minutes).toLocaleString("en-US")} cr/min` : void 0;
   const clauses = [
     { text: o.model, rank: KEEP_ALWAYS },
@@ -8377,9 +8663,15 @@ function statusRow(o, estimate, cols) {
     {
       // "? cr" rather than "0 cr": unknown is not empty, and an empty-looking
       // wallet is the one misreading on this row that frightens somebody.
-      text: o.balance === void 0 ? "? cr" : `${o.balance.toLocaleString("en-US")} cr`,
+      // With part of the balance held back, what can be spent takes its place:
+      // "33,396 cr" over a wallet the gateway refused to spend from was how
+      // this row came to be read as a fault (2026-10-12).
+      text: o.balance === void 0 ? "? cr" : o.usable && o.usable.locked > 0 ? `${o.usable.credits.toLocaleString("en-US")} cr usable` : `${o.balance.toLocaleString("en-US")} cr`,
       rank: KEEP_ALWAYS
     },
+    // Never dropped inside a row: `statusLine` tries its shorter phrasings,
+    // then none, as it does for the preview.
+    { text: locked, rank: 5 },
     // Above the context warning, below the balance. It is the second number
     // deciding whether the next turn costs anything, and unlike the spend it is
     // *news* — it only exists while a free model is selected and it counts down.
@@ -8459,6 +8751,7 @@ var init_app = __esm({
     init_todos();
     init_shells();
     init_config();
+    init_preferences();
     init_effort();
     init_login();
     init_banner();
@@ -8568,6 +8861,7 @@ var init_tui = __esm({
 // src/main.ts
 init_client();
 init_config();
+init_preferences();
 init_login();
 init_free_tier();
 init_agent();
@@ -9076,7 +9370,8 @@ async function repl(client, config, opts = {}) {
     session = loadSession(opts.resume);
     if (!session) return console.log(c.red(`no such session: ${opts.resume}`));
   }
-  const { streak, wallet } = await startupReads(client, config.gatewayUrl);
+  const { streak, wallet, settings } = await startupReads(client, config.gatewayUrl);
+  const preferences = await syncPreferences(client, config, settings);
   const cwd = process.cwd();
   const initHint = shouldSuggestInit(cwd) ? { returning: hasSessionIn(cwd) } : void 0;
   clearScreen();
@@ -9088,6 +9383,7 @@ async function repl(client, config, opts = {}) {
     streak,
     session,
     newAccount,
+    preferences,
     initialTask: opts.task,
     ...opts.notices?.length ? { notices: opts.notices } : {},
     ...initHint ? { initHint } : {}
@@ -9166,10 +9462,15 @@ async function startupReads(client, gatewayUrl) {
     )
   ];
   try {
-    const [streak, wallet] = await Promise.all([client.claimStreak(), safeWallet(client, { premium: true })]);
+    const [streak, wallet, settings] = await Promise.all([
+      client.claimStreak(),
+      safeWallet(client, { premium: true }),
+      client.getSettings()
+    ]);
     const balance = streak?.claimed ? streak.balance : wallet?.balance;
     return {
       streak,
+      settings,
       wallet: wallet && balance !== void 0 ? { ...wallet, balance } : wallet
     };
   } finally {

package/package.json

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