clixad 0.0.1-beta.18 → 0.0.1-beta.19

package/README.md

@@ -1,8 +1,12 @@
 # clixad
 
 A terminal coding agent that routes model calls through the Clixad metering gateway. No
-subscription: you earn credits by completing rewarded offers in your browser and spend them on real
-model API calls.
+subscription: the cheapest models are free to use up to a daily allowance, and past that you earn
+credits by completing rewarded offers in your browser and spend them on real model API calls.
+
+`/model` marks which models are free and shows roughly how many free turns the allowance still buys
+on each — the same allowance goes a lot further on the cheapest one. The status line counts it down,
+and once it is gone the model carries on against credits.
 
 **Early beta.** Commands, interfaces and credit mechanics may change between beta versions. Run the
 most recent published build with:

package/dist/clixad.mjs

@@ -207,6 +207,14 @@ async function httpFailure(res, what) {
   const detail = safeDetail(await res.text().catch(() => ""));
   return detail ? `${what} failed: ${res.status} \u2014 ${detail}` : `${what} failed: ${res.status}`;
 }
+function freeMeta(meta) {
+  if (meta.free !== true) return {};
+  return {
+    free: true,
+    creditsWaived: meta.credits_waived ?? 0,
+    freeCreditsLeft: meta.free_credits_left ?? 0
+  };
+}
 function accumulateToolCall(calls, part, fallbackIndex) {
   const index = part.index ?? fallbackIndex;
   const current = calls.get(index) ?? { id: "", type: "function", function: { name: "", arguments: "" } };
@@ -441,7 +449,8 @@ var init_client = __esm({
               model: report.model,
               prompt: report.prompt,
               response: report.response,
-              ...report.steps === void 0 ? {} : { steps: report.steps }
+              ...report.steps === void 0 ? {} : { steps: report.steps },
+              ...report.free ? { free: true } : {}
             })
           });
           if (!res.ok) return null;
@@ -770,7 +779,8 @@ var init_client = __esm({
           message: choice.message,
           finishReason: choice.finish_reason,
           creditsCharged: data.clixad.credits_charged,
-          balance: data.clixad.balance
+          balance: data.clixad.balance,
+          ...freeMeta(data.clixad)
         };
       }
       /**
@@ -792,6 +802,7 @@ var init_client = __esm({
         let content = "";
         let finishReason = "stop";
         let creditsCharged = 0;
+        let free = {};
         let balance = 0;
         let streamError;
         const calls = /* @__PURE__ */ new Map();
@@ -817,6 +828,7 @@ var init_client = __esm({
           if (json.clixad) {
             creditsCharged = json.clixad.credits_charged;
             balance = json.clixad.balance;
+            free = freeMeta(json.clixad);
           }
         }
         if (streamError) throw new Error(streamError);
@@ -824,7 +836,7 @@ var init_client = __esm({
         if (calls.size > 0) {
           message.tool_calls = [...calls.entries()].sort(([a], [b]) => a - b).map(([, c2]) => c2);
         }
-        return { message, finishReason, creditsCharged, balance };
+        return { message, finishReason, creditsCharged, balance, ...free };
       }
     };
   }
@@ -3581,6 +3593,8 @@ async function runAgent(client, task, opts) {
   const depth = opts.depth ?? 0;
   const emit = (e) => opts.onEvent?.(e);
   let creditsCharged = 0;
+  let creditsWaived = 0;
+  let freeCreditsLeft;
   let balance = 0;
   let lastText = "";
   let pendingImages = [];
@@ -3637,6 +3651,8 @@ ${NO_SEARCH_INSTRUCTION}`,
       }
     });
     creditsCharged += sub.creditsCharged;
+    creditsWaived += sub.creditsWaived;
+    if (sub.freeCreditsLeft !== void 0) freeCreditsLeft = sub.freeCreditsLeft;
     if (sub.stopped === "aborted") return "the sub-agent was stopped before it finished";
     const answer = sub.content.trim();
     if (!answer) return "the sub-agent finished without reporting anything";
@@ -3658,15 +3674,26 @@ ${NO_SEARCH_INSTRUCTION}`,
       throw err;
     }
     creditsCharged += turn.creditsCharged;
