clixad 0.0.1-beta.17 → 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: "" } };
@@ -246,6 +254,11 @@ var init_client = __esm({
       referral_bonus: "referral bonus",
       redeem_code: "code redeemed",
       ad_reward: "offer reward",
+      // Our own survey, and it is deliberately not called an offer. Every other
+      // earn line on this list is a network paying for something; this one is us.
+      // The name is the only place a user would ever learn the difference, and
+      // "offer reward" would file it next to the wall it did not come from.
+      own_survey_reward: "Clixad survey",
       ad_screenout_bonus: "screenout bonus (didn't qualify)",
       ad_sponsor_impression: "sponsored line shown",
       ad_reversal: "offer reward reversed by the provider",
@@ -436,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;
@@ -765,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)
         };
       }
       /**
@@ -787,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();
@@ -812,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);
@@ -819,14 +836,25 @@ 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 };
       }
     };
   }
 });
 
 // src/config.ts
-import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import {
+  chmodSync,
+  closeSync,
+  fsyncSync,
+  mkdirSync,
+  openSync,
+  readFileSync,
+  renameSync,
+  unlinkSync,
+  writeFileSync,
+  writeSync
+} from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 function sameEndpoint(a, b) {
@@ -841,11 +869,42 @@ function sameEndpoint(a, b) {
   };
   return norm(a) === norm(b);
 }
-function loadConfig() {
-  let stored = {};
+function takeConfigNotices() {
+  const out = notices;
+  notices = [];
+  return out;
+}
+function readStored() {
+  let raw;
   try {
-    stored = JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
+    raw = readFileSync(CONFIG_PATH, "utf8");
+  } catch (err) {
+    const code = err.code;
+    if (code === "ENOENT") return { stored: {} };
+    return { stored: {}, problem: `could not be read (${code ?? err.message})` };
+  }
+  if (raw.trim() === "") return { stored: {}, problem: "was empty", raw };
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
   } catch {
+    return { stored: {}, problem: "is not valid JSON", raw };
+  }
+  if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+    return { stored: {}, problem: "is not a JSON object", raw };
+  }
+  return { stored: parsed };
+}
+function loadConfig() {
+  notices = [];
+  envApplied.clear();
+  const read = readStored();
+  const stored = read.stored;
+  if (read.problem) {
+    notices.push(
+      `Your Clixad config (${CONFIG_PATH}) ${read.problem}, so this session starts signed out.
+  It is kept at ${QUARANTINE_PATH} the next time anything is saved \u2014 sign in again with \`/login\`.`
+    );
   }
   const mintedAgainst = stored.gatewayUrl;
   for (const [key, stale] of Object.entries(SUPERSEDED_DEFAULTS)) {
@@ -857,17 +916,76 @@ function loadConfig() {
   const config = { ...DEFAULTS, ...stored };
   for (const [key, envVar] of ENV_OVERRIDES) {
     const value = process.env[envVar];
-    if (value) config[key] = value;
+    if (value) {
+      config[key] = value;
+      envApplied.add(key);
+    }
   }
-  const migratedGateway = mintedAgainst !== void 0 && stored.gatewayUrl === void 0;
-  if (migratedGateway && !sameEndpoint(mintedAgainst, config.gatewayUrl)) {
+  const boundTo = stored.tokenGateway ?? mintedAgainst;
+  const redirected = envApplied.has("gatewayUrl");
+  if (!redirected && boundTo !== void 0 && !sameEndpoint(boundTo, config.gatewayUrl)) {
+    if (stored.token !== void 0) {
+      notices.push(
+        `Signed out: the saved account belongs to ${boundTo}, and this run talks to ${config.gatewayUrl}.
+  Sign in again with \`/login\` (or \`clixad login\`).`
+      );
+    }
     for (const key of IDENTITY_KEYS) delete config[key];
   }
+  baseline = { ...config };
   return config;
 }
+function changedKeys(config) {
+  const current = config;
+  if (!baseline) return Object.keys(current);
+  const before = baseline;
+  const keys = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(current)]);
+  return [...keys].filter((key) => before[key] !== current[key]);
+}
+function writeAtomically(contents) {
+  const tmp = `${CONFIG_PATH}.${process.pid}.tmp`;
+  try {
+    const fd = openSync(tmp, "w", 384);
+    try {
+      writeSync(fd, contents);
+      fsyncSync(fd);
+    } finally {
+      closeSync(fd);
+    }
+    renameSync(tmp, CONFIG_PATH);
+  } catch (err) {
+    try {
+      unlinkSync(tmp);
+    } catch {
+    }
+    throw err;
+  }
+}
 function saveConfig(config) {
   mkdirSync(dirname(CONFIG_PATH), { recursive: true, mode: 448 });
-  writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2), { encoding: "utf8", mode: 384 });
+  const changed = changedKeys(config);
+  const current = readStored();
+  let base = {};
+  if (current.problem) {
+    if (current.raw !== void 0) {
+      try {
+        writeFileSync(QUARANTINE_PATH, current.raw, { encoding: "utf8", mode: 384 });
+      } catch {
+      }
+    }
+  } else {
+    base = current.stored;
+  }
+  const next = { ...base };
+  const source = config;
+  for (const key of changed) {
+    const value = source[key];
+    if (value === void 0) delete next[key];
+    else next[key] = value;
+  }
+  writeAtomically(`${JSON.stringify(next, null, 2)}
+`);
+  baseline = { ...config };
   try {
     chmodSync(CONFIG_PATH, 384);
   } catch {
@@ -876,11 +994,12 @@ function saveConfig(config) {
 function configPath() {
   return CONFIG_PATH;
 }
-var CONFIG_PATH, DEFAULTS, ENV_OVERRIDES, SUPERSEDED_DEFAULTS, IDENTITY_KEYS;
+var CONFIG_PATH, QUARANTINE_PATH, DEFAULTS, ENV_OVERRIDES, SUPERSEDED_DEFAULTS, IDENTITY_KEYS, baseline, envApplied, notices;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     CONFIG_PATH = join(homedir(), ".clixad", "config.json");
+    QUARANTINE_PATH = `${CONFIG_PATH}.corrupt`;
     DEFAULTS = {
       gatewayUrl: "https://clixad.onrender.com",
       // Same origin as the gateway: the ad wall is served by the gateway process
@@ -898,7 +1017,9 @@ var init_config = __esm({
       gatewayUrl: ["http://127.0.0.1:8787", "http://localhost:8787"],
       dashboardUrl: ["http://127.0.0.1:8788", "http://localhost:8788"]
     };
-    IDENTITY_KEYS = ["token", "userId", "email", "login"];
+    IDENTITY_KEYS = ["token", "userId", "email", "login", "tokenGateway"];
+    envApplied = /* @__PURE__ */ new Set();
+    notices = [];
   }
 });
 
