clixad 0.0.1-beta.0 → 0.0.1-beta.2

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}` };
         }
@@ -161,14 +210,18 @@ var init_client = __esm({
         if (!res.ok) throw new Error(`checkout failed: ${res.status} ${await res.text()}`);
         return res.json();
       }
-      async models() {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/models`);
+      // Both take an optional signal for the REPL's sake: they are awaited while the
+      // input box is locked, and a gateway that is cold-starting (Render's free tier,
+      // the better part of a minute) would otherwise be indistinguishable from a
+      // hung terminal. Nothing else passes one — a one-shot CLI command has Ctrl+C.
+      async models(signal) {
+        const res = await fetch(`${this.config.gatewayUrl}/v1/models`, { signal });
         if (!res.ok) throw new Error(`models failed: ${res.status}`);
         const data = await res.json();
         return data.data;
       }
-      async wallet() {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/wallet`, { headers: this.headers() });
+      async wallet(signal) {
+        const res = await fetch(`${this.config.gatewayUrl}/v1/wallet`, { 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();
@@ -191,8 +244,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 +272,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 = "";
@@ -1436,7 +1487,9 @@ import { spawn as spawn3 } from "node:child_process";
 function openBrowser(url) {
   const cmd = process.platform === "win32" ? "cmd" : process.platform === "darwin" ? "open" : "xdg-open";
   const args = process.platform === "win32" ? ["/c", "start", "", url] : [url];
-  spawn3(cmd, args, { detached: true, stdio: "ignore", windowsHide: true }).unref();
+  const child = spawn3(cmd, args, { detached: true, stdio: "ignore", windowsHide: true });
+  child.on("error", () => void 0);
+  child.unref();
 }
 var init_browser = __esm({
   "src/browser.ts"() {
@@ -1505,6 +1558,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 +1689,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,10 +2124,13 @@ function App({ client, config, wallet, session, initialTask }) {
   const [tick, setTick] = useState(0);
   const [startedAt, setStartedAt] = useState(0);
   const [quitHint, setQuitHint] = useState(false);
+  const [busyLabel, setBusyLabel] = useState(WORKING);
+  const [sponsor, setSponsor] = useState(null);
   const messagesRef = useRef(messages);
   messagesRef.current = messages;
   const permRef = useRef(createState("normal"));
   const abortRef = useRef(null);
+  const busyAbortRef = useRef(null);
   const filesRef = useRef(null);
   const ctrlCRef = useRef(0);
   const sessionRef = useRef(session ?? { id: newSessionId(), started: (/* @__PURE__ */ new Date()).toISOString() });
@@ -1973,6 +2140,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 +2164,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 +2254,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 +2314,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 +2327,34 @@ function App({ client, config, wallet, session, initialTask }) {
         abortRef.current = null;
         setLive(null);
         setBusy(false);
+        setSponsor(null);
+      }
+    },
+    [client, contextWindow, handleEvent, model, nextSponsor, permit, push, root, session?.title]
+  );
+  const stopCurrent = useCallback(() => {
+    abortRef.current?.abort();
+    busyAbortRef.current?.abort();
+  }, []);
+  const runBusy = useCallback(
+    async (label, fn) => {
+      const ac = new AbortController();
+      busyAbortRef.current = ac;
+      setBusy(true);
+      setBusyLabel(label);
+      setStartedAt(Date.now());
+      try {
+        await fn(ac.signal);
+      } catch (err) {
+        if (ac.signal.aborted) push({ kind: "notice", tone: "warn", text: "  (stopped)" });
+        else push({ kind: "notice", tone: "error", text: `  ${err.message}` });
+      } finally {
+        busyAbortRef.current = null;
+        setBusyLabel(WORKING);
+        setBusy(false);
       }
     },
-    [client, contextWindow, handleEvent, model, permit, push, root, session?.title]
+    [push]
   );
   const runAdWall = useCallback(async () => {
     const task = pendingTaskRef.current;
@@ -2145,18 +2369,28 @@ function App({ client, config, wallet, session, initialTask }) {
 ` : `  opened ${base} \u2014 paste your token there; waiting for the reward\u2026
 `) + `  Credits land on completion; being screened out of an offer pays nothing and is normal.`
     });
-    setBusy(true);
-    const deadline = Date.now() + 5 * 6e4;
     let credited = false;