+    creditsWaived += turn.creditsWaived ?? 0;
+    if (turn.freeCreditsLeft !== void 0) freeCreditsLeft = turn.freeCreditsLeft;
     balance = turn.balance;
-    emit({ type: "usage", creditsCharged: turn.creditsCharged, balance: turn.balance });
+    emit({
+      type: "usage",
+      creditsCharged: turn.creditsCharged,
+      balance: turn.balance,
+      ...turn.free ? {
+        free: true,
+        creditsWaived: turn.creditsWaived ?? 0,
+        freeCreditsLeft: turn.freeCreditsLeft ?? 0
+      } : {}
+    });
     messages.push(turn.message);
     const content = messageText(turn.message);
     if (content) lastText = content;
     const calls = turn.message.tool_calls ?? [];
     if (calls.length === 0) {
       emit({ type: "final", content, creditsCharged, balance });
-      return { content, messages, creditsCharged, balance, steps: step + 1 };
+      return { content, messages, creditsCharged, balance, creditsWaived, freeCreditsLeft, steps: step + 1 };
     }
     if (content) emit({ type: "message", content });
     pendingImages = [];
@@ -3693,12 +3720,14 @@ ${NO_SEARCH_INSTRUCTION}`,
     messages,
     creditsCharged,
     balance,
+    creditsWaived,
+    freeCreditsLeft,
     steps: maxSteps,
     stopped: "max_steps"
   };
   function stop(reason) {
     emit({ type: reason });
-    return { content: lastText, messages, creditsCharged, balance, steps: 0, stopped: reason };
+    return { content: lastText, messages, creditsCharged, balance, creditsWaived, freeCreditsLeft, steps: 0, stopped: reason };
   }
 }
 function toolMessage(call, content) {
@@ -5274,6 +5303,7 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   const [live, setLive] = useState(null);
   const [balance, setBalance] = useState(wallet?.balance ?? 0);
   const [spent, setSpent] = useState(0);
+  const [freeTier, setFreeTier] = useState(wallet?.free_tier);
   const [model, setModel2] = useState(config.model);
   const [mode, setMode] = useState("normal");
   const [hist, setHist] = useState(() => loadHistory());
@@ -5316,6 +5346,7 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   const mcpRef = useRef(McpHub.empty());
   const todosRef = useRef(new TodoList());
   const lastTurnRef = useRef(null);
+  const freeSpentNoticeRef = useRef(false);
   const turnCountRef = useRef(config.turns ?? 0);
   const deltaBufRef = useRef("");
   const deltaTimerRef = useRef(null);
@@ -5590,6 +5621,11 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
         case "usage":
           setBalance(event.balance);
           setSpent((s) => s + event.creditsCharged);
+          if (event.free) {
+            setFreeTier(
+              (f) => f ? { ...f, credits_left: event.freeCreditsLeft ?? f.credits_left } : f
+            );
+          }
           return;
         default:
           return;
@@ -5681,14 +5717,28 @@ ${NO_SEARCH_INSTRUCTION}`),
           push({
             kind: "assistant",
             text: result.content,
-            meta: `[${result.creditsCharged} credits \xB7 balance ${result.balance.toLocaleString("en-US")}]`
+            meta: turnMeta(result)
           });
+          if (freeTier?.models.includes(model) && result.creditsWaived === 0 && result.creditsCharged > 0 && (result.freeCreditsLeft ?? freeTier.credits_left) === 0 && !freeSpentNoticeRef.current) {
+            freeSpentNoticeRef.current = true;
+            push({
+              kind: "notice",
+              tone: "warn",
+              text: `  Today's free turns are used up. This one cost ${result.creditsCharged.toLocaleString("en-US")} credits.
+  The free allowance resets at midnight UTC. /earn tops up before then.`
+            });
+          }
           lastTurnRef.current = {
             turn: turnCountRef.current,
             model,
             prompt: task,
             response: result.content,
-            steps: result.steps
+            steps: result.steps,
+            // Whether the free tier paid for it. Sent with the rating, where it
+            // can only ever lower the grant — see `FeedbackReport.free`. A turn
+            // that was partly free counts as free: we funded some of it, and of
+            // the two roundings this is the one that is ours to absorb.
+            free: result.creditsWaived > 0
           };
           turnCountRef.current += 1;
           config.turns = turnCountRef.current;
