clixad 0.0.1-beta.0 → 0.0.1-beta.1

package/README.md

@@ -1,23 +1,30 @@
 # clixad
 
-A terminal coding agent that routes model calls through the Clixad metering gateway.
+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.
 
-**This is an early beta and is published under the `beta` dist-tag only.** There is deliberately no
-`latest` tag yet, so `npx clixad` and `npm install clixad` do not resolve. To try the beta
-explicitly:
+**Early beta.** Commands, interfaces and credit mechanics may change between beta versions. Run the
+most recent published build with:
 
 ```bash
-npm install -g clixad@beta
+npx clixad
+```
+
+or install it globally:
+
+```bash
+npm install -g clixad
 ```
 
 Requires Node.js >= 20.
 
 ## Status
 
-Pre-release. Interfaces, commands and credit mechanics may change without notice between beta
-versions.
+Pre-release, published under the `beta` dist-tag. `npx clixad` resolves to the latest published
+version. Account creation is decided by the gateway, so a fresh install may land on a waitlist until
+signups are open.
 
 ## License
 
-UNLICENSED — all rights reserved. Published to reserve the package name; no rights to use, copy,
-modify or distribute are granted.
+UNLICENSED — all rights reserved. No rights to use, copy, modify or distribute are granted.

package/dist/clixad.mjs

@@ -19,6 +19,28 @@ function adsPerTaskLabel(estAdsPerTask) {
   const effort = estAdsPerTask >= 1 ? `~${estAdsPerTask} ads/task` : "<1 ad/task";
   return `${effort} on completion`;
 }
+function grantRangeLabel(range) {
+  if (!range) return "credits on completion";
+  const [low, high] = range;
+  const n = (v) => v.toLocaleString("en-US");
+  return low === high ? `${n(low)} credits on completion` : `${n(low)}\u2013${n(high)} credits on completion`;
+}
+function ledgerReasonLabel(reason) {
+  return LEDGER_REASONS[reason] ?? reason.replace(/_/g, " ");
+}
+function asSignupClosed(status, data) {
+  if (status !== 403) return void 0;
+  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 paywallError(body) {
+  return new PaywallError(
+    body.balance,
+    body.estimated_cost,
+    body.grant_per_ad,
+    body.grant_per_ad_range
+  );
+}
 async function authFailure(res, what) {
   const body = await res.text().catch(() => "");
   const isJson = (res.headers.get("content-type") ?? "").includes("json");
@@ -59,21 +81,39 @@ async function* parseSSE(body) {
     }
   }
 }