-    while (Date.now() < deadline && !credited) {
-      await new Promise((r) => setTimeout(r, 3e3));
-      const w = await client.wallet().catch(() => void 0);
-      if (w && w.balance > before) {
-        setBalance(w.balance);
-        credited = true;
+    let stopped = false;
+    await runBusy(WAITING_FOR_REWARD, async (signal) => {
+      const deadline = Date.now() + 5 * 6e4;
+      while (Date.now() < deadline && !credited && !signal.aborted) {
+        await sleep(3e3, signal);
+        if (signal.aborted) break;
+        const w = await client.wallet(signal).catch(() => void 0);
+        if (w && w.balance > before) {
+          setBalance(w.balance);
+          credited = true;
+        }
       }
-    }
-    setBusy(false);
+      stopped = signal.aborted;
+    });
+    if (!credited) pendingTaskRef.current = task;
+    if (stopped)
+      return push({
+        kind: "notice",
+        tone: "warn",
+        text: "  stopped waiting. A reward still lands whenever the offer clears \u2014\n  /wallet checks the balance, /earn opens the wall again." + (task ? "\n  Your last request is still queued: press enter to retry it." : "")
+      });
     if (!credited)
       return push({
         kind: "notice",
@@ -2165,7 +2399,7 @@ function App({ client, config, wallet, session, initialTask }) {
       });
     push({ kind: "notice", tone: "good", text: "  credits added \u2014 continuing" });
     if (task) await runTurn2(task);
-  }, [balance, client, config.dashboardUrl, push, runTurn2]);
+  }, [balance, client, config.dashboardUrl, push, runBusy, runTurn2]);
   const runCommand = useCallback(
     async (line2) => {
       const [cmd, ...rest] = line2.slice(1).split(" ");
@@ -2198,94 +2432,84 @@ function App({ client, config, wallet, session, initialTask }) {
           push({ kind: "notice", text: `  mode \u2192 ${MODE_LABEL[permRef.current.mode]}` });
           return;
         }
-        case "compact": {
-          setBusy(true);
-          try {
-            const res = await compact(client, model, [
-              { role: "system", content: contextRef.current.systemPrompt },
-              ...messagesRef.current
-            ]);
-            if (!res) push({ kind: "notice", text: "  nothing to compact yet" });
-            else {
-              setMessages(res.messages.slice(1));
-              setBalance(res.balance);
-              setSpent((s) => s + res.creditsCharged);
-              push({
-                kind: "notice",
-                text: `  compacted: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged} credits)`
-              });
-            }
-          } catch (err) {
-            push({ kind: "notice", tone: "error", text: `  ${err.message}` });
-          }
-          setBusy(false);
+        // A model call like any other, so esc has to stop it like any other —
+        // and stopping it costs nothing, since the summary only replaces the
+        // conversation once the call has come back whole.
+        case "compact":
+          await runBusy(COMPACTING, async (signal) => {
+            const res = await compact(
+              client,
+              model,
+              [{ role: "system", content: contextRef.current.systemPrompt }, ...messagesRef.current],
+              { signal }
+            );
+            if (!res) return push({ kind: "notice", text: "  nothing to compact yet" });
+            setMessages(res.messages.slice(1));
+            setBalance(res.balance);
+            setSpent((s) => s + res.creditsCharged);
+            push({
+              kind: "notice",
+              text: `  compacted: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged} credits)`
+            });
+          });
           return;
-        }
         case "init":
           await runTurn2(INIT_PROMPT);
           return;
         // Always the picker — an id you have to remember and type is exactly
         // what a picker is for. A typed id only preselects a row.
-        case "model": {
-          setBusy(true);
-          const models = catalogRef.current.length ? catalogRef.current : await client.models().catch(() => []);
-          catalogRef.current = models;
-          setBusy(false);
-          if (!models.length) return push({ kind: "notice", tone: "error", text: "  could not load the model list" });
-          if (arg && !models.some((m) => m.id === arg)) {
-            push({ kind: "notice", tone: "warn", text: `  unknown model: ${arg}` });
-          }
-          const items = models.map((m) => ({
-            value: m.id,
-            label: m.id,
-            hint: `${m.tier.padEnd(8)}${adsPerTaskLabel(m.est_ads_per_task)}`,
-            current: m.id === model
-          }));
-          const preselect = items.findIndex((i) => i.value === arg);
-          setPickerSel(preselect >= 0 ? preselect : Math.max(0, items.findIndex((i) => i.current)));
-          setPicker({
-            title: "Select model",
-            subtitle: "Applies to this session and is saved as your default.",
-            items,
-            onPick: (choice) => {
-              config.model = choice.value;
-              saveConfig(config);
-              setModel2(choice.value);
-              push({ kind: "notice", text: `  model \u2192 ${choice.value}` });
+        case "model":
+          await runBusy(LOADING, async (signal) => {
+            const models = catalogRef.current.length ? catalogRef.current : await client.models(signal);
+            catalogRef.current = models;
+            if (!models.length) return push({ kind: "notice", tone: "error", text: "  could not load the model list" });
+            if (arg && !models.some((m) => m.id === arg)) {
+              push({ kind: "notice", tone: "warn", text: `  unknown model: ${arg}` });
             }
+            const items = models.map((m) => ({
+              value: m.id,
+              label: m.id,
+              hint: `${m.tier.padEnd(8)}${adsPerTaskLabel(m.est_ads_per_task)}`,
+              current: m.id === model
+            }));
+            const preselect = items.findIndex((i) => i.value === arg);
+            setPickerSel(preselect >= 0 ? preselect : Math.max(0, items.findIndex((i) => i.current)));
+            setPicker({
+              title: "Select model",
+              subtitle: "Applies to this session and is saved as your default.",
+              items,
+              onPick: (choice) => {
+                config.model = choice.value;
+                saveConfig(config);
+                setModel2(choice.value);
+                push({ kind: "notice", text: `  model \u2192 ${choice.value}` });
+              }
+            });
           });
           return;
-        }
-        case "models": {
-          setBusy(true);
-          try {
-            const ms = await client.models();
+        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)} ${adsPerTaskLabel(m.est_ads_per_task)}`).join("\n")
             });
-          } catch (err) {
-            push({ kind: "notice", tone: "error", text: `  ${err.message}` });
-          }
-          setBusy(false);
+          });
           return;
-        }
-        case "wallet": {
-          setBusy(true);
-          try {
-            const w = await client.wallet();
+        case "wallet":
+          await runBusy(LOADING, async (signal) => {
+            const w = await client.wallet(signal);
             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}` });
-          }
-          setBusy(false);
+          });
           return;