@@ -5937,10 +5987,15 @@ ${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) => {
+              setBalance(w.balance);
+              setFreeTier(w.free_tier);
+              return w.free_tier;
+            }).catch(() => freeTier);
             const items = models.map((m) => ({
               value: m.id,
               label: m.id,
-              hint: `${m.tier.padEnd(8)}${adsPerTaskLabel(m.est_ads_per_task)}`,
+              hint: `${m.tier.padEnd(8)}${modelHint(m, free)}`,
               current: m.id === model
             }));
             const preselect = items.findIndex((i) => i.value === arg);
@@ -5964,7 +6019,7 @@ ${NO_SEARCH_INSTRUCTION}`),
             catalogRef.current = ms;
             push({
               kind: "notice",
-              text: ms.map((m) => `  ${m.id.padEnd(24)} ${adsPerTaskLabel(m.est_ads_per_task)}`).join("\n")
+              text: ms.map((m) => `  ${m.id.padEnd(24)} ${modelHint(m, freeTier)}`).join("\n")
             });
           });
           return;
@@ -6187,7 +6242,7 @@ ${output}` }
     const turn = lastTurnRef.current;
     if (!turn) return;
     lastTurnRef.current = null;
-    const amount = wallet?.rewards?.feedback_credits;
+    const amount = turn.free ? wallet?.rewards?.feedback_credits_free ?? wallet?.rewards?.feedback_credits : wallet?.rewards?.feedback_credits;
     const pay = amount ? `Both answers pay ${amount.toLocaleString("en-US")} credits` : "Both answers pay the same";
     const choice = await new Promise((resolve2) => {
       setPickerSel(0);
@@ -6559,7 +6614,17 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   const modeText = `  ${MODE_STYLE[mode].glyph} ${MODE_LABEL[mode]}`;
   const statusText = fitRow(
     `  ${statusLine(
-      { model, balance, spent, contextPct, minutes: (Date.now() - runStartedAtRef.current) / 6e4 },
+      {
+        model,
+        balance,
+        spent,
+        contextPct,
+        minutes: (Date.now() - runStartedAtRef.current) / 6e4,
+        // Only while a free model is selected: on a premium one the allowance
+        // is real but irrelevant, and a countdown that has nothing to do with
+        // the next turn is a number that teaches people to stop reading the row.
+        ...freeTier?.models.includes(model) ? { freeLeft: freeTier.credits_left } : {}
+      },
       Math.max(1, cols - visibleLength(modeText) - 2)
     )}`,
     Math.max(0, cols - visibleLength(modeText))
@@ -6667,11 +6732,35 @@ function renderInput(state, from, rows) {
     ] }, row);
   });
 }
+function modelHint(m, free) {
+  const effort = adsPerTaskLabel(m.est_ads_per_task);
+  if (!m.free || !free?.models.includes(m.id)) return effort;
+  const turns = free.turns_left[m.id] ?? 0;
+  if (turns <= 0) return `free: none left today \xB7 ${effort}`;
+  return `free: ~${turns} turn${turns === 1 ? "" : "s"} left \xB7 ${effort}`;
+}
+function turnMeta(result) {
+  const n = (v) => v.toLocaleString("en-US");
+  const balance = `balance ${n(result.balance)}`;
+  if (result.creditsWaived <= 0) return `[${result.creditsCharged} credits \xB7 ${balance}]`;
+  const left = result.freeCreditsLeft === void 0 ? "" : ` \xB7 ${n(result.freeCreditsLeft)} free credits left`;
+  if (result.creditsCharged > 0) {
+    return `[free: ${n(result.creditsWaived)} credits \xB7 then ${n(result.creditsCharged)} charged \xB7 ${balance}]`;
+  }
+  return `[free \xB7 ${n(result.creditsWaived)} credits waived${left}]`;
+}
 function statusLine(o, 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 },
     { text: `${o.balance.toLocaleString("en-US")} cr`, rank: KEEP_ALWAYS },