@@ -958,6 +1079,7 @@ async function githubLogin(client, config, start, invite, report, signal) {
       config.userId = poll.userId;
       config.email = poll.email;
       config.login = poll.login;
+      config.tokenGateway = config.gatewayUrl;
       saveConfig(config);
       return {
         status: "ok",
@@ -987,6 +1109,7 @@ async function devLogin(client, config, email, invite) {
   config.token = res.token;
   config.userId = res.userId;
   config.email = res.email;
+  config.tokenGateway = config.gatewayUrl;
   delete config.login;
   saveConfig(config);
   return { status: "ok", account: { email: res.email, balance: res.balance, created: true } };
@@ -3470,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 = [];
@@ -3526,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";
@@ -3547,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 = [];
@@ -3582,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) {
@@ -5129,7 +5269,7 @@ function useTerminalSize() {
   }, [stdout]);
   return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
 }
-function App({ client, config, wallet, streak, session, initialTask, sponsorServe }) {
+function App({ client, config, wallet, streak, session, initialTask, notices: notices2, sponsorServe }) {
   const { exit } = useApp();
   const { stdout, write: writeToStdout } = useStdout();
   const idRef = useRef(1);
@@ -5163,6 +5303,7 @@ function App({ client, config, wallet, streak, session, initialTask, sponsorServ
   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());
@@ -5205,6 +5346,7 @@ function App({ client, config, wallet, streak, session, initialTask, sponsorServ
   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);
@@ -5283,6 +5425,7 @@ function App({ client, config, wallet, streak, session, initialTask, sponsorServ
   useEffect(() => dropDelta, [dropDelta]);
   useEffect(() => {
     client.onNotice = (text2) => push({ kind: "notice", tone: "warn", text: text2 });
+    for (const text2 of notices2 ?? []) push({ kind: "notice", tone: "warn", text: `  ${text2}` });
     const files = contextRef.current.files;
     if (files.length) push({ kind: "notice", text: `  context: ${files.join(", ")}` });
     const streakLine = streak && streak.claimed ? streakLabel(streak) : null;
@@ -5478,6 +5621,11 @@ function App({ client, config, wallet, streak, session, initialTask, sponsorServ
         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;
@@ -5569,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;
@@ -5825,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);
@@ -5852,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;
@@ -6075,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);
@@ -6447,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))
@@ -6555,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 },
     {
@@ -6570,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) {
@@ -6769,6 +6970,8 @@ async function main() {
   const [cmd, ...rest] = process.argv.slice(2);
   const config = loadConfig();
   const client = new GatewayClient(config);
+  const configNotices = takeConfigNotices();
+  for (const text of configNotices) console.error(c.yellow(text));
   switch (cmd) {
     case "login":
       return login(client, config, rest);
@@ -6793,15 +6996,15 @@ async function main() {
     case "ask":
       return ask(client, config, rest.join(" "));
     case "agent":
-      return repl(client, config, { task: rest.join(" ").trim() || void 0 });
+      return repl(client, config, { task: rest.join(" ").trim() || void 0, notices: configNotices });
     case "-p":
     case "--print":
       return printCmd(client, config, rest.join(" ").trim());
     case "-c":
     case "--continue":
-      return repl(client, config, { resume: "latest" });
+      return repl(client, config, { resume: "latest", notices: configNotices });
     case "--resume":
-      return repl(client, config, { resume: rest[0] ?? "pick" });
+      return repl(client, config, { resume: rest[0] ?? "pick", notices: configNotices });
     case "code":
       return codeCmd(client, config, rest);
     case "help":
@@ -6816,7 +7019,7 @@ async function main() {
     case "-v":
       return void console.log(VERSION);
     case void 0:
-      return repl(client, config);
+      return repl(client, config, { notices: configNotices });
     default:
       if (cmd.startsWith("-")) {
         console.error(c.red(`unknown option: ${cmd}`));
@@ -6824,7 +7027,7 @@ async function main() {
         process.exitCode = 1;
         return;
       }
-      return repl(client, config, { task: [cmd, ...rest].join(" ").trim() });
+      return repl(client, config, { task: [cmd, ...rest].join(" ").trim(), notices: configNotices });
   }
 }
 async function login(client, config, args) {
@@ -6893,10 +7096,7 @@ function wrapPlain(text, width) {
 var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
 var credits = (n) => n.toLocaleString("en-US");
 function logout(config) {
-  delete config.token;
-  delete config.userId;
-  delete config.email;
-  delete config.login;
+  for (const key of IDENTITY_KEYS) delete config[key];
   saveConfig(config);
   console.log(c.green("\u2713 logged out"));
 }
@@ -6912,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}`
     );
   }
 }
@@ -6939,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) {
@@ -7133,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) {
@@ -7235,7 +7448,15 @@ async function repl(client, config, opts = {}) {
   const wallet = await safeWallet(client);
   clearScreen();
   const { startTui: startTui2 } = await Promise.resolve().then(() => (init_tui(), tui_exports));
-  await startTui2({ client, config, wallet, streak, session, initialTask: opts.task });
+  await startTui2({
+    client,
+    config,
+    wallet,
+    streak,
+    session,
+    initialTask: opts.task,
+    ...opts.notices?.length ? { notices: opts.notices } : {}
+  });
 }
 async function runTurn(client, config, messages) {
   try {

package/package.json

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