clixad 0.0.1-beta.22 → 0.0.1-beta.23

package/dist/clixad.mjs

@@ -350,12 +350,48 @@ function asSignupClosed(status, data) {
   const d = data;
   return d && d.error === "signup_closed" && typeof d.message === "string" ? { error: d.error, message: d.message, waitlist_url: d.waitlist_url ?? "https://clixad.io" } : void 0;
 }
+function shortfallHeadline(err, model) {
+  const n = (v) => Math.max(0, Math.round(v)).toLocaleString("en-US");
+  if (err.balance <= 0) return `Out of credits (this needs about ${n(err.estimatedCost)}).`;
+  return `Not enough credits for this turn${model ? ` on ${model}` : ""}: it needs about ${n(err.estimatedCost)}, and the balance is ${n(err.balance)}.`;
+}
 function paywallError(body) {
   const free = Array.isArray(body.free_models) ? body.free_models.filter(
     (m) => !!m && typeof m.id === "string" && m.id.length > 0 && Number.isFinite(m.turns_left)
   ).map((m) => ({ id: m.id, turnsLeft: Math.max(0, Math.floor(m.turns_left)) })).filter((m) => m.turnsLeft > 0) : [];
   return new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad, free);
 }
+function neverConnected(code) {
+  return code !== void 0 && NEVER_CONNECTED.has(code);
+}
+function networkCode(err) {
+  let cause = err?.cause;
+  for (let depth = 0; depth < 3 && cause; depth++) {
+    const code = cause.code;
+    if (typeof code === "string" && code) return code;
+    const inner = cause.errors;
+    if (Array.isArray(inner)) {
+      const first = inner.find((e) => typeof e?.code === "string");
+      if (first) return first.code;
+    }
+    cause = cause.cause;
+  }
+  return void 0;
+}
+async function gatewayFetch(url, init) {
+  try {
+    return await fetch(url, init);
+  } catch (err) {
+    const aborted = init?.signal?.aborted || err?.name === "AbortError";
+    if (aborted || !(err instanceof TypeError)) throw err;
+    let host = String(url);
+    try {
+      host = new URL(url).host;
+    } catch {
+    }
+    throw new GatewayUnreachableError(host, networkCode(err));
+  }
+}
 async function authFailure(res, what) {
   const body = await res.text().catch(() => "");
   const isJson = (res.headers.get("content-type") ?? "").includes("json");
@@ -429,7 +465,7 @@ async function* parseSSE(body) {
     }
   }
 }