+    // 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.
+    {
+      text: o.freeLeft === void 0 ? void 0 : `free ${o.freeLeft.toLocaleString("en-US")}`,
+      rank: 4
+    },
     { text: o.spent > 0 ? `\u2212${o.spent.toLocaleString("en-US")}` : void 0, rank: 2 },
     { text: burn, rank: 1 },
     {
@@ -6682,7 +6771,7 @@ function statusLine(o, cols) {
   ].filter((c2) => Boolean(c2.text));
   const join7 = (minRank) => clauses.filter((c2) => c2.rank >= minRank).map((c2) => c2.text).join(" \xB7 ");
   let line2 = join7(0);
-  for (let minRank = 1; minRank <= 4 && visibleLength(line2) > cols; minRank++) line2 = join7(minRank);
+  for (let minRank = 1; minRank <= 5 && visibleLength(line2) > cols; minRank++) line2 = join7(minRank);
   return fitRow(line2, cols);
 }
 function windowStart(sel, total, size) {
@@ -7023,11 +7112,14 @@ 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);
   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 turns = free?.models.includes(m.id) ? free.turns_left[m.id] ?? 0 : void 0;
+    const freeTag = !m.free ? "" : turns === void 0 ? c.green(" [free]") : turns > 0 ? c.green(` [free: ~${turns} turn${turns === 1 ? "" : "s"} left today]`) : c.dim(" [free: none left today]");
     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}`
+      `  ${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}`
     );
   }
 }
@@ -7050,6 +7142,15 @@ async function showWallet(client) {
   const w = await client.wallet();
   console.log(`balance: ${c.bold(w.balance.toLocaleString("en-US"))} credits`);
   console.log(`${earnedToday(w)}  \xB7  offers pay ${grantRangeLabel(w.grant_per_ad_range)}`);
+  const free = w.free_tier;
+  if (free && free.daily_credits > 0) {
+    const best = free.models.map((id) => ({ id, turns: free.turns_left[id] ?? 0 })).filter((m) => m.turns > 0).sort((a, b) => b.turns - a.turns)[0];
+    console.log(
+      free.credits_left > 0 ? c.green(
+        `free today: ${credits(free.credits_left)} of ${credits(free.daily_credits)} credits left` + (best ? `  \xB7  ~${best.turns} turn${best.turns === 1 ? "" : "s"} on ${best.id}` : "")
+      ) : c.dim(`free today: none left of ${credits(free.daily_credits)} credits \u2014 resets at midnight UTC`)
+    );
+  }
   const line2 = streak && streakLabel(streak);
   if (line2) console.log(streak.claimed ? c.green(line2) : c.dim(line2));
   if (w.ledger.length) {
@@ -7244,9 +7345,10 @@ ${NO_SEARCH_INSTRUCTION}`),
       todos: new TodoList(),
       onEvent: printAgentEvent
     });
+    const cost = res.creditsWaived > 0 ? res.creditsCharged > 0 ? `free: ${res.creditsWaived} credits \xB7 then ${res.creditsCharged} charged` : `free \xB7 ${res.creditsWaived} credits waived` : `${res.creditsCharged} credits`;
     console.log(
       c.dim(`
-  [${res.creditsCharged} credits \xB7 balance ${res.balance} \xB7 ${res.steps} step(s)]`)
+  [${cost} \xB7 balance ${res.balance} \xB7 ${res.steps} step(s)]`)
     );
   } catch (err) {
     if (err instanceof PaywallError) {

package/package.json

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