-        }
         // The same browser handoff the paywall takes, rather than a second way of
         // doing it: /earn used to call the dev-only /v1/ads/reward simulator, so
         // in production the slash command the paywall itself recommends was a 404.
@@ -2296,7 +2520,7 @@ function App({ client, config, wallet, session, initialTask }) {
           push({ kind: "notice", tone: "warn", text: `  unknown command: /${cmd} \u2014 try /help` });
       }
     },
-    [client, config, cycleMode, exit, model, push, runTurn2]
+    [client, config, cycleMode, exit, model, push, runAdWall, runBusy, runTurn2]
   );
   const submit = useCallback(
     async (raw) => {
@@ -2345,7 +2569,7 @@ function App({ client, config, wallet, session, initialTask }) {
   );
   useInput((ch, key) => {
     if (key.ctrl && ch === "c") {
-      if (busy) return abortRef.current?.abort();
+      if (busy) return stopCurrent();
       if (!isEmpty(editor)) return setEditor(EMPTY);
       if (Date.now() - ctrlCRef.current < 2e3) return exit();
       ctrlCRef.current = Date.now();
@@ -2384,7 +2608,7 @@ function App({ client, config, wallet, session, initialTask }) {
       return;
     }
     if (busy) {
-      if (key.escape) abortRef.current?.abort();
+      if (key.escape) stopCurrent();
       return;
     }
     if (key.tab && key.shift) return cycleMode();
@@ -2429,6 +2653,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 +2664,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,11 +2699,14 @@ 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: [
           spinner,
-          " working\u2026 ",
+          " ",
+          busyLabel,
+          " ",
           elapsed,
           "s \xB7 esc to stop"
         ] }) : /* @__PURE__ */ jsx2(Text2, { children: renderInput(editor) })
@@ -2505,6 +2733,18 @@ function App({ client, config, wallet, session, initialTask }) {
     ] })
   ] });
 }