-var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, AuthError, GatewayClient;
+var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, GatewayUnreachableError, NEVER_CONNECTED, AuthError, GatewayClient;
 var init_client = __esm({
   "src/client.ts"() {
     "use strict";
@@ -478,6 +514,33 @@ var init_client = __esm({
       grantPerAd;
       freeModels;
     };
+    GatewayUnreachableError = class extends Error {
+      constructor(host, code) {
+        const where = `${host}${code ? ` (${code})` : ""}`;
+        super(
+          neverConnected(code) ? `Can't reach the Clixad gateway at ${where}. Nothing was sent, so nothing was charged. Check your connection and try again.` : `The connection to the Clixad gateway at ${where} broke before an answer arrived. If that was a model call it may still have been charged, so check your balance before sending it again.`
+        );
+        this.host = host;
+        this.code = code;
+        this.name = "GatewayUnreachableError";
+      }
+      host;
+      code;
+    };
+    NEVER_CONNECTED = /* @__PURE__ */ new Set([
+      "ENOTFOUND",
+      "EAI_AGAIN",
+      "ECONNREFUSED",
+      "ENETUNREACH",
+      "EHOSTUNREACH",
+      "EADDRNOTAVAIL",
+      "UND_ERR_CONNECT_TIMEOUT",
+      "CERT_HAS_EXPIRED",
+      "DEPTH_ZERO_SELF_SIGNED_CERT",
+      "SELF_SIGNED_CERT_IN_CHAIN",
+      "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+      "ERR_TLS_CERT_ALTNAME_INVALID"
+    ]);
     AuthError = class extends Error {
       constructor() {
         super("Not logged in. Run `clixad login` first.");
@@ -518,7 +581,7 @@ var init_client = __esm({
       }
       /** Dev-only signup shortcut (production replaces this with GitHub OAuth). */
       async signupDev(email, invite) {
-        const res = await fetch(`${this.config.gatewayUrl}/dev/users`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/dev/users`, {
           method: "POST",
           headers: this.headers(false),
           body: JSON.stringify({ ...email ? { email } : {}, ...invite ? { invite } : {} })
@@ -534,7 +597,7 @@ var init_client = __esm({
       /** Begin GitHub device-flow login. Returns null if the gateway has no GitHub
        *  configured (501), so the caller can fall back to the dev shortcut. */
       async deviceStart() {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/auth/device/start`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/auth/device/start`, {
           method: "POST",
           headers: this.headers(false)
         });
@@ -544,7 +607,7 @@ var init_client = __esm({
       }
       /** 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`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/auth/device/poll`, {
           method: "POST",
           headers: this.headers(false),
           body: JSON.stringify(invite ? { session, invite } : { session })
@@ -566,7 +629,7 @@ var init_client = __esm({
        */
       async handoffCode() {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/auth/handoff`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/auth/handoff`, {
             method: "POST",
             headers: this.headers()
           });
@@ -593,7 +656,7 @@ var init_client = __esm({
        */
       async claimStreak(signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/streak/claim`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/streak/claim`, {
             method: "POST",
             headers: this.headers(),
             ...signal ? { signal } : {}
@@ -628,7 +691,7 @@ var init_client = __esm({
        */
       async sendFeedback(report, signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/feedback`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/feedback`, {
             method: "POST",
             headers: this.headers(),
             ...signal ? { signal } : {},
@@ -663,7 +726,7 @@ var init_client = __esm({
        * that did not run, and saying so beats printing an empty summary.
        */
       async referral(signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/referrals`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/referrals`, {
           headers: this.headers(),
           ...signal ? { signal } : {}
         });
@@ -694,7 +757,7 @@ var init_client = __esm({
        * 200 with a status, because that is an answer rather than a failure.
        */
       async redeem(code, signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/redeem`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/redeem`, {
           method: "POST",
           headers: this.headers(),
           ...signal ? { signal } : {},
@@ -715,7 +778,7 @@ var init_client = __esm({
        * them with the input box locked and "esc to stop" on screen.
        */
       async creditPacks(signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/billing/packs`, { signal });
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/billing/packs`, { signal });
         if (!res.ok) throw new Error(`packs failed: ${res.status}`);
         return res.json();
       }
@@ -726,7 +789,7 @@ var init_client = __esm({
        * could not deliver instantly is worse than not starting one.
        */
       async checkout(pack, consent, signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/billing/checkout`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/billing/checkout`, {
           method: "POST",
           headers: this.headers(),
           ...signal ? { signal } : {},
@@ -742,13 +805,37 @@ var init_client = __esm({
       // 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 });
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/models`, { signal });
         if (!res.ok) throw new Error(`models failed: ${res.status}`);
         const data = await res.json();
         this.seen = { web_search: data.capabilities?.web_search === true };
         this.shape = parseTaskShape(data.task_shape);
+        this.latest = typeof data.cli_latest === "string" ? data.cli_latest : void 0;
+        const live = new Set(data.data.map((m) => m.id));
+        this.retired = {};
+        if (data.retired_models && typeof data.retired_models === "object") {
+          for (const [from, to] of Object.entries(data.retired_models)) {
+            if (typeof to === "string" && live.has(to) && !live.has(from)) this.retired[from] = to;
+          }
+        }
         return data.data;
       }
+      /**
+       * Model ids that were retired, and the live model that serves each one, as of
+       * the last catalog fetch. Empty from a gateway that does not send the map.
+       */
+      get retiredModels() {
+        return this.retired;
+      }
+      retired = {};
+      /**
+       * The newest `clixad` published to npm, as the gateway last read it, or
+       * undefined when it did not say. Undefined means unknown, never up to date.
+       */
+      get latestCli() {
+        return this.latest;
+      }
+      latest;
       /**
        * The task shape the cost preview assumes, as of the last catalog fetch, or
        * undefined when the gateway sent none (or one that did not parse). Undefined
@@ -773,7 +860,7 @@ var init_client = __esm({
       }
       seen = { web_search: false };
       async wallet(signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/wallet`, { headers: this.headers(), signal });
+        const res = await gatewayFetch(`${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();
@@ -809,7 +896,7 @@ var init_client = __esm({
        */
       async sponsorConfig(signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/sponsor/config`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/sponsor/config`, {
             headers: this.headers(),
             ...signal ? { signal } : {}
           });
@@ -847,7 +934,7 @@ var init_client = __esm({
        */
       async reportImpression(report, signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/sponsor/impression`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/sponsor/impression`, {
             method: "POST",
             headers: this.headers(),
             ...signal ? { signal } : {},
@@ -880,7 +967,7 @@ var init_client = __esm({
         const url = new URL(`${this.config.gatewayUrl}/v1/web/search`);
         url.searchParams.set("q", query);
         if (opts.count) url.searchParams.set("count", String(opts.count));
-        const res = await fetch(url, {
+        const res = await gatewayFetch(url, {
           headers: this.headers(),
           ...opts.signal ? { signal: opts.signal } : {}
         });
@@ -920,7 +1007,7 @@ var init_client = __esm({
       /** One POST to the chat route, in whichever transport is currently in use. */
       sendChat(payload, encoded, signal) {
         const json = JSON.stringify(payload);
-        return fetch(`${this.config.gatewayUrl}/v1/chat/completions`, {
+        return gatewayFetch(`${this.config.gatewayUrl}/v1/chat/completions`, {
           method: "POST",
           headers: encoded ? { ...this.headers(), "Content-Type": CHAT_ENCODED_CONTENT_TYPE } : this.headers(),
           body: encoded ? encodeChatBody(json) : json,
@@ -4528,17 +4615,26 @@ var init_kimi = __esm({
       "gpt-5-nano": 4e5,
       "gemini-2.5-flash-lite": 1048576,
       "deepseek-v4-flash": 1048576,
-      "gemini-3.1-flash-lite": 1048576,
-      "kimi-k2": 131072,
+      "gemini-3.5-flash-lite": 1048576,
+      "kimi-k2.5": 262144,
+      "gemini-3.8-flash": 1048576,
       "kimi-k2.7-code": 262144,
       "claude-haiku-4.5": 2e5,
-      "gemini-3.6-flash": 1048576,
       "claude-sonnet-5": 1e6,
-      "gpt-5.2": 4e5,
+      "gpt-6-sol": 105e4,
       "kimi-k3": 1048576,
+      "claude-opus-5.5": 1e6,
+      "claude-fable-5.1": 1e6,
+      // Retired on 2026-09-27 and served by their successor (`RETIRED_MODELS` in
+      // packages/pricing), so an install still configured with one compacts
+      // against the window of the model that actually answers.
+      "gemini-3.1-flash-lite": 1048576,
+      "kimi-k2": 262144,
+      "gemini-3.6-flash": 1048576,
+      "gpt-5.2": 105e4,
       "claude-opus-5": 1e6,
       "gpt-5.5": 105e4,
-      "gpt-5.2-pro": 4e5
+      "gpt-5.2-pro": 105e4
     };
     DEFAULT_CONTEXT_TOKENS = 256e3;
     INSTALL_HELP = `Kimi CLI is not installed (or not on PATH).
@@ -4588,6 +4684,14 @@ function bannerTip(index) {
   const i = index ?? Math.floor(Math.random() * BANNER_TIPS.length);
   return BANNER_TIPS[(i % BANNER_TIPS.length + BANNER_TIPS.length) % BANNER_TIPS.length];
 }
+function greeting(opts, nameWidth) {
+  if (!opts.name) return "Welcome to Clixad!";
+  const name = nameWidth === void 0 ? opts.name : truncate(opts.name, nameWidth);
+  return opts.newAccount ? `Welcome to Clixad, ${name}!` : `Welcome back, ${name}!`;
+}
+function balanceLabel(opts) {
+  return opts.balance === void 0 ? "balance unavailable" : `${opts.balance.toLocaleString("en-US")} credits`;
+}
 function earnedLabel(opts) {
   return `$${opts.earnedUsdToday.toFixed(2)}/$${opts.maxRewardUsd.toFixed(2)} today`;
 }
@@ -4597,7 +4701,7 @@ function welcomeBanner(opts) {
   const rightW = Math.min(RIGHT_MAX, Math.max(26, inner - 30));
   const leftW = inner - rightW;
   const cwd = opts.cwd.replace(homedir6(), "~").replace(/\\/g, "/");
-  const welcome = opts.name ? `Welcome back, ${truncate(opts.name, 18)}!` : "Welcome to Clixad!";
+  const welcome = greeting(opts, Math.max(1, Math.min(18, leftW - (opts.newAccount ? 20 : 15))));
   const duck = duckLines();
   const home = truncate(cwd, leftW);
   const hint = bannerTip(opts.tipIndex);
@@ -4623,8 +4727,10 @@ function welcomeBanner(opts) {
     tip("/wallet", "balance & ads"),
     cell("", 0),
     cell(BOLD + MANGO + "Wallet" + R2, 6),
-    cell(TEXT + `${opts.balance.toLocaleString("en-US")} credits` + R2, `${opts.balance.toLocaleString("en-US")} credits`.length),
-    cell(MUTED + earnedLabel(opts) + R2, earnedLabel(opts).length)
+    cell(TEXT + balanceLabel(opts) + R2, balanceLabel(opts).length),
+    // Without a wallet there is no earned figure either, and "$0.00/$0.00" is
+    // two invented numbers rather than a statement of what is unknown.
+    opts.balance === void 0 ? cell("", 0) : cell(MUTED + earnedLabel(opts) + R2, earnedLabel(opts).length)
   ];
   const rows = Math.max(left.length, right.length);
   const out = [];
@@ -4642,9 +4748,9 @@ function welcomeBanner(opts) {
 }
 function compactBanner(opts) {
   const width = Math.max(1, opts.width ?? MIN_BANNER_WIDTH);
-  const welcome = truncate(opts.name ? `Welcome back, ${opts.name}!` : "Welcome to Clixad!", Math.max(1, width - 2));
+  const welcome = truncate(greeting(opts), Math.max(1, width - 2));
   const hint = bannerTip(opts.tipIndex);
-  const balance = `${opts.balance.toLocaleString("en-US")} credits`;
+  const balance = balanceLabel(opts);
   const room = width - (4 + stringWidth(hint.key) + 1 + 4 + stringWidth(balance));
   const desc = room >= 3 ? truncate(hint.desc, room) : "";
   const tipRow = desc ? `  ${MANGO}\u25C6${R2} ${BOLD}${TEXT}${hint.key}${R2} ${FAINT}${desc}${R2}  ${FAINT}\xB7${R2} ${balance}` : truncate(`  ${MANGO}\u25C6${R2} ${BOLD}${TEXT}${hint.key}${R2}  ${FAINT}\xB7${R2} ${balance}`, width);
@@ -4778,6 +4884,34 @@ function readVersion() {
     return "unknown";
   }
 }
+function isNewerVersion(candidate, current) {
+  const parse2 = (v) => {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(v.trim());
+    if (!m) return void 0;
+    return { core: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] ? m[4].split(".") : [] };
+  };
+  const a = parse2(candidate);
+  const b = parse2(current);
+  if (!a || !b) return false;
+  for (let i = 0; i < 3; i++) {
+    if (a.core[i] !== b.core[i]) return a.core[i] > b.core[i];
+  }
+  if (!a.pre.length || !b.pre.length) return !a.pre.length && b.pre.length > 0;
+  for (let i = 0; i < Math.max(a.pre.length, b.pre.length); i++) {
+    const x = a.pre[i];
+    const y = b.pre[i];
+    if (x === void 0) return false;
+    if (y === void 0) return true;
+    if (x === y) continue;
+    const nx = /^\d+$/.test(x) ? Number(x) : void 0;
+    const ny = /^\d+$/.test(y) ? Number(y) : void 0;
+    if (nx !== void 0 && ny !== void 0) return nx > ny;
+    if (nx !== void 0) return false;
+    if (ny !== void 0) return true;
+    return x > y;
+  }
+  return false;
+}
 var VERSION, VERSION_LABEL;
 var init_version = __esm({
   "src/version.ts"() {
@@ -5668,6 +5802,7 @@ function App({
   wallet,
   streak,
   session,
+  newAccount,
   initialTask,
   notices: notices2,
   sponsorServe,
@@ -5690,8 +5825,11 @@ function App({
       text: (cols >= MIN_BANNER_WIDTH ? welcomeBanner : compactBanner)({
         width: cols,
         name: config.login ?? config.email?.split("@")[0],
+        ...newAccount ? { newAccount: true } : {},
         model: config.model,
-        balance: wallet?.balance ?? 0,
+        // Undefined when the wallet could not be read: the banner says so
+        // rather than drawing "0 credits", which reads as an empty account.
+        balance: wallet?.balance,
         adsToday: wallet?.ads_today ?? 0,
         earnedUsdToday: wallet?.earned_usd_today ?? 0,
         maxRewardUsd: wallet?.max_reward_usd_per_day ?? 0,
@@ -5705,7 +5843,7 @@ function App({
   const [editor, setEditor] = useState(EMPTY);
   const [busy, setBusy] = useState(false);
   const [live, setLive] = useState(null);
-  const [balance, setBalance] = useState(wallet?.balance ?? 0);
+  const [balance, setBalance] = useState(wallet?.balance);
   const [spent, setSpent] = useState(0);
   const [freeTier, setFreeTier] = useState(wallet?.free_tier);
   const [model, setModel2] = useState(config.model);
@@ -5761,6 +5899,7 @@ function App({
   const pendingTaskRef = useRef(null);
   const pendingFreeRef = useRef([]);
   const pendingGrantRef = useRef(0);
+  const pendingBalanceRef = useRef(void 0);
   const mcpRef = useRef(McpHub.empty());
   const todosRef = useRef(new TodoList());
   const lastTurnRef = useRef(null);
@@ -5862,11 +6001,32 @@ function App({
     deltaBufRef.current = "";
   }, []);
   useEffect(() => dropDelta, [dropDelta]);
+  useEffect(() => {
+    if (wallet) return;
+    const ctl = new AbortController();
+    void client.wallet(ctl.signal).then((w) => {
+      setBalance((current) => current ?? w.balance);
+      setFreeTier((current) => current ?? w.free_tier);
+    }).catch(() => void 0);
+    return () => ctl.abort();
+  }, []);
   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(", ")}` });
+    if (!wallet) {
+      let host = config.gatewayUrl;
+      try {
+        host = new URL(config.gatewayUrl).host;
+      } catch {
+      }
+      push({
+        kind: "notice",
+        tone: "warn",
+        text: `  ${host} did not answer, so the balance is unknown for now. It fills in once a request gets through.`
+      });
+    }
     const streakLine = streak && streak.claimed ? streakLabel(streak) : null;
     if (streakLine) push({ kind: "notice", tone: "good", text: `  ${streakLine}` });
     const freeLine = freeTierNotice({ model: config.model, balance: wallet?.balance ?? 0, free: wallet?.free_tier });
@@ -5883,6 +6043,24 @@ function App({
     client.models().then((m) => {
       catalogRef.current = m;
       searchRef.current = client.capabilities?.web_search === true;
+      const successor = client.retiredModels[modelRef.current];
+      if (successor) {
+        const from = modelRef.current;
+        config.model = successor;
+        saveConfig(config);
+        switchModel(successor);
+        push({
+          kind: "notice",
+          text: `  ${from} was retired; now using its successor, ${successor}. /model picks another.`
+        });
+      }
+      const latest = client.latestCli;
+      if (latest && isNewerVersion(latest, VERSION)) {
+        push({
+          kind: "notice",
+          text: `  clixad ${latest} is out (you have ${VERSION}). Update with: npm install -g clixad@latest`
+        });
+      }
     }).catch(() => void 0);
   }, []);
   useEffect(() => {
@@ -6122,7 +6300,7 @@ function App({
             setSpent((s) => s + res.creditsCharged);
             push({
               kind: "notice",
-              text: `  compacted context: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged} credits)`
+              text: `  compacted context: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged.toLocaleString("en-US")} credits)`
             });
           }
         }
@@ -6231,19 +6409,29 @@ ${NO_SEARCH_INSTRUCTION}`),
           pendingTaskRef.current = { task, images };
           pendingFreeRef.current = err.freeModels;
           pendingGrantRef.current = err.grantPerAd;
+          pendingBalanceRef.current = err.balance;
           const free = err.freeModels[0];
           push({
             kind: "notice",
             tone: "warn",
-            text: free ? `  Out of credits on ${model2} (balance ${err.balance}, need ~${err.estimatedCost}).
+            text: free ? `  ${shortfallHeadline(err, model2)}
   Press enter \u2014 ${free.id} is still free today (~${free.turnsLeft} turn${free.turnsLeft === 1 ? "" : "s"} left), or take an offer instead.
   Your request is kept either way, so you will not have to type it again.
   Offers you are screened out of pay nothing; that is normal, just start another.
-  /buy is there too, if you would rather pay than do an offer.` : `  Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).
+  /buy is there too, if you would rather pay than do an offer.` : `  ${shortfallHeadline(err, model2)}
   Press enter to open the ad wall \u2014 offers pay ${grantLabel(err.grantPerAd)}.
   I'll continue automatically. Offers you are screened out of pay nothing;
   that is normal, just start another.
-  /buy is there too, if you would rather pay than do an offer.`
+` + // A wallet that is short rather than empty has a third way on,
+            // and it is the cheapest: the same credits on a smaller model.
+            // It names the command and no figure, since what a model costs
+            // is the gateway's to say and `/model` says it.
+            (err.balance > 0 ? `  Or pick a cheaper model with /model, which shows what each one costs.
+` : "") + // One clause, last, and it stays last. The wall is how this product
+            // is meant to be paid for and the offer is free; naming /buy here
+            // is discoverability rather than a pitch, and it is the moment
+            // somebody actually wants to know the command exists.
+            `  /buy is there too, if you would rather pay than do an offer.`
           });
         } else if (err instanceof AuthError) {
           push({ kind: "notice", tone: "error", text: NOT_SIGNED_IN });
@@ -6370,7 +6558,7 @@ ${NO_SEARCH_INSTRUCTION}`),
   const runAdWall = useCallback(async () => {
     const pending = pendingTaskRef.current;
     pendingTaskRef.current = null;
-    const before = balance;
+    let before = balance ?? (await client.wallet().catch(() => void 0))?.balance;
     const code = await client.handoffCode();
     const base = config.dashboardUrl.replace(/\/+$/, "");
     openBrowser(code ? `${base}/?c=${encodeURIComponent(code)}` : base);
@@ -6388,7 +6576,10 @@ ${NO_SEARCH_INSTRUCTION}`),
         await sleep4(3e3, signal);
         if (signal.aborted) break;
         const w = await client.wallet(signal).catch(() => void 0);
-        if (w && w.balance > before) {
+        if (w && before === void 0) {
+          before = w.balance;
+          setBalance(w.balance);
+        } else if (w && before !== void 0 && w.balance > before) {
           setBalance(w.balance);
           credited = true;
         }
@@ -6431,7 +6622,7 @@ ${NO_SEARCH_INSTRUCTION}`),
     ];
     setPickerSel(0);
     setPicker({
-      title: "Out of credits",
+      title: (pendingBalanceRef.current ?? 0) > 0 ? "Not enough credits" : "Out of credits",
       subtitle: "Pick a free model to carry on with, or earn credits at the wall.",
       items,
       onPick: (choice) => {
@@ -6482,7 +6673,7 @@ ${NO_SEARCH_INSTRUCTION}`),
   }, [client, push, runBusy]);
   const runCheckout = useCallback(
     async (pack) => {
-      const before = balance;
+      let before = balance ?? (await client.wallet().catch(() => void 0))?.balance;
       let credited = false;
       let stopped = false;
       await runBusy(WAITING_FOR_PAYMENT, async (signal) => {
@@ -6506,7 +6697,10 @@ ${NO_SEARCH_INSTRUCTION}`),
           await sleep4(3e3, signal);
           if (signal.aborted) break;
           const w = await client.wallet(signal).catch(() => void 0);
-          if (w && w.balance > before) {
+          if (w && before === void 0) {
+            before = w.balance;
+            setBalance(w.balance);
+          } else if (w && before !== void 0 && w.balance > before) {
             setBalance(w.balance);
             credited = true;
           }
@@ -6589,7 +6783,7 @@ ${NO_SEARCH_INSTRUCTION}`),
             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)`
+              text: `  compacted: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged.toLocaleString("en-US")} credits)`
             });
           });
           return;
@@ -7299,7 +7493,7 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   let estimate;
   const info = catalogRef.current.find((m) => m.id === model);
   const shape = client.taskShape;
-  if (!busy && info && shape && typed.trim() !== "" && !/^[/!]/.test(typed.trimStart())) {
+  if (!busy && info && shape && balance !== void 0 && typed.trim() !== "" && !/^[/!]/.test(typed.trimStart())) {
     const range = estimateTask(info, conversationUsed + schemaTokens + estimateTokens(typed), shape);
     const onFree = Boolean(info.free && freeTier?.models.includes(model));
     const verdict = taskVerdict(range, { balance, ...onFree ? { freeLeft: freeTier.credits_left } : {} });
@@ -7489,7 +7683,7 @@ function modelHint(m, free) {
 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}]`;
+  if (result.creditsWaived <= 0) return `[${n(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}]`;
@@ -7508,7 +7702,12 @@ function statusRow(o, estimate, cols) {
   const burn = o.spent > 0 && o.minutes >= 1 ? `${Math.round(o.spent / o.minutes).toLocaleString("en-US")} cr/min` : void 0;
   const clauses = [
     { text: o.model, rank: KEEP_ALWAYS },
-    { text: `${o.balance.toLocaleString("en-US")} cr`, rank: KEEP_ALWAYS },
+    {
+      // "? cr" rather than "0 cr": unknown is not empty, and an empty-looking
+      // wallet is the one misreading on this row that frightens somebody.
+      text: o.balance === void 0 ? "? cr" : `${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.
@@ -7746,7 +7945,7 @@ async function main() {
   for (const text of configNotices) console.error(c.yellow(text));
   switch (cmd) {
     case "login":
-      return login(client, config, rest);
+      return void await login(client, config, rest, { nextStep: true });
     case "logout":
       return logout(config);
     case "whoami":
@@ -7810,7 +8009,7 @@ async function main() {
       return repl(client, config, { task: [cmd, ...rest].join(" ").trim(), notices: configNotices });
   }
 }
-async function login(client, config, args) {
+async function login(client, config, args, opts = {}) {
   const parsed = parseLoginArgs(args);
   for (const line2 of TERMS_NOTICE.split("\n")) console.log(c.dim(`  ${line2}`));
   const outcome = await performLogin(client, config, parsed, {
@@ -7836,20 +8035,25 @@ async function login(client, config, args) {
       if (account.model) console.log(`  model: ${c.bold(account.model)} ${c.dim("(the default for new accounts)")}`);
       await showStreak(client);
       console.log(c.dim(`  token stored in ${configPath()}`));
-      return;
+      if (opts.nextStep) {
+        console.log(`
+  Next: open a project folder and run ${c.cyan("clixad")} to start coding.`);
+      }
+      return { created: account.created };
     }
     case "closed":
       reportSignupClosed(outcome.message, outcome.hadInvite);
       process.exitCode = 1;
-      return;
+      return void 0;
     case "timeout":
       console.log(c.red("\n  login timed out \u2014 run `clixad login` again."));
-      return;
+      return void 0;
     case "aborted":
-      return;
+      return void 0;
     default:
       console.log(c.red(`
   login failed: ${outcome.error}`));
+      return void 0;
   }
 }
 function reportSignupClosed(message, hadInvite) {
@@ -8051,7 +8255,7 @@ ${NO_SEARCH_INSTRUCTION}`),
   } catch (err) {
     if (err instanceof PaywallError) {
       console.log(c.yellow(`
-Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
+${shortfallHeadline(err, config.model)}`));
       const freeLine = freeAlternativeLine(err.freeModels);
       if (freeLine) console.log(c.green(freeLine));
       console.log(
@@ -8102,7 +8306,7 @@ async function codeCmd(client, config, rest) {
   const w = await safeWallet(client);
   if (w) {
     console.log(
-      c.dim(`  wallet: ${w.balance} credits \xB7 model ${config.model} \xB7 gateway ${config.gatewayUrl}`)
+      c.dim(`  wallet: ${credits(w.balance)} credits \xB7 model ${config.model} \xB7 gateway ${config.gatewayUrl}`)
     );
     if (w.balance <= 0) {
       console.log(c.yellow("  You're out of credits \u2014 run `clixad earn` first, or the agent will hit a paywall."));
@@ -8137,8 +8341,9 @@ async function repl(client, config, opts = {}) {
     console.log(c.yellow('Interactive mode needs a terminal. Use `clixad -p "..."` for scripted runs.'));
     return;
   }
+  let newAccount = false;
   if (!config.token) {
-    await login(client, config, []);
+    newAccount = Boolean((await login(client, config, []))?.created);
     if (!config.token) return;
   }
   let session;
@@ -8149,8 +8354,7 @@ async function repl(client, config, opts = {}) {
     session = loadSession(opts.resume);
     if (!session) return console.log(c.red(`no such session: ${opts.resume}`));
   }
-  const streak = await client.claimStreak();
-  const wallet = await safeWallet(client);
+  const { streak, wallet } = await startupReads(client, config.gatewayUrl);
   const cwd = process.cwd();
   const initHint = shouldSuggestInit(cwd) ? { returning: hasSessionIn(cwd) } : void 0;
   clearScreen();
@@ -8161,24 +8365,30 @@ async function repl(client, config, opts = {}) {
     wallet,
     streak,
     session,
+    newAccount,
     initialTask: opts.task,
     ...opts.notices?.length ? { notices: opts.notices } : {},
     ...initHint ? { initHint } : {}
   });
 }
 async function runTurn(client, config, messages) {
+  let started = false;
   try {
-    process.stdout.write(c.green("assistant ") + "");
     const result = await client.chatStream(messages, config.model, {
-      onDelta: (chunk) => process.stdout.write(chunk)
+      onDelta: (chunk) => {
+        if (!started) process.stdout.write(c.green("assistant "));
+        started = true;
+        process.stdout.write(chunk);
+      }
     });
+    if (!started) process.stdout.write(c.green("assistant "));
     process.stdout.write("\n");
-    console.log(c.dim(`  [${result.creditsCharged} credits \xB7 balance ${result.balance}]`));
+    console.log(c.dim(`  [${credits(result.creditsCharged)} credits \xB7 balance ${credits(result.balance)}]`));
     return result;
   } catch (err) {
-    process.stdout.write("\n");
+    if (started) process.stdout.write("\n");
     if (err instanceof PaywallError) {
-      console.log(c.yellow(`Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
+      console.log(c.yellow(shortfallHeadline(err, config.model)));
       const freeLine = freeAlternativeLine(err.freeModels);
       if (freeLine) console.log(c.green(freeLine));
       console.log(
@@ -8208,29 +8418,69 @@ async function safeWallet(client) {
     return void 0;
   }
 }
+var CONNECTING_AFTER_MS = 700;
+var WAKING_AFTER_MS = 6e3;
+async function startupReads(client, gatewayUrl) {
+  const host = (() => {
+    try {
+      return new URL(gatewayUrl).host;
+    } catch {
+      return gatewayUrl;
+    }
+  })();
+  const say = (text) => {
+    if (process.stdout.isTTY) console.log(c.dim(text));
+  };
+  const timers = [
+    setTimeout(() => say(`  connecting to ${host}\u2026`), CONNECTING_AFTER_MS),
+    setTimeout(
+      () => say("  still waiting: the server sleeps after a quiet spell and takes up to a minute to wake. ctrl+c cancels."),
+      WAKING_AFTER_MS
+    )
+  ];
+  try {
+    const [streak, wallet] = await Promise.all([client.claimStreak(), safeWallet(client)]);
+    const balance = streak?.claimed ? streak.balance : wallet?.balance;
+    return {
+      streak,
+      wallet: wallet && balance !== void 0 ? { ...wallet, balance } : wallet
+    };
+  } finally {
+    for (const t of timers) clearTimeout(t);
+  }
+}
 function printHelp() {
-  console.log(`${c.bold("clixad")} \u2014 free AI coding in your terminal, funded by ads
+  const rows = [
+    ["", "", "start the interactive coding agent here (signs you in if needed)"],
+    ['"<task>"', "", "the same, with a task already running"],
+    ["--continue", "", "resume the last session in this directory"],
+    ["--resume", "[id]", "list saved sessions, or resume one"],
+    ["-p", '"<task>"', "headless agent run (read-only tools)"],
+    ["ask", '"<prompt>"', "one-shot answer, no tools"],
+    ["models", "", "models with credit prices, and which are free today"],
+    ["model", "<id>", "set the default model"],
+    ["wallet", "", "balance, offers today, recent activity"],
+    ["earn", "", "open the offer wall to earn credits"],
+    ["refer", "", "your invite code, and what it has earned"],
+    ["redeem", "<code>", "spend a code you were given"],
+    ["login", "[email]", "sign in or create an account (--invite <code> if you have one)"],
+    ["logout", "", "forget the stored token"],
+    ["whoami", "", "account and balance"],
+    ["code", '["<task>"]', "launch the Kimi CLI coding agent on this directory"],
+    ["--version", "", "print the version and exit"]
+  ];
+  const plain = (name, arg) => `clixad${name ? ` ${name}` : ""}${arg ? ` ${arg}` : ""}`;
+  const width = Math.max(...rows.map(([name, arg]) => plain(name, arg).length)) + 2;
+  const lines = rows.map(([name, arg, desc]) => {
+    const shown = `${c.cyan("clixad")}${name ? ` ${c.cyan(name)}` : ""}${arg ? ` ${arg}` : ""}`;
+    return `  ${shown}${" ".repeat(width - plain(name, arg).length)}${desc}`;
+  });
+  console.log(`${c.bold("clixad")}: free AI coding in your terminal, funded by ads
 
-  ${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, and which are free today
-  ${c.cyan("model")} <id>        set default model
-  ${c.cyan("wallet")}            balance, ads today, ledger
-  ${c.cyan("earn")}              open the ad wall to earn credits
-  ${c.cyan("refer")}             your invite code, and what it has earned
-  ${c.cyan("redeem")} <code>     spend a code you were given
-  ${c.cyan("ask")} "<prompt>"    one-shot completion (no tools)
-  ${c.cyan("agent")} "<task>"    open the REPL with a task already running
-  ${c.cyan("-p")} "<task>"       headless agent run (read-only tools)
-  ${c.cyan("code")} ["<task>"]   launch the full Kimi CLI coding agent on the current dir
-  ${c.cyan("--continue")}        resume the last session in this directory
-  ${c.cyan("--resume")} [id]     list saved sessions, or resume one
-  ${c.cyan("--version")}         print the version and exit
-  (no command)        interactive coding REPL ${c.dim("(signs you in if needed)")}
-  "<task>"            same as ${c.cyan("agent")} \u2014 anything that is not a command is a task
+${lines.join("\n")}
 
-  ${c.dim("Discord: https://discord.gg/pwxPM3QyF \u2014 bugs and feature requests are read there")}`);
+  Inside the agent, ${c.cyan("/help")} lists everything else, including ${c.cyan("/buy")} for credit packs.
+  ${c.dim("Discord: https://discord.gg/pwxPM3QyF (bugs and feature requests are read there)")}`);
 }
 main().catch((err) => {
   console.error(c.red(err.message));

package/package.json

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