-var PaywallError, AuthError, GatewayClient;
+var LEDGER_REASONS, SignupClosedError, PaywallError, AuthError, GatewayClient;
 var init_client = __esm({
   "src/client.ts"() {
     "use strict";
+    LEDGER_REASONS = {
+      signup_bonus: "signup bonus",
+      ad_reward: "offer reward",
+      ad_reversal: "offer reward reversed by the provider",
+      purchase: "credits purchased",
+      usage: "model usage",
+      refund: "refund"
+    };
+    SignupClosedError = class extends Error {
+      constructor(message, waitlistUrl) {
+        super(message);
+        this.waitlistUrl = waitlistUrl;
+        this.name = "SignupClosedError";
+      }
+      waitlistUrl;
+    };
     PaywallError = class extends Error {
-      constructor(balance, estimatedCost, grantPerAd) {
+      constructor(balance, estimatedCost, grantPerAd, grantRange) {
         super("Out of credits");
         this.balance = balance;
         this.estimatedCost = estimatedCost;
         this.grantPerAd = grantPerAd;
+        this.grantRange = grantRange;
         this.name = "PaywallError";
       }
       balance;
       estimatedCost;
       grantPerAd;
+      grantRange;
     };
     AuthError = class extends Error {
       constructor() {
@@ -95,13 +135,18 @@ var init_client = __esm({
         return h;
       }
       /** Dev-only signup shortcut (production replaces this with GitHub OAuth). */
-      async signupDev(email) {
+      async signupDev(email, invite) {
         const res = await fetch(`${this.config.gatewayUrl}/dev/users`, {
           method: "POST",
           headers: this.headers(false),
-          body: JSON.stringify(email ? { email } : {})
+          body: JSON.stringify({ ...email ? { email } : {}, ...invite ? { invite } : {} })
         });
-        if (!res.ok) throw new Error(`signup failed: ${res.status} ${await res.text()}`);
+        if (!res.ok) {
+          const data = await res.json().catch(() => null);
+          const closed = asSignupClosed(res.status, data);
+          if (closed) throw new SignupClosedError(closed.message, closed.waitlist_url);
+          throw new Error(`signup failed: ${res.status} ${JSON.stringify(data ?? "")}`);
+        }
         return res.json();
       }
       /** Begin GitHub device-flow login. Returns null if the gateway has no GitHub
@@ -115,14 +160,18 @@ var init_client = __esm({
         if (!res.ok) throw new Error(`device start failed: ${res.status} ${await res.text()}`);
         return res.json();
       }
-      /** Poll once for device-flow completion. */
-      async devicePoll(session) {
+      /** Poll once for device-flow completion. `invite` unlocks a gated signup. */
+      async devicePoll(session, invite) {
         const res = await fetch(`${this.config.gatewayUrl}/v1/auth/device/poll`, {
           method: "POST",
           headers: this.headers(false),
-          body: JSON.stringify({ session })
+          body: JSON.stringify(invite ? { session, invite } : { session })
         });
         const data = await res.json().catch(() => ({}));
+        const closed = asSignupClosed(res.status, data);
+        if (closed) {
+          return { status: "closed", message: closed.message, waitlistUrl: closed.waitlist_url };
+        }
         if (!res.ok && !("status" in data && data.status)) {
           return { status: "error", error: `http ${res.status}` };
         }
@@ -191,8 +240,7 @@ var init_client = __esm({
         });
         if (res.status === 401) throw await authFailure(res, "chat");
         if (res.status === 402) {
-          const body = await res.json();
-          throw new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad);
+          throw paywallError(await res.json());
         }
         if (!res.ok) throw new Error(`chat failed: ${res.status} ${await res.text()}`);
         const data = await res.json();
@@ -220,8 +268,7 @@ var init_client = __esm({
         });
         if (res.status === 401) throw await authFailure(res, "chat");
         if (res.status === 402) {
-          const body = await res.json();
-          throw new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad);
+          throw paywallError(await res.json());
         }
         if (!res.ok || !res.body) throw new Error(`chat failed: ${res.status} ${await res.text()}`);
         let content = "";
@@ -1505,6 +1552,114 @@ var init_compact = __esm({
   }
 });
 
+// src/sponsor/counter.ts
+function createTally() {
+  return { shown: 0, byLine: {} };
+}
+function recordImpression(tally, lineId) {
+  tally.shown += 1;
+  tally.byLine[lineId] = (tally.byLine[lineId] ?? 0) + 1;
+}
+var init_counter = __esm({
+  "src/sponsor/counter.ts"() {
+    "use strict";
+  }
+});
+
+// src/sponsor/lines.ts
+var HOUSE_LINES;
+var init_lines = __esm({
+  "src/sponsor/lines.ts"() {
+    "use strict";
+    HOUSE_LINES = [
+      { id: "modes", text: "shift+tab cycles permission modes \u2014 plan mode is read-only" },
+      { id: "interrupt", text: "esc stops a run mid-turn; tokens already generated are billed" },
+      { id: "continue", text: "clixad --continue picks up the last session in this directory" },
+      { id: "sessions", text: "clixad --resume lists your saved sessions" },
+      { id: "context-files", text: "a CLIXAD.md or AGENTS.md in the repo root joins every prompt" },
+      { id: "compaction", text: "long sessions compact themselves before the context fills up" },
+      { id: "headless", text: 'clixad -p "\u2026" runs headless, with read-only tools' },
+      { id: "model-switch", text: "/model switches model mid-session \u2014 the conversation carries over" },
+      { id: "help", text: "/help lists every slash command" },
+      // Placed here rather than at the end of the list on purpose: the rotation is
+      // the list, and appending it would put three business-y lines (earn,
+      // screenout, this) back to back at the close of every cycle — the one stretch
+      // that would read as an ad break.
+      { id: "referral", text: "pass it on: clixad.io" },
+      { id: "wallet", text: "/wallet shows your balance and what you've earned today" },
+      { id: "cheapest-first", text: "/model lists cheapest-turn-first" },
+      { id: "model-cost", text: "current model: {ads_per_task}", needs: "ads_per_task" },
+      { id: "earn", text: "/earn: offers pay {grant_range}", needs: "grant_range" },
+      { id: "screenout", text: "a screenout pays nothing and is normal \u2014 just start another" }
+    ];
+  }
+});
+
+// src/sponsor/provider.ts
+function fill(line2, facts) {
+  if (!line2.needs) return line2.text;
+  const value = line2.needs === "grant_range" ? facts.grantRange : facts.adsPerTask;
+  if (!value) return null;
+  return line2.text.replace(`{${line2.needs}}`, value);
+}
+function houseSource(lines = HOUSE_LINES) {
+  return {
+    provider: "house",
+    pick(index, previousId, facts) {
+      if (lines.length === 0) return null;
+      const start = (index % lines.length + lines.length) % lines.length;
+      for (let step = 0; step < lines.length; step++) {
+        const line2 = lines[(start + step) % lines.length];
+        if (line2.id === previousId) continue;
+        const text = fill(line2, facts);
+        if (text) return { id: line2.id, text };
+      }
+      return null;
+    }
+  };
+}
+function sponsorSource(provider = "house") {
+  switch (provider) {
+    case "house":
+      return houseSource();
+  }
+}
+var init_provider = __esm({
+  "src/sponsor/provider.ts"() {
+    "use strict";
+    init_lines();
+  }
+});
+
+// src/sponsor/render.ts
+function sponsorEnabled({ isTTY, env, configEnabled }) {
+  const flag = env.CLIXAD_SPONSOR?.trim().toLowerCase();
+  if (flag === "0" || flag === "false" || flag === "off" || flag === "no") return false;
+  const forced = flag === "1" || flag === "true" || flag === "on" || flag === "yes";
+  if (!isTTY) return false;
+  if (env.TERM === "dumb") return false;
+  if (forced) return true;
+  if (configEnabled === false) return false;
+  if (env.NO_COLOR !== void 0 && env.NO_COLOR !== "") return false;
+  if (env.CI !== void 0 && env.CI !== "") return false;
+  return true;
+}
+function sponsorText(line2, cols) {
+  const indent = "  ";
+  const prefix = `${indent}${SPONSOR_MARKER} `;
+  const room = cols - prefix.length;
+  if (room < 12) return null;
+  const body = line2.length <= room ? line2 : `${line2.slice(0, Math.max(0, room - 1)).trimEnd()}\u2026`;
+  return prefix + body;
+}
+var SPONSOR_MARKER;
+var init_render = __esm({
+  "src/sponsor/render.ts"() {
+    "use strict";
+    SPONSOR_MARKER = "\u2726 clixad \xB7";
+  }
+});
+
 // src/tui/commands.ts
 function commandLabel(c2) {
   return `/${c2.name}${c2.args ? ` ${c2.args}` : ""}`;
@@ -1528,7 +1683,10 @@ var init_commands = __esm({
       { name: "models", desc: "list models + prices" },
       { name: "mode", args: "[name]", desc: "permission mode (or press shift+tab)" },
       { name: "wallet", desc: "balance & ads today" },
-      { name: "earn", desc: "earn credits (watch an ad)" },
+      // Not "watch an ad": nothing on the wall is a video. CPX serves sign-up
+      // forms, surveys and app trials, and describing the top-up as a video costs
+      // the user the one expectation that makes a screenout make sense.
+      { name: "earn", desc: "open the offer wall to earn credits" },
       { name: "compact", desc: "summarise the conversation to free context" },
       { name: "clear", desc: "clear the conversation context" },
       { name: "init", desc: "write a CLIXAD.md for this project" },
@@ -1960,6 +2118,7 @@ function App({ client, config, wallet, session, initialTask }) {
   const [tick, setTick] = useState(0);
   const [startedAt, setStartedAt] = useState(0);
   const [quitHint, setQuitHint] = useState(false);
+  const [sponsor, setSponsor] = useState(null);
   const messagesRef = useRef(messages);
   messagesRef.current = messages;
   const permRef = useRef(createState("normal"));
@@ -1973,6 +2132,10 @@ function App({ client, config, wallet, session, initialTask }) {
   const lastOutputRef = useRef("");
   const runningToolRef = useRef(null);
   const pendingTaskRef = useRef(null);
+  const sponsorRef = useRef(sponsorSource());
+  const sponsorIdxRef = useRef(0);
+  const sponsorPrevRef = useRef(void 0);
+  const tallyRef = useRef(createTally());
   const push = useCallback((e) => {
     setEntries((prev) => [...prev, { ...e, id: idRef.current++ }]);
   }, []);
@@ -1993,6 +2156,32 @@ function App({ client, config, wallet, session, initialTask }) {
     (id) => catalogRef.current.find((m) => m.id === id)?.context_window ?? contextTokensFor(id),
     []
   );
+  const nextSponsor = useCallback(
+    (modelId) => {
+      if (!sponsorEnabled({
+        isTTY: process.stdout.isTTY,
+        env: process.env,
+        configEnabled: config.sponsor
+      })) {
+        setSponsor(null);
+        return;
+      }
+      const est = catalogRef.current.find((m) => m.id === modelId)?.est_ads_per_task;
+      const facts = {
+        grantRange: wallet?.grant_per_ad_range ? grantRangeLabel(wallet.grant_per_ad_range) : void 0,
+        adsPerTask: est === void 0 ? void 0 : adsPerTaskLabel(est)
+      };
+      const picked = sponsorRef.current.pick(sponsorIdxRef.current++, sponsorPrevRef.current, facts);
+      if (!picked) {
+        setSponsor(null);
+        return;
+      }
+      sponsorPrevRef.current = picked.id;
+      recordImpression(tallyRef.current, picked.id);
+      setSponsor(picked.text);
+    },
+    [config.sponsor, wallet]
+  );
   const askUser = useCallback(
     (req) => new Promise((resolve2) => setAsk({ req, resolve: resolve2 })),
     []
@@ -2057,6 +2246,7 @@ function App({ client, config, wallet, session, initialTask }) {
       setBusy(true);
       setStartedAt(Date.now());
       setLive({ text: "" });
+      nextSponsor(model);
       let history = messagesRef.current;
       try {
         const window = contextWindow(model);
@@ -2116,8 +2306,9 @@ function App({ client, config, wallet, session, initialTask }) {
             kind: "notice",
             tone: "warn",
             text: `  Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).
-  Press enter to open the ad wall (+${err.grantPerAd} credits on completion) \u2014 I'll continue automatically.
-  Offers you are screened out of pay nothing; that is normal, just start another.`
+  Press enter to open the ad wall \u2014 offers pay ${grantRangeLabel(err.grantRange)}.
+  I'll continue automatically. Offers you are screened out of pay nothing;
+  that is normal, just start another.`
           });
         } else if (err instanceof AuthError) {
           push({ kind: "notice", tone: "error", text: `  ${err.message}` });
@@ -2128,9 +2319,10 @@ function App({ client, config, wallet, session, initialTask }) {
         abortRef.current = null;
         setLive(null);
         setBusy(false);
+        setSponsor(null);
       }
     },
-    [client, contextWindow, handleEvent, model, permit, push, root, session?.title]
+    [client, contextWindow, handleEvent, model, nextSponsor, permit, push, root, session?.title]
   );
   const runAdWall = useCallback(async () => {
     const task = pendingTaskRef.current;
@@ -2276,9 +2468,12 @@ function App({ client, config, wallet, session, initialTask }) {
           try {
             const w = await client.wallet();
             setBalance(w.balance);
+            const reversals = w.ledger.filter((e) => e.reason === "ad_reversal");
+            const reversed = reversals.reduce((sum, e) => sum + Math.abs(e.delta), 0);
             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`
+              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` + (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.` : "")
             });
           } catch (err) {
             push({ kind: "notice", tone: "error", text: `  ${err.message}` });
@@ -2429,6 +2624,7 @@ function App({ client, config, wallet, session, initialTask }) {
   });
   const elapsed = busy && startedAt ? Math.floor((Date.now() - startedAt) / 1e3) : 0;
   const spinner = SPINNER[tick % SPINNER.length];
+  const sponsorLine = busy && sponsor ? sponsorText(sponsor, cols) : null;
   const liveText = live?.text ? tailLines(live.text, Math.max(4, rows - 12)) : "";
   const liveBlock = [
     liveText,
@@ -2439,7 +2635,7 @@ function App({ client, config, wallet, session, initialTask }) {
   const pickerHeight = picker ? picker.items.length + 8 : 0;
   const pickerLabelW = picker ? picker.items.reduce((w, i) => Math.max(w, i.label.length), 0) : 0;
   const inputBoxHeight = 2 + editor.lines.length;
-  const chromeHeight = inputBoxHeight + 2;
+  const chromeHeight = inputBoxHeight + 2 + (sponsorLine ? 1 : 0);
   const liveHeight = liveBlock ? lineCount(liveBlock, cols) + 1 : 0;
   const askHeight = ask2 ? lineCount(askBlock, cols) + 2 : 0;
   const printed = useMemo(() => entries.reduce((n, e) => n + entryHeight(e, cols), 0), [entries, cols]);
@@ -2474,6 +2670,7 @@ function App({ client, config, wallet, session, initialTask }) {
       /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "\u2191\u2193 choose \xB7 1-9 jump straight to a row \xB7 \u23CE confirm \xB7 esc cancel" })
     ] }) : null,
     /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginTop: 1, children: [
+      sponsorLine ? /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: sponsorLine }) : null,
       /* @__PURE__ */ jsxs2(Box2, { borderStyle: "round", borderColor: busy ? MANGO_BRIGHT : MANGO3, paddingX: 1, children: [
         /* @__PURE__ */ jsx2(Text2, { color: MANGO_BRIGHT, children: "\u276F " }),
         busy ? /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
@@ -2580,6 +2777,9 @@ var init_app = __esm({
     init_tools();
     init_permissions();
     init_session();
+    init_counter();
+    init_provider();
+    init_render();
     init_commands();
     init_editor();
     init_suggest();
@@ -2633,7 +2833,7 @@ async function main() {
   const client = new GatewayClient(config);
   switch (cmd) {
     case "login":
-      return login(client, config, rest[0]);
+      return login(client, config, rest);
     case "logout":
       return logout(config);
     case "whoami":
@@ -2674,14 +2874,49 @@ async function main() {
       process.exitCode = 1;
   }
 }
-async function login(client, config, email) {
+function takeInvite(args) {
+  const rest = [];
+  let invite;
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a === "--invite") invite = args[++i];
+    else if (a.startsWith("--invite=")) invite = a.slice("--invite=".length);
+    else rest.push(a);
+  }
+  return { invite: invite?.trim() || void 0, rest };
+}
+async function login(client, config, args) {
+  const { invite, rest } = takeInvite(args);
+  const email = rest[0];
   if (!email) {
     const start = await client.deviceStart().catch(() => null);
-    if (start) return githubLogin(client, config, start);
+    if (start) return githubLogin(client, config, start, invite);
   }
-  return devLogin(client, config, email);
+  return devLogin(client, config, email, invite);
 }
-async function githubLogin(client, config, start) {
+function reportSignupClosed(message, hadInvite) {
+  console.log(c.yellow("\n  Clixad isn't open yet.\n"));
+  for (const line2 of wrapPlain(message, 68)) console.log(`  ${line2}`);
+  if (hadInvite) {
+    console.log(
+      c.dim("\n  The invite code you passed wasn't accepted \u2014 check it for typos, or ask for a new one.")
+    );
+  }
+  console.log("");
+}
+function wrapPlain(text, width) {
+  const lines = [];
+  let line2 = "";
+  for (const word of text.split(/\s+/)) {
+    if (line2 && line2.length + 1 + word.length > width) {
+      lines.push(line2);
+      line2 = word;
+    } else line2 = line2 ? `${line2} ${word}` : word;
+  }
+  if (line2) lines.push(line2);
+  return lines;
+}
+async function githubLogin(client, config, start, invite) {
   console.log(`
   Open ${c.cyan(start.verification_uri)} and enter code: ${c.bold(start.user_code)}
 `);
@@ -2692,11 +2927,16 @@ async function githubLogin(client, config, start) {
   while (Date.now() < deadline) {
     await sleep(interval * 1e3);
     process.stdout.write(c.dim("."));
-    const poll = await client.devicePoll(start.session);
+    const poll = await client.devicePoll(start.session, invite);
     if (poll.status === "pending") {
       if (poll.interval) interval = poll.interval;
       continue;
     }
+    if (poll.status === "closed") {
+      reportSignupClosed(poll.message, Boolean(invite));
+      process.exitCode = 1;
+      return;
+    }
     if (poll.status === "complete") {
       config.token = poll.token;
       config.userId = poll.userId;
@@ -2716,8 +2956,18 @@ async function githubLogin(client, config, start) {
   }
   console.log(c.red("\n  login timed out \u2014 run `clixad login` again."));
 }
-async function devLogin(client, config, email) {
-  const res = await client.signupDev(email);
+async function devLogin(client, config, email, invite) {
+  let res;
+  try {
+    res = await client.signupDev(email, invite);
+  } catch (err) {
+    if (err instanceof SignupClosedError) {
+      reportSignupClosed(err.message, Boolean(invite));
+      process.exitCode = 1;
+      return;
+    }
+    throw err;
+  }
   config.token = res.token;
   config.userId = res.userId;
   config.email = res.email;
@@ -2770,13 +3020,19 @@ async function setModel(client, config, model) {
 }
 async function showWallet(client) {
   const w = await client.wallet();
-  console.log(`balance: ${c.bold(String(w.balance))} credits`);
-  console.log(`${earnedToday(w)}  \xB7  typical grant: ${w.grant_per_ad} on completion`);
+  console.log(`balance: ${c.bold(w.balance.toLocaleString("en-US"))} credits`);
+  console.log(`${earnedToday(w)}  \xB7  offers pay ${grantRangeLabel(w.grant_per_ad_range)}`);
   if (w.ledger.length) {
     console.log(c.dim("recent:"));
+    const label = (e) => ledgerReasonLabel(e.reason);
+    const width = Math.max(...w.ledger.slice(0, 8).map((e) => label(e).length));
     for (const e of w.ledger.slice(0, 8)) {
-      const sign = e.delta >= 0 ? c.green(`+${e.delta}`) : c.red(String(e.delta));
-      console.log(c.dim(`  ${sign.padEnd(18)} ${e.reason.padEnd(14)} -> ${e.balanceAfter}`));
+      const amount = `${e.delta >= 0 ? "+" : "-"}${Math.abs(e.delta).toLocaleString("en-US")}`;
+      const sign = e.delta >= 0 ? c.green(amount) : c.yellow(amount);
+      const pad = " ".repeat(Math.max(0, 10 - amount.length));
+      console.log(
+        c.dim(`  ${sign}${pad}  ${label(e).padEnd(width)}  -> ${e.balanceAfter.toLocaleString("en-US")}`)
+      );
     }
   }
 }
@@ -2878,7 +3134,7 @@ async function printCmd(client, config, task) {
 Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
       console.log(
         c.yellow(
-          `Run \`clixad earn\` to open the offerwall (+${err.grantPerAd} credits on completion) or buy credits.`
+          `Run \`clixad earn\` to open the offerwall \u2014 offers pay ${grantRangeLabel(err.grantRange)} \u2014 or buy credits.`
         )
       );
       console.log(c.dim("  Offers you are screened out of pay nothing \u2014 that is normal, just start another."));
@@ -2975,7 +3231,7 @@ async function runTurn(client, config, messages) {
     if (err instanceof PaywallError) {
       console.log(c.yellow(`Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
       console.log(
-        c.yellow(`Run /earn to open the offerwall (+${err.grantPerAd} credits on completion) or buy credits.`)
+        c.yellow(`Run /earn to open the offerwall \u2014 offers pay ${grantRangeLabel(err.grantRange)} \u2014 or buy credits.`)
       );
       console.log(c.dim("  Offers you are screened out of pay nothing \u2014 that is normal, just start another."));
     } else if (err instanceof AuthError) {
@@ -2996,7 +3252,7 @@ async function safeWallet(client) {
 function printHelp() {
   console.log(`${c.bold("clixad")} \u2014 free AI coding in your terminal, funded by ads
 
-  ${c.cyan("login")} [email]      create/attach an account
+  ${c.cyan("login")} [email]      create/attach an account (${c.dim("--invite <code>")} if you have one)
   ${c.cyan("logout")}            forget the stored token
   ${c.cyan("whoami")}            show account + balance
   ${c.cyan("models")}            list models with credit prices

package/package.json

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