clixad 0.0.1-beta.25 → 0.0.1-beta.27

package/README.md

@@ -15,6 +15,12 @@ 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.
 
+`/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
+adjust says so. The cost preview is not shown while a setting above the model's default is active,
+because it is measured at the defaults.
+
 **Early beta.** Commands, interfaces and credit mechanics may change between beta versions. Run the
 most recent published build with:
 

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();
@@ -1228,15 +1298,13 @@ var init_client = __esm({
         return retry;
       }
       /** Non-streaming chat. Kept for scripted/one-shot paths; the REPL streams. */
-      async chat(messages, model, tools, signal) {
+      async chat(messages, model, tools, signal, effort) {
         const res = await this.postChat(
-          { model, messages, stream: false, ...tools ? { tools } : {} },
+          { model, messages, stream: false, ...tools ? { tools } : {}, ...effort ? { reasoning_effort: effort } : {} },
           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];
@@ -1257,13 +1325,17 @@ var init_client = __esm({
        */
       async chatStream(messages, model, opts = {}) {
         const res = await this.postChat(
-          { model, messages, stream: true, ...opts.tools ? { tools: opts.tools } : {} },
+          {
+            model,
+            messages,
+            stream: true,
+            ...opts.tools ? { tools: opts.tools } : {},
+            ...opts.effort ? { reasoning_effort: opts.effort } : {}
+          },
           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";
@@ -1271,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)) {
@@ -1293,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) {
@@ -1460,6 +1537,18 @@ function saveConfig(config) {
   } catch {
   }
 }
+function saveEffort(config, model, level) {
+  const current = readStored();
+  const onDisk = current.problem ? void 0 : current.stored.effort;
+  const next = {};
+  for (const [id, value] of Object.entries(onDisk && typeof onDisk === "object" ? onDisk : {})) {
+    if (typeof value === "string") next[id] = value;
+  }
+  if (level === void 0) delete next[model];
+  else next[model] = level;
+  config.effort = Object.keys(next).length ? next : void 0;
+  saveConfig(config);
+}
 function configPath() {
   return CONFIG_PATH;
 }
@@ -4173,6 +4262,9 @@ async function runAgent(client, task, opts) {
     onProgress?.(`${description}: starting`);
     const sub = await runAgent(client, prompt, {
       model: opts.model,
+      // The setting somebody chose for this model, the same as the parent's
+      // calls: a sub-agent's credits land on the same turn.
+      effort: opts.effort,
       root: opts.root,
       // A sub-agent that was told it can search the web, on a gateway that
       // cannot, spends its whole step budget discovering that.
@@ -4226,6 +4318,7 @@ ${NO_SEARCH_INSTRUCTION}`,
     let turn;
     try {
       turn = await client.chatStream(messages, opts.model, {
+        effort: opts.effort,
         tools: opts.tools ? opts.tools() : TOOL_SCHEMA,
         signal: opts.signal,
         onDelta: (text) => emit({ type: "delta", text })
@@ -5097,6 +5190,50 @@ var init_version = __esm({
   }
 });
 
+// src/effort.ts
+function isLevel(value) {
+  return typeof value === "string" && EFFORT_LEVELS.includes(value);
+}
+function effortsOf(info) {
+  return (info?.efforts ?? []).filter(isLevel);
+}
+function parseEffortArg(arg) {
+  const v = arg.trim().toLowerCase();
+  if (v === "auto" || v === "default") return "auto";
+  if (v === "none") return "off";
+  return isLevel(v) ? v : void 0;
+}
+function resolveEffort(info, requested) {
+  if (!isLevel(requested)) return void 0;
+  const efforts = effortsOf(info);
+  if (efforts.length === 0) return void 0;
+  if (!isLevel(info?.default_effort)) return requested === "off" && efforts.includes("off") ? "off" : void 0;
+  if (efforts.includes(requested)) return requested;
+  const below = efforts.filter((e) => rank(e) <= rank(requested));
+  return below.length ? below[below.length - 1] : efforts[0];
+}
+function savedEffort(config, model) {
+  const value = config.effort?.[model];
+  return typeof value === "string" ? value : void 0;
+}
+function effortRaised(info, level) {
+  if (!level || !isLevel(info?.default_effort)) return false;
+  return rank(level) > rank(info.default_effort);
+}
+function effortLabel(level) {
+  if (level === "off") return "thinking off";
+  if (level === "on") return "thinking on";
+  return `${level} effort`;
+}
+var EFFORT_LEVELS, rank;
+var init_effort = __esm({
+  "src/effort.ts"() {
+    "use strict";
+    EFFORT_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
+    rank = (level) => EFFORT_LEVELS.indexOf(level);
+  }
+});
+
 // src/mentions.ts
 function findMentions(text) {
   const out = [];
@@ -5187,7 +5324,9 @@ async function compact(client, model, messages, opts = {}) {
   const turn = await client.chatStream(
     [...messages.slice(0, cut), { role: "user", content: SUMMARY_PROMPT }],
     model,
-    { signal: opts.signal }
+    // The `/effort` setting applies to every call on the model, a summary
+    // included: somebody who turned it down to save credits saves them here too.
+    { signal: opts.signal, effort: opts.effort }
   );
   const summary = messageText(turn.message).trim() || "(no summary returned)";
   const compacted = [
@@ -5460,6 +5599,10 @@ var init_commands = __esm({
       { name: "help", desc: "list the commands" },
       { name: "model", desc: "switch model" },
       { name: "models", desc: "list models + prices" },
+      // Deliberately *no* `args`, for `/model`'s reason: an arg hint makes enter
+      // complete the command instead of running it, and the picker is the point.
+      // `/effort low` still works when typed in full.
+      { name: "effort", desc: "how long the model thinks (more thinking, more credits)" },
       { name: "mode", args: "[name]", desc: "permission mode (or press shift+tab)" },
       { name: "wallet", desc: "balance & ads today" },
       // Not "watch an ad": nothing on the wall is a video. CPX serves sign-up
@@ -6024,6 +6167,7 @@ function App({
   const [spent, setSpent] = useState(0);
   const [freeTier, setFreeTier] = useState(wallet?.free_tier);
   const [model, setModel2] = useState(config.model);
+  const [effortBy, setEffortBy] = useState(() => config.effort ?? {});
   const modelRef = useRef(config.model);
   const [mode, setMode] = useState("normal");
   const switchModel = useCallback((id) => {
@@ -6077,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);
@@ -6186,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();
   }, []);
@@ -6483,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(
@@ -6494,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;
@@ -6513,7 +6676,7 @@ function App({
           const res = await compact(client, model2, [
             { role: "system", content: contextRef.current.systemPrompt },
             ...history
-          ], { signal: ac.signal });
+          ], { signal: ac.signal, effort: savedEffort(config, model2) });
           if (res) {
             history = res.messages.slice(1);
             setMessages(history);
@@ -6527,6 +6690,10 @@ function App({
         }
         const result = await runAgent(client, task, {
           model: model2,
+          // Read now rather than from the render, for `modelRef`'s reason: a
+          // setting chosen in the same tick as this turn starts is in `config`
+          // already and not yet in any state.
+          effort: savedEffort(config, model2),
           root,
           history,
           attachments: images,
@@ -6626,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;
@@ -6821,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();
@@ -6892,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;
@@ -6929,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",
@@ -6941,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) => {
@@ -6996,7 +7227,7 @@ ${NO_SEARCH_INSTRUCTION}`),
               client,
               model,
               [{ role: "system", content: contextRef.current.systemPrompt }, ...messagesRef.current],
-              { signal }
+              { signal, effort: savedEffort(config, model) }
             );
             if (!res) return void push({ kind: "notice", text: "  nothing to compact yet" });
             setMessages(res.messages.slice(1));
@@ -7022,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);
@@ -7044,17 +7281,85 @@ ${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."
+                  });
+                }
               }
             });
           });
           return;
+        // How long the model thinks, saved per model. The picker offers only
+        // what the current model takes, so a stored setting is always one it
+        // has; a typed level it does not have moves to the nearest one below,
+        // the gateway's rule, and says so. Every figure about cost stays in
+        // words: what a setting costs depends on the task, and the meta line
+        // under each turn already shows what it did cost.
+        case "effort":
+          await runBusy(LOADING, async (signal) => {
+            const models = catalogRef.current.length ? catalogRef.current : await client.models(signal);
+            catalogRef.current = models;
+            const info2 = models.find((m) => m.id === model);
+            const name = info2?.label ?? model;
+            const levels = effortsOf(info2);
+            const fallback = info2?.default_effort;
+            if (!info2 || levels.length === 0) {
+              const why = info2?.efforts === void 0 ? "this gateway does not offer effort settings" : fallback === "on" ? `${name} always thinks before it answers, and has no setting for how long` : `${name} has no effort setting`;
+              return void push({ kind: "notice", text: `  ${why}` });
+            }
+            const defaultWords = fallback ? effortLabel(fallback) : "its default";
+            const apply2 = (choice, note = "") => {
+              saveEffort(config, model, choice);
+              setEffortBy({ ...config.effort ?? {} });
+              const now = choice ? effortLabel(choice) : `auto (${defaultWords})`;
+              push({ kind: "notice", text: `  ${name}: ${now}${note}` });
+            };
+            if (arg) {
+              const wanted = parseEffortArg(arg);
+              if (!wanted) {
+                return void push({
+                  kind: "notice",
+                  tone: "warn",
+                  text: `  unknown effort: ${arg}. ${name} takes ${["auto", ...levels].join(", ")}`
+                });
+              }
+              if (wanted === "auto") return apply2(void 0);
+              const resolved = resolveEffort(info2, wanted);
+              if (!resolved) return apply2(void 0, `. ${name} can only switch its thinking off`);
+              return apply2(resolved, resolved === wanted ? "" : `. It has no ${wanted}, so this is the nearest below`);
+            }
+            const current = resolveEffort(info2, savedEffort(config, model));
+            const items = [
+              { value: "auto", label: "auto", hint: `the model's default (${defaultWords})`, current: !current },
+              ...levels.map((level) => ({
+                value: level,
+                label: level,
+                hint: level === fallback ? "same as auto" : effortRaised(info2, level) ? "more thinking, more credits" : "less thinking, fewer credits",
+                current: current === level
+              }))
+            ];
+            setPickerSel(Math.max(0, items.findIndex((i) => i.current)));
+            setPicker({
+              title: `Effort for ${name}`,
+              subtitle: "Saved for this model. Thinking is billed as output, like the answer.",
+              items,
+              onPick: (choice) => apply2(choice.value === "auto" ? void 0 : choice.value)
+            });
+          });
+          return;
         case "models":
           await runBusy(LOADING, async (signal) => {
             const ms = await client.models(signal);
             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;
@@ -7216,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) => {
@@ -7546,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));
@@ -7722,11 +8029,16 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   const typed = toText(editor);
   let estimate;
   const info = catalogRef.current.find((m) => m.id === model);
+  const effortNow = info ? resolveEffort(info, effortBy[model]) : effortBy[model];
   const shape = client.taskShape;
-  if (!busy && info && shape && balance !== void 0 && typed.trim() !== "" && !/^[/!]/.test(typed.trimStart())) {
+  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]}`;
@@ -7734,6 +8046,7 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
     `  ${statusLine(
       {
         model,
+        ...effortNow ? { effort: effortNow } : {},
         balance,
         spent,
         contextPct,
@@ -7932,6 +8245,8 @@ function statusRow(o, estimate, 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 },
+    // Beside the model it qualifies, and given up with the free allowance.
+    { text: o.effort === void 0 ? void 0 : effortLabel(o.effort), rank: 4 },
     {
       // "? cr" rather than "0 cr": unknown is not empty, and an empty-looking
       // wallet is the one misreading on this row that frightens somebody.
@@ -8008,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";
@@ -8017,6 +8332,7 @@ var init_app = __esm({
     init_todos();
     init_shells();
     init_config();
+    init_effort();
     init_login();
     init_banner();
     init_agent();
@@ -8091,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;
   }
@@ -8165,6 +8482,7 @@ function clearTerminalTitle(out = titleStream()) {
 
 // src/main.ts
 init_version();
+init_effort();
 var c = palette({ isTTY: process.stdout.isTTY, env: process.env });
 async function main() {
   setTerminalTitle();
@@ -8328,17 +8646,40 @@ 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))} ${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.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.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)}`);
   const known = await client.models().catch(() => void 0);
@@ -8352,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();
@@ -8461,6 +8814,7 @@ async function printCmd(client, config, task) {
   try {
     const res = await runAgent(client, task, {
       model: config.model,
+      effort: savedEffort(config, config.model),
       root: process.cwd(),
       systemPrompt: collectContext(process.cwd()).systemPrompt + (capabilities?.web_search ? "" : `
 
@@ -8484,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);
@@ -8606,6 +8963,7 @@ async function runTurn(client, config, messages) {
   let started = false;
   try {
     const result = await client.chatStream(messages, config.model, {
+      effort: savedEffort(config, config.model),
       onDelta: (chunk) => {
         if (!started) process.stdout.write(c.green("assistant "));
         started = true;
@@ -8618,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));
@@ -8642,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;
   }
@@ -8670,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.25",
+  "version": "0.0.1-beta.27",
   "description": "Free AI coding agent in your terminal, funded by rewarded ads.",
   "license": "UNLICENSED",
   "type": "module",