+function sleep(ms, signal) {
+  return new Promise((resolve2) => {
+    if (signal.aborted) return resolve2();
+    const done = () => {
+      clearTimeout(timer);
+      signal.removeEventListener("abort", done);
+      resolve2();
+    };
+    const timer = setTimeout(done, ms);
+    signal.addEventListener("abort", done, { once: true });
+  });
+}
 function renderInput(state) {
   return state.lines.map((line2, row) => {
     const prefix = row === 0 ? "" : "\n";
@@ -2565,7 +2805,7 @@ function tailLines(text, max) {
   const lines = text.split("\n");
   return lines.length <= max ? text : lines.slice(-max).join("\n");
 }
-var SPINNER, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES;
+var SPINNER, WORKING, WAITING_FOR_REWARD, LOADING, COMPACTING, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES;
 var init_app = __esm({
   "src/tui/app.tsx"() {
     "use strict";
@@ -2580,11 +2820,18 @@ var init_app = __esm({
     init_tools();
     init_permissions();
     init_session();
+    init_counter();
+    init_provider();
+    init_render();
     init_commands();
     init_editor();
     init_suggest();
     init_views();
     SPINNER = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+    WORKING = "working\u2026";
+    WAITING_FOR_REWARD = "waiting for the offer\u2026";
+    LOADING = "loading\u2026";
+    COMPACTING = "compacting\u2026";
     LIVE_OUTPUT_LINES = 5;
     COMMITTED_OUTPUT_LINES = 4;
   }
@@ -2619,6 +2866,31 @@ init_session();
 init_kimi();
 init_banner();
 init_browser();
+
+// src/title.ts
+var APP_TITLE = "Clixad";
+function titleEnabled({ isTTY, env }) {
+  const flag = env.CLIXAD_TITLE?.trim().toLowerCase();
+  if (flag === "0" || flag === "false" || flag === "off" || flag === "no") return false;
+  if (!isTTY) return false;
+  if (env.TERM === "dumb") return false;
+  if (env.CI !== void 0 && env.CI !== "") return false;
+  return true;
+}
+function titleSequence(title) {
+  return `\x1B]0;${title.replace(/[\x00-\x1f\x7f]/g, " ").trim()}\x07`;
+}
+function setTerminalTitle(title = APP_TITLE, out = process.stdout) {
+  process.title = title.toLowerCase();
+  if (!titleEnabled({ isTTY: out.isTTY, env: process.env })) return;
+  out.write(titleSequence(title));
+}
+function clearTerminalTitle(out = process.stdout) {
+  if (!titleEnabled({ isTTY: out.isTTY, env: process.env })) return;
+  out.write(titleSequence(""));
+}
+
+// src/main.ts
 var c = {
   cyan: (s) => `\x1B[36m${s}\x1B[0m`,
   green: (s) => `\x1B[32m${s}\x1B[0m`,
@@ -2628,12 +2900,14 @@ var c = {
   bold: (s) => `\x1B[1m${s}\x1B[0m`
 };
 async function main() {
+  setTerminalTitle();
+  process.on("exit", () => clearTerminalTitle());
   const [cmd, ...rest] = process.argv.slice(2);
   const config = loadConfig();
   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 +2948,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);
+}
+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) {
+async function githubLogin(client, config, start, invite) {
   console.log(`
   Open ${c.cyan(start.verification_uri)} and enter code: ${c.bold(start.user_code)}
 `);
@@ -2690,13 +2999,18 @@ async function githubLogin(client, config, start) {
   const deadline = Date.now() + start.expires_in * 1e3;
   let interval = Math.max(start.interval, 1);
   while (Date.now() < deadline) {
-    await sleep(interval * 1e3);
+    await sleep2(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 +3030,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;
@@ -2726,7 +3050,7 @@ async function devLogin(client, config, email) {
   console.log(`  balance: ${c.bold(String(res.balance))} credits (signup bonus)`);
   console.log(c.dim(`  token stored in ${configPath()}`));
 }
-var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
 function logout(config) {
   delete config.token;
   delete config.userId;
@@ -2770,13 +3094,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")}`)
+      );
     }
   }
 }
@@ -2796,7 +3126,7 @@ async function earn(client, config) {
   process.stdout.write(c.dim("  waiting for an offer to clear"));
   const deadline = Date.now() + 5 * 60 * 1e3;
   while (Date.now() < deadline) {
-    await sleep(3e3);
+    await sleep2(3e3);
     process.stdout.write(c.dim("."));
     const balance = (await safeWallet(client))?.balance ?? before;
     if (balance > before) {
@@ -2841,7 +3171,7 @@ async function buyCmd(client, config, pack) {
   process.stdout.write(c.dim("  waiting for payment to clear"));
   const deadline = Date.now() + 5 * 60 * 1e3;
   while (Date.now() < deadline) {
-    await sleep(3e3);
+    await sleep2(3e3);
     process.stdout.write(c.dim("."));
     const balance = (await safeWallet(client))?.balance ?? before;
     if (balance > before) {
@@ -2878,7 +3208,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 +3305,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 +3326,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.2",
   "description": "Free AI coding agent in your terminal, funded by rewarded ads.",
   "license": "UNLICENSED",
   "type": "module",