clixad 0.0.1-beta.21 → 0.0.1-beta.23

package/dist/clixad.mjs

@@ -14,6 +14,94 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/estimate.ts
+function parseTaskShape(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const r = raw;
+  const count = (v, min) => typeof v === "number" && Number.isFinite(v) && v >= min && v <= 1e6 ? Math.floor(v) : void 0;
+  const callsTypical = count(r.calls_typical, 1);
+  const callsLong = count(r.calls_long, 1);
+  const growthTokens = count(r.growth_tokens, 0);
+  const outputTokens = count(r.output_tokens, 0);
+  if (callsTypical === void 0 || callsLong === void 0) return void 0;
+  if (growthTokens === void 0 || outputTokens === void 0) return void 0;
+  if (callsLong < callsTypical) return void 0;
+  return { callsTypical, callsLong, growthTokens, outputTokens };
+}
+function callCredits(model, inputTokens, outputTokens) {
+  return Math.ceil(
+    (inputTokens * model.credits_per_mtoken_input + outputTokens * model.credits_per_mtoken_output) / 1e6
+  );
+}
+function taskCredits(model, contextTokens, calls, shape) {
+  const start = Math.max(0, Math.round(contextTokens));
+  let total = 0;
+  for (let i = 0; i < calls; i++) {
+    total += callCredits(model, start + i * shape.growthTokens, shape.outputTokens);
+  }
+  return total;
+}
+function estimateTask(model, contextTokens, shape) {
+  return {
+    low: taskCredits(model, contextTokens, shape.callsTypical, shape),
+    high: taskCredits(model, contextTokens, shape.callsLong, shape)
+  };
+}
+function taskVerdict(range, wallet) {
+  const free = Math.max(0, wallet.freeLeft ?? 0);
+  if (free > 0 && free >= range.high) return "free";
+  const available = Math.max(0, wallet.balance) + free;
+  if (available >= range.high) return "fits";
+  if (available >= range.low) return "tight";
+  return "short";
+}
+function shortCredits(n, direction) {
+  const round = direction === "down" ? Math.floor : Math.ceil;
+  if (n < 1e3) return String(Math.max(0, Math.round(n)));
+  if (n < 1e4) return `${trim(round(n / 100) / 10)}k`;
+  if (n < 1e6) return `${round(n / 1e3)}k`;
+  return `${trim(round(n / 1e5) / 10)}M`;
+}
+function trim(n) {
+  return Number.isInteger(n) ? String(n) : n.toFixed(1);
+}
+function estimateClause(range, verdict, freeElsewhere) {
+  const span = range.low === range.high ? shortCredits(range.high, "up") : `${shortCredits(range.low, "down")}\u2013${shortCredits(range.high, "up")}`;
+  const head = `task \u2248 ${span}`;
+  const tight = `\u2248${span}`;
+  switch (verdict) {
+    case "free":
+      return { variants: [`${head} \xB7 free`, `${tight} free`], warn: false };
+    case "fits":
+      return { variants: [`${head} cr`, `${tight} cr`], warn: false };
+    case "tight":
+      return { variants: [`${head} \xB7 may run short`, `${tight}, may run short`, `${tight} tight`], warn: true };
+    case "short":
+      return {
+        variants: [
+          `${head} \xB7 not enough, ${freeElsewhere ? "/model" : "/earn"}`,
+          `${tight}, not enough`,
+          `${tight} short`
+        ],
+        warn: true
+      };
+  }
+}
+var init_estimate = __esm({
+  "src/estimate.ts"() {
+    "use strict";
+  }
+});
+
+// src/sponsor/formats.ts
+var EXTRA_AD_FORMATS;
+var init_formats = __esm({
+  "src/sponsor/formats.ts"() {
+    "use strict";
+    EXTRA_AD_FORMATS = ["sidebar_card", "status_bar"];
+  }
+});
+
 // src/edge.ts
 function detectEdgeBlock(status, headers, body) {
   if (status !== 403) return void 0;
@@ -225,6 +313,17 @@ function redeemMessage(result) {
 function ledgerReasonLabel(reason) {
   return LEDGER_REASONS[reason] ?? reason.replace(/_/g, " ");
 }
+function extraFormatIds(raw) {
+  const out = {};
+  if (typeof raw !== "object" || raw === null) return out;
+  for (const format of EXTRA_AD_FORMATS) {
+    const entry = raw[format];
+    if (typeof entry !== "object" || entry === null) continue;
+    const id = entry.publisher_id;
+    if (typeof id === "string" && id.trim()) out[format] = id.trim();
+  }
+  return out;
+}
 function imagePart(image) {
   return { type: "image_url", image_url: { url: `data:${image.mimeType};base64,${image.data}` } };
 }
@@ -251,8 +350,47 @@ 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) {
-  return new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad);
+  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(() => "");
@@ -278,16 +416,16 @@ async function httpFailure(res, what) {
   return detail ? `${what} failed: ${res.status} \u2014 ${detail}` : `${what} failed: ${res.status}`;
 }
 function sleep(ms, signal) {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     if (!signal) {
-      setTimeout(resolve2, ms);
+      setTimeout(resolve3, ms);
       return;
     }
-    if (signal.aborted) return resolve2();
+    if (signal.aborted) return resolve3();
     const done = () => {
       clearTimeout(timer);
       signal.removeEventListener("abort", done);
-      resolve2();
+      resolve3();
     };
     const timer = setTimeout(done, ms);
     signal.addEventListener("abort", done, { once: true });
@@ -327,10 +465,12 @@ 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";
+    init_estimate();
+    init_formats();
     init_edge();
     CHAT_ENCODED_CONTENT_TYPE = "application/vnd.clixad.chat+gzip";
     LEDGER_REASONS = {
@@ -361,17 +501,46 @@ var init_client = __esm({
       waitlistUrl;
     };
     PaywallError = class extends Error {
-      constructor(balance, estimatedCost, grantPerAd) {
+      constructor(balance, estimatedCost, grantPerAd, freeModels = []) {
         super("Out of credits");
         this.balance = balance;
         this.estimatedCost = estimatedCost;
         this.grantPerAd = grantPerAd;
+        this.freeModels = freeModels;
         this.name = "PaywallError";
       }
       balance;
       estimatedCost;
       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.");
@@ -412,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 } : {} })
@@ -428,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)
         });
@@ -438,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 })
@@ -460,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()
           });
@@ -487,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 } : {}
@@ -522,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 } : {},
@@ -557,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 } : {}
         });
@@ -588,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 } : {},
@@ -609,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();
       }
@@ -620,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 } : {},
@@ -636,12 +805,46 @@ 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
+       * means no estimate is shown at all, the silence an older gateway gets.
+       */
+      get taskShape() {
+        return this.shape;
+      }
+      shape;
       /**
        * What the gateway said it can do, as of the last catalog fetch.
        *
@@ -657,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();
@@ -693,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 } : {}
           });
@@ -701,11 +904,13 @@ var init_client = __esm({
           const body = await res.json();
           const publisherId = typeof body.publisher_id === "string" ? body.publisher_id.trim() : "";
           if (!publisherId) return null;
+          const formats = extraFormatIds(body.formats);
           return {
             publisherId,
             ...typeof body.category === "string" ? { category: body.category } : {},
             ...typeof body.subject === "string" ? { subject: body.subject } : {},
-            ...typeof body.dwell_ms === "number" ? { dwellMs: body.dwell_ms } : {}
+            ...typeof body.dwell_ms === "number" ? { dwellMs: body.dwell_ms } : {},
+            ...Object.keys(formats).length > 0 ? { formats } : {}
           };
         } catch {
           return null;
@@ -729,12 +934,13 @@ 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 } : {},
             body: JSON.stringify({
               impression_id: report.impressionId,
+              ...report.format && report.format !== "top_bar" ? { format: report.format } : {},
               ...report.adId ? { ad_id: report.adId } : {},
               billable: report.billable,
               from_cache: report.fromCache,
@@ -761,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 } : {}
         });
@@ -801,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,
@@ -1132,12 +1338,13 @@ function saveConfig(config) {
 function configPath() {
   return CONFIG_PATH;
 }
-var CONFIG_PATH, QUARANTINE_PATH, DEFAULTS, ENV_OVERRIDES, SUPERSEDED_DEFAULTS, IDENTITY_KEYS, baseline, envApplied, notices;
+var CONFIG_PATH, QUARANTINE_PATH, FALLBACK_MODEL, DEFAULTS, ENV_OVERRIDES, SUPERSEDED_DEFAULTS, IDENTITY_KEYS, baseline, envApplied, notices;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
     CONFIG_PATH = join(homedir(), ".clixad", "config.json");
     QUARANTINE_PATH = `${CONFIG_PATH}.corrupt`;
+    FALLBACK_MODEL = "gemini-2.5-flash-lite";
     DEFAULTS = {
       gatewayUrl: "https://clixad.onrender.com",
       // Same origin as the gateway: the ad wall is served by the gateway process
@@ -1145,7 +1352,7 @@ var init_config = __esm({
       // fields stay separate so either can be pointed elsewhere, but they no longer
       // diverge by default.
       dashboardUrl: "https://clixad.onrender.com",
-      model: "gemini-2.5-flash-lite"
+      model: FALLBACK_MODEL
     };
     ENV_OVERRIDES = [
       ["gatewayUrl", "CLIXAD_GATEWAY_URL"],
@@ -1188,6 +1395,12 @@ function parseLoginArgs(args) {
   }
   return { invite: invite?.trim() || void 0, email: rest[0] };
 }
+function adoptNewAccountModel(config, created, named) {
+  if (!created || typeof named !== "string" || !/^[A-Za-z0-9._\/-]{1,64}$/.test(named)) return void 0;
+  if (config.model !== FALLBACK_MODEL || named === config.model) return void 0;
+  config.model = named;
+  return named;
+}
 async function performLogin(client, config, args, report, signal) {
   if (!args.email) {
     const start = await client.deviceStart().catch(() => null);
@@ -1218,6 +1431,7 @@ async function githubLogin(client, config, start, invite, report, signal) {
       config.email = poll.email;
       config.login = poll.login;
       config.tokenGateway = config.gatewayUrl;
+      const model = adoptNewAccountModel(config, poll.created, poll.default_model);
       saveConfig(config);
       return {
         status: "ok",
@@ -1226,7 +1440,8 @@ async function githubLogin(client, config, start, invite, report, signal) {
           login: poll.login,
           balance: poll.balance,
           created: poll.created,
-          signupBonus: poll.signupBonus
+          signupBonus: poll.signupBonus,
+          ...model ? { model } : {}
         }
       };
     }
@@ -1249,20 +1464,24 @@ async function devLogin(client, config, email, invite) {
   config.email = res.email;
   config.tokenGateway = config.gatewayUrl;
   delete config.login;
+  const model = adoptNewAccountModel(config, true, res.default_model);
   saveConfig(config);
-  return { status: "ok", account: { email: res.email, balance: res.balance, created: true } };
+  return {
+    status: "ok",
+    account: { email: res.email, balance: res.balance, created: true, ...model ? { model } : {} }
+  };
 }
 function sleep2(ms, signal) {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     if (!signal) {
-      setTimeout(resolve2, ms);
+      setTimeout(resolve3, ms);
       return;
     }
-    if (signal.aborted) return resolve2();
+    if (signal.aborted) return resolve3();
     const done = () => {
       clearTimeout(timer);
       signal.removeEventListener("abort", done);
-      resolve2();
+      resolve3();
     };
     const timer = setTimeout(done, ms);
     signal.addEventListener("abort", done, { once: true });
@@ -1283,6 +1502,49 @@ and the Privacy Policy \u2014 ${PRIVACY_URL}`;
   }
 });
 
+// src/free-tier.ts
+function freeModelToName(free, current) {
+  const left = (id2) => free.turns_left[id2] ?? 0;
+  const usable = (id2) => id2 !== void 0 && free.models.includes(id2) && left(id2) > 0;
+  const id = usable(current) ? current : usable(free.recommended) ? free.recommended : free.models.find(usable);
+  return id === void 0 ? void 0 : { id, turns: left(id) };
+}
+function freeTierNotice(o) {
+  const free = o.free;
+  if (!free || !(free.daily_credits > 0)) return void 0;
+  const pick = free.credits_left > 0 ? freeModelToName(free, o.model) : void 0;
+  if (!pick) {
+    return o.balance <= 0 ? "Your balance is empty and today's free turns are used up. They come back at midnight UTC, and /earn tops up before then." : void 0;
+  }
+  if (pick.id === o.model) {
+    return `${pick.id} is free today, ${turns(pick.turns)} left. /model shows the other free models.`;
+  }
+  if (o.balance <= 0) {
+    return `Your balance is empty, but ${pick.id} is still free today (${turns(pick.turns)}). /model switches to it, /earn tops up.`;
+  }
+  return `${free.models.length} models are free today. /model switches, and ${pick.id} has ${turns(pick.turns)} left.`;
+}
+function freeHelpLine(free) {
+  if (!free || !(free.daily_credits > 0)) return void 0;
+  if (free.credits_left <= 0) return { label: "free models", desc: "used up today, back at midnight UTC" };
+  return {
+    label: "free today",
+    desc: `${free.models.length} models, ${free.credits_left.toLocaleString("en-US")} free credits left \xB7 /model switches`
+  };
+}
+function freeAlternativeLine(freeModels, { rerun = true } = {}) {
+  const first = freeModels.find((m) => m.turnsLeft > 0);
+  if (!first) return void 0;
+  return `${first.id} is still free today (${turns(first.turnsLeft)}). Switch with \`clixad model ${first.id}\`${rerun ? " and run it again" : ""}.`;
+}
+var turns;
+var init_free_tier = __esm({
+  "src/free-tier.ts"() {
+    "use strict";
+    turns = (n) => `about ${n.toLocaleString("en-US")} turn${n === 1 ? "" : "s"}`;
+  }
+});
+
 // src/diff.ts
 function splitLines(text) {
   const lines = text.split("\n");
@@ -2381,7 +2643,7 @@ var init_mcp = __esm({
         if (this.exited) return Promise.reject(new McpError(this.exited));
         const id = ++this.seq;
         const payload = JSON.stringify({ jsonrpc: "2.0", id, method, params }) + "\n";
-        return new Promise((resolve2, reject) => {
+        return new Promise((resolve3, reject) => {
           const settle = (fn) => {
             clearTimeout(timer);
             signal?.removeEventListener("abort", onAbort);
@@ -2395,7 +2657,7 @@ var init_mcp = __esm({
           const onAbort = () => settle(() => reject(new McpError("cancelled")));
           signal?.addEventListener("abort", onAbort, { once: true });
           this.pending.set(id, {
-            resolve: (v) => settle(() => resolve2(v)),
+            resolve: (v) => settle(() => resolve3(v)),
             reject: (e) => settle(() => reject(e))
           });
           this.child.stdin?.write(payload, (err) => {
@@ -3989,7 +4251,7 @@ var init_agent = __esm({
 import { spawnSync } from "node:child_process";
 import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync4 } from "node:fs";
 import { homedir as homedir3, platform } from "node:os";
-import { join as join4 } from "node:path";
+import { join as join4, parse, resolve as resolve2 } from "node:path";
 function contextFileCandidates(root) {
   return [join4(homedir3(), ".clixad", "CLIXAD.md"), join4(root, "AGENTS.md"), join4(root, "CLIXAD.md")];
 }
@@ -4050,13 +4312,21 @@ function topLevel(root) {
     return void 0;
   }
 }
-var MAX_CONTEXT_FILE_CHARS, INIT_PROMPT;
+function shouldSuggestInit(root) {
+  const dir = resolve2(root);
+  if (dir === resolve2(homedir3()) || dir === parse(dir).root) return false;
+  if (existsSync3(join4(dir, "CLIXAD.md")) || existsSync3(join4(dir, "AGENTS.md"))) return false;
+  return PROJECT_MARKERS.some((name) => existsSync3(join4(dir, name)));
+}
+var MAX_CONTEXT_FILE_CHARS, INIT_PROMPT, INIT_HINT, PROJECT_MARKERS;
 var init_context = __esm({
   "src/context.ts"() {
     "use strict";
     init_agent();
     MAX_CONTEXT_FILE_CHARS = 2e4;
     INIT_PROMPT = "Create a CLIXAD.md file in the workspace root that tells a future coding agent how to work in this project. Explore the repository first (glob, grep, read the README and package manifests). Keep it under 60 lines and cover: what the project is, the layout, how to build/test/run it, and the conventions a newcomer would otherwise get wrong. If CLIXAD.md already exists, improve it instead of replacing it wholesale.";
+    INIT_HINT = "No CLIXAD.md in this project yet. /init writes one, and every later session here starts out knowing the layout.";
+    PROJECT_MARKERS = [".git", "package.json", "pyproject.toml", "Cargo.toml", "go.mod", "pom.xml", "Gemfile"];
   }
 });
 
@@ -4150,7 +4420,18 @@ var init_permissions = __esm({
 });
 
 // src/session.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readdirSync as readdirSync3, readFileSync as readFileSync5, rmSync, statSync as statSync2, writeFileSync as writeFileSync3 } from "node:fs";
+import {
+  closeSync as closeSync2,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync3,
+  openSync as openSync2,
+  readdirSync as readdirSync3,
+  readFileSync as readFileSync5,
+  readSync,
+  rmSync,
+  statSync as statSync2,
+  writeFileSync as writeFileSync3
+} from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import { join as join5 } from "node:path";
 function newSessionId() {
@@ -4187,6 +4468,28 @@ function listSessions(cwd, limit = 20) {
   metas.sort((a, b) => b.updated.localeCompare(a.updated));
   return metas.slice(0, limit);
 }
+function hasSessionIn(cwd) {
+  if (!existsSync4(SESSION_DIR)) return false;
+  const needle = `"cwd":${JSON.stringify(cwd)}`;
+  try {
+    for (const name of readdirSync3(SESSION_DIR)) {
+      if (!name.endsWith(".json")) continue;
+      const path = join5(SESSION_DIR, name);
+      let head = "";
+      const fd = openSync2(path, "r");
+      try {
+        const buf = Buffer.alloc(4096);
+        head = buf.subarray(0, readSync(fd, buf, 0, buf.length, 0)).toString("utf8");
+      } finally {
+        closeSync2(fd);
+      }
+      if (head.includes(needle)) return true;
+      if (!head.includes('"cwd":') && loadSession(name.slice(0, -5))?.cwd === cwd) return true;
+    }
+  } catch {
+  }
+  return false;
+}
 function latestSession(cwd) {
   const [meta] = listSessions(cwd, 1);
   return meta ? loadSession(meta.id) : void 0;
@@ -4284,14 +4587,14 @@ function runKimiCode(config, task, opts = {}) {
     OPENAI_BASE_URL: `${config.gatewayUrl.replace(/\/+$/, "")}/v1`,
     OPENAI_API_KEY: config.token
   };
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     const child = process.platform === "win32" ? spawn5([bin, ...args].map(quoteWin).join(" "), { stdio: "inherit", env, shell: true }) : spawn5(bin, args, { stdio: "inherit", env });
     child.on("error", (err) => {
       if (err.code === "ENOENT") console.log("\n" + INSTALL_HELP);
       else console.error(`failed to launch Kimi CLI: ${err.message}`);
-      resolve2(127);
+      resolve3(127);
     });
-    child.on("exit", (code) => resolve2(code ?? 0));
+    child.on("exit", (code) => resolve3(code ?? 0));
   });
 }
 function quoteWin(s) {
@@ -4312,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).
@@ -4372,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`;
 }
@@ -4381,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);
@@ -4407,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 = [];
@@ -4426,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);
@@ -4562,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"() {
@@ -4804,6 +5154,16 @@ function sponsorEnabled({ isTTY, env, configEnabled }) {
 function adFitsWidth(cols) {
   return cols >= AD_MIN_COLS;
 }
+function adFitsFormat(format, cols) {
+  return format === "sidebar_card" ? cols >= SIDEBAR_MIN_COLS : adFitsWidth(cols);
+}
+function sidebarCard(line2, cols) {
+  if (!adFitsFormat("sidebar_card", cols)) return null;
+  const text = line2.trim();
+  if (!text) return null;
+  const body = visibleLength(text) <= SIDEBAR_BODY_COLS ? text : `${sliceColumns(text, SIDEBAR_BODY_COLS - 1).trimEnd()}\u2026`;
+  return { rule: SIDEBAR_RULE, label: `${SPONSOR_SIGIL} ${AD_LABEL}`, body };
+}
 function sponsorRow(line2, cols, origin) {
   const marker = origin === "house" || cols >= AD_FULL_PREFIX_MIN_COLS ? HOUSE_MARKER_ROW : AD_MARKER_ROW;
   const label = origin === "network" ? LABEL_ROW : null;
@@ -4818,7 +5178,7 @@ function adColorEnabled({ isTTY, env }) {
   if (env.CI !== void 0 && env.CI !== "") return false;
   return true;
 }
-var SPONSOR_SIGIL, SPONSOR_MARKER, AD_LABEL, INDENT, HOUSE_MARKER_ROW, AD_MARKER_ROW, LABEL_ROW, MIN_BODY_COLS, SHORT_AD_COLS, AD_MIN_COLS, AD_FULL_PREFIX_MIN_COLS;
+var SPONSOR_SIGIL, SPONSOR_MARKER, AD_LABEL, INDENT, HOUSE_MARKER_ROW, AD_MARKER_ROW, LABEL_ROW, MIN_BODY_COLS, SHORT_AD_COLS, AD_MIN_COLS, AD_FULL_PREFIX_MIN_COLS, SIDEBAR_BODY_COLS, SIDEBAR_RULE, SIDEBAR_CARD_COLS, SIDEBAR_MIN_COLS;
 var init_render = __esm({
   "src/sponsor/render.ts"() {
     "use strict";
@@ -4835,6 +5195,10 @@ var init_render = __esm({
     SHORT_AD_COLS = 29;
     AD_MIN_COLS = visibleLength(AD_MARKER_ROW) + visibleLength(LABEL_ROW) + SHORT_AD_COLS;
     AD_FULL_PREFIX_MIN_COLS = visibleLength(HOUSE_MARKER_ROW) + visibleLength(LABEL_ROW) + SHORT_AD_COLS;
+    SIDEBAR_BODY_COLS = SHORT_AD_COLS + 9;
+    SIDEBAR_RULE = "\u2502 ";
+    SIDEBAR_CARD_COLS = visibleLength(SIDEBAR_RULE) + SIDEBAR_BODY_COLS;
+    SIDEBAR_MIN_COLS = 50 + SIDEBAR_CARD_COLS;
   }
 });
 
@@ -4845,7 +5209,7 @@ function sponsorLineText(ad) {
   if (!text) return void 0;
   return text.length > MAX_TEXT_CHARS3 ? text.slice(0, MAX_TEXT_CHARS3).trimEnd() : text;
 }
-function createSponsorSlot(config) {
+function createSponsorSlot(config, format = "top_bar") {
   const slot = new SponsorSlot({
     publisherId: config.publisherId,
     serveOnly: true,
@@ -4868,7 +5232,7 @@ function createSponsorSlot(config) {
   });
   return {
     async serve(cols, signal) {
-      if (!adFitsWidth(cols)) return null;
+      if (!adFitsFormat(format, cols)) return null;
       const ad = await slot.next({
         ...config.subject ? { subject: config.subject } : {},
         ...isCategory(config.category) ? { category: config.category } : {}
@@ -4900,9 +5264,11 @@ var init_network = __esm({
 function commandLabel(c2) {
   return `/${c2.name}${c2.args ? ` ${c2.args}` : ""}`;
 }
-function helpText() {
-  const w = Math.max(...COMMANDS.map((c2) => commandLabel(c2).length));
-  return COMMANDS.map((c2) => `  ${commandLabel(c2).padEnd(w + 2)}${c2.desc}`).join("\n") + "\n\n" + [
+function helpText(free) {
+  const w = Math.max(...COMMANDS.map((c2) => commandLabel(c2).length), free ? free.label.length : 0);
+  return (free ? `  ${free.label.padEnd(w + 2)}${free.desc}
+
+` : "") + COMMANDS.map((c2) => `  ${commandLabel(c2).padEnd(w + 2)}${c2.desc}`).join("\n") + "\n\n" + [
     "  @path        attach a file to the message (tab completes)",
     "  !command     run a shell command yourself, no model call",
     "  shift+tab    cycle permission mode \xB7 esc  stop the current turn",
@@ -5387,7 +5753,7 @@ var init_views = __esm({
 // src/tui/app.tsx
 import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Box as Box2, Static, Text as Text2, useApp, useInput, usePaste, useStdout } from "ink";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function buyDeclarationLines(pack) {
   return [
     `${pack.label} \u2014 ${pack.credits.toLocaleString("en-US")} credits for $${pack.price_usd.toFixed(2)}`,
@@ -5430,7 +5796,19 @@ function useTerminalSize() {
   }, [stdout]);
   return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
 }
-function App({ client, config, wallet, streak, session, initialTask, notices: notices2, sponsorServe }) {
+function App({
+  client,
+  config,
+  wallet,
+  streak,
+  session,
+  newAccount,
+  initialTask,
+  notices: notices2,
+  sponsorServe,
+  sponsorFormats,
+  initHint
+}) {
   const { exit } = useApp();
   const { stdout, write: writeToStdout } = useStdout();
   const idRef = useRef(1);
@@ -5447,8 +5825,11 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
       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,
@@ -5462,11 +5843,16 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   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);
+  const modelRef = useRef(config.model);
   const [mode, setMode] = useState("normal");
+  const switchModel = useCallback((id) => {
+    modelRef.current = id;
+    setModel2(id);
+  }, []);
   const [hist, setHist] = useState(() => loadHistory());
   const [histIdx, setHistIdx] = useState(-1);
   const [sel, setSel] = useState(0);
@@ -5480,7 +5866,12 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   const [startedAt, setStartedAt] = useState(0);
   const [quitHint, setQuitHint] = useState(false);
   const [busyLabel, setBusyLabel] = useState(WORKING);
-  const [sponsor, setSponsor] = useState(null);
+  const [sponsor, setSponsor] = useState(
+    null
+  );
+  const [adSlots, setAdSlots] = useState(
+    {}
+  );
   const messagesRef = useRef(messages);
   messagesRef.current = messages;
   const busyRef = useRef(false);
@@ -5506,10 +5897,16 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   const spinnerRef = useRef(spinnerFrames());
   const runningToolRef = useRef(null);
   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);
   const freeSpentNoticeRef = useRef(false);
+  const emptyNoticeRef = useRef(false);
+  const initHintedRef = useRef(false);
+  const sessionTurnsRef = useRef(0);
   const turnCountRef = useRef(config.turns ?? 0);
   const deltaBufRef = useRef("");
   const deltaTimerRef = useRef(null);
@@ -5517,36 +5914,54 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   const sponsorIdxRef = useRef(0);
   const sponsorPrevRef = useRef(void 0);
   const sponsorCallRef = useRef(0);
-  const pendingImpressionRef = useRef(null);
-  const sponsorSlotRef = useRef(null);
+  const pendingImpressionRef = useRef(/* @__PURE__ */ new Map());
+  const drawnRef = useRef(/* @__PURE__ */ new Set());
+  const sponsorSlotRef = useRef(
+    /* @__PURE__ */ new Map()
+  );
   const colsRef = useRef(cols);
   colsRef.current = cols;
+  const modalOpenRef = useRef(false);
   const sponsorConfigRef = useRef(null);
-  const remoteSponsorRef = useRef(
-    adtentionSource(async (signal) => {
-      let served;
-      if (sponsorServe) {
-        served = await sponsorServe(colsRef.current, signal);
-      } else {
-        sponsorConfigRef.current ??= client.sponsorConfig(signal);
-        const conf = await sponsorConfigRef.current;
-        if (!conf) return null;
-        sponsorSlotRef.current ??= createSponsorSlot(conf);
-        served = await sponsorSlotRef.current.serve(colsRef.current, signal);
+  const serveFormat = async (format, signal) => {
+    let served;
+    if (sponsorServe) {
+      if (format !== "top_bar" && !sponsorFormats?.includes(format)) return null;
+      served = await sponsorServe(colsRef.current, signal, format);
+    } else {
+      sponsorConfigRef.current ??= client.sponsorConfig(signal);
+      const conf = await sponsorConfigRef.current;
+      if (!conf) return null;
+      const publisherId = format === "top_bar" ? conf.publisherId : conf.formats?.[format];
+      if (!publisherId) return null;
+      let slot = sponsorSlotRef.current.get(format);
+      if (!slot) {
+        slot = createSponsorSlot({ ...conf, publisherId }, format);
+        sponsorSlotRef.current.set(format, slot);
       }
-      if (!served) return null;
-      return {
-        id: served.id,
-        text: served.text,
-        impression: {
-          impressionId: served.impressionId,
-          adId: served.id,
-          billable: served.billable,
-          fromCache: served.fromCache,
-          credit: served.credit
-        }
-      };
-    })
+      served = await slot.serve(colsRef.current, signal);
+    }
+    if (!served) return null;
+    return {
+      id: served.id,
+      text: served.text,
+      impression: {
+        impressionId: served.impressionId,
+        ...format === "top_bar" ? {} : { format },
+        adId: served.id,
+        billable: served.billable,
+        fromCache: served.fromCache,
+        credit: served.credit
+      }
+    };
+  };
+  const remoteSponsorRef = useRef(
+    Object.fromEntries(
+      ["top_bar", ...EXTRA_AD_FORMATS].map((format) => [
+        format,
+        adtentionSource((signal) => serveFormat(format, signal))
+      ])
+    )
   );
   const tallyRef = useRef(createTally());
   const heightCacheRef = useRef(/* @__PURE__ */ new Map());
@@ -5586,19 +6001,66 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
     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 });
+    if (freeLine) {
+      push({ kind: "notice", tone: (wallet?.balance ?? 0) <= 0 ? "warn" : "good", text: `  ${freeLine}` });
+    }
     if (session?.messages.length) {
       push({ kind: "notice", text: `  resumed session ${session.id} (${session.messages.length} messages)` });
     }
+    if (initHint?.returning) {
+      initHintedRef.current = true;
+      push({ kind: "notice", text: `  ${INIT_HINT}` });
+    }
     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(() => {
@@ -5645,6 +6107,7 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
         configEnabled: config.sponsor
       })) {
         setSponsor(null);
+        setAdSlots({});
         return;
       }
       const est = catalogRef.current.find((m) => m.id === modelId)?.est_ads_per_task;
@@ -5660,31 +6123,47 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
       } else {
         setSponsor(null);
       }
-      if (!adFitsWidth(colsRef.current)) return;
-      void remoteSponsorRef.current.fetch().then((line2) => {
-        if (!line2 || call !== sponsorCallRef.current) return;
-        if (!sponsorRow(line2.text, colsRef.current, "network")) return;
-        sponsorPrevRef.current = line2.id;
-        recordImpression(tallyRef.current, line2.id);
-        setSponsor({ text: line2.text, origin: "network" });
-        pendingImpressionRef.current = { call, impression: line2.impression };
-      });
+      for (const format of ["top_bar", ...EXTRA_AD_FORMATS]) {
+        if (!adFitsFormat(format, colsRef.current)) continue;
+        void remoteSponsorRef.current[format].fetch().then((line2) => {
+          if (!line2 || call !== sponsorCallRef.current) return;
+          if (!adFitsFormat(format, colsRef.current)) return;
+          if (format !== "top_bar" && modalOpenRef.current) return;
+          if (format === "top_bar") {
+            if (!sponsorRow(line2.text, colsRef.current, "network")) return;
+            sponsorPrevRef.current = line2.id;
+            setSponsor({ text: line2.text, origin: "network", impressionId: line2.impression.impressionId });
+          } else {
+            setAdSlots((slots) => ({
+              ...slots,
+              [format]: { text: line2.text, impressionId: line2.impression.impressionId }
+            }));
+          }
+          recordImpression(tallyRef.current, line2.id);
+          pendingImpressionRef.current.set(format, { call, impression: line2.impression });
+        });
+      }
     },
     [config.sponsor, stdout, wallet]
   );
   const reportSponsor = useCallback(() => {
-    const pending = pendingImpressionRef.current;
-    pendingImpressionRef.current = null;
-    if (!pending || pending.call !== sponsorCallRef.current) return;
-    void client.reportImpression(pending.impression);
+    const pending = [...pendingImpressionRef.current.values()];
+    const drawn = drawnRef.current;
+    pendingImpressionRef.current = /* @__PURE__ */ new Map();
+    drawnRef.current = /* @__PURE__ */ new Set();
+    const reports = pending.filter((p) => p.call === sponsorCallRef.current).filter((p) => drawn.has(p.impression.impressionId)).map((p) => p.impression);
+    if (reports.length === 0) return;
+    void (async () => {
+      for (const report of reports) await client.reportImpression(report);
+    })();
   }, [client]);
   const askUser = useCallback(
-    (req) => new Promise((resolve2) => setAsk({ req, resolve: resolve2 })),
+    (req) => new Promise((resolve3) => setAsk({ req, resolve: resolve3 })),
     []
   );
   const permit = useMemo(() => createPermit(() => permRef.current, askUser), [askUser]);
   const approvePlan = useCallback(
-    (proposed) => new Promise((resolve2) => {
+    (proposed) => new Promise((resolve3) => {
       setPlan({
         plan: proposed,
         resolve: (decision) => {
@@ -5692,7 +6171,7 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
             permRef.current.mode = decision;
             setMode(decision);
           }
-          resolve2(decision);
+          resolve3(decision);
         }
       });
     }),
@@ -5704,7 +6183,7 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
     setMode(next);
   }, []);
   const askQuestion = useCallback(
-    (req) => new Promise((resolve2) => {
+    (req) => new Promise((resolve3) => {
       setPickerSel(0);
       setPicker({
         title: req.question,
@@ -5716,10 +6195,10 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
         })),
         onPick: (choice) => {
           push({ kind: "notice", tone: "good", text: `  answered: ${choice.value}` });
-          resolve2(choice.value);
+          resolve3(choice.value);
         },
         onCancel: () => {
-          resolve2("nothing \u2014 the user dismissed the question. Do not ask it again.");
+          resolve3("nothing \u2014 the user dismissed the question. Do not ask it again.");
           stopCurrent();
         }
       });
@@ -5798,17 +6277,19 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   );
   const runTurn2 = useCallback(
     async (task, images = []) => {
+      pendingFreeRef.current = [];
+      const model2 = modelRef.current;
       const ac = new AbortController();
       abortRef.current = ac;
       setBusy(true);
       setStartedAt(Date.now());
       setLive({ text: "" });
-      nextSponsor(model);
+      nextSponsor(model2);
       let history = messagesRef.current;
       try {
-        const window = contextWindow(model);
+        const window = contextWindow(model2);
         if (shouldCompact([{ role: "system", content: contextRef.current.systemPrompt }, ...history], window)) {
-          const res = await compact(client, model, [
+          const res = await compact(client, model2, [
             { role: "system", content: contextRef.current.systemPrompt },
             ...history
           ], { signal: ac.signal });
@@ -5819,12 +6300,12 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
             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)`
             });
           }
         }
         const result = await runAgent(client, task, {
-          model,
+          model: model2,
           root,
           history,
           attachments: images,
@@ -5866,7 +6347,7 @@ ${NO_SEARCH_INSTRUCTION}`),
           started: sessionRef.current.started,
           updated: (/* @__PURE__ */ new Date()).toISOString(),
           cwd: root,
-          model,
+          model: model2,
           title: sessionRef.current.title,
           messages: next
         });
@@ -5882,8 +6363,10 @@ ${NO_SEARCH_INSTRUCTION}`),
             text: result.content,
             meta: turnMeta(result)
           });
-          if (freeTier?.models.includes(model) && result.creditsWaived === 0 && result.creditsCharged > 0 && (result.freeCreditsLeft ?? freeTier.credits_left) === 0 && !freeSpentNoticeRef.current) {
+          let spentNotice = false;
+          if (freeTier?.models.includes(model2) && result.creditsWaived === 0 && result.creditsCharged > 0 && (result.freeCreditsLeft ?? freeTier.credits_left) === 0 && !freeSpentNoticeRef.current) {
             freeSpentNoticeRef.current = true;
+            spentNotice = true;
             push({
               kind: "notice",
               tone: "warn",
@@ -5891,9 +6374,18 @@ ${NO_SEARCH_INSTRUCTION}`),
   The free allowance resets at midnight UTC. /earn tops up before then.`
             });
           }
+          if (result.creditsCharged > 0 && result.balance <= 0 && !spentNotice && !emptyNoticeRef.current) {
+            emptyNoticeRef.current = true;
+            const on = model2;
+            void client.wallet().then((w) => {
+              setFreeTier(w.free_tier);
+              const line2 = freeTierNotice({ model: on, balance: w.balance, free: w.free_tier });
+              if (line2) push({ kind: "notice", tone: "warn", text: `  ${line2}` });
+            }).catch(() => void 0);
+          }
           lastTurnRef.current = {
             turn: turnCountRef.current,
-            model,
+            model: model2,
             prompt: task,
             response: result.content,
             steps: result.steps,
@@ -5906,18 +6398,40 @@ ${NO_SEARCH_INSTRUCTION}`),
           turnCountRef.current += 1;
           config.turns = turnCountRef.current;
           saveConfig(config);
+          sessionTurnsRef.current += 1;
+          if (initHint && !initHintedRef.current && sessionTurnsRef.current >= INIT_HINT_AFTER_TURNS && shouldSuggestInit(root)) {
+            initHintedRef.current = true;
+            push({ kind: "notice", text: `  ${INIT_HINT}` });
+          }
         }
       } catch (err) {
         if (err instanceof PaywallError) {
           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: `  Out of credits (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.` : `  ${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 });
@@ -5932,6 +6446,7 @@ ${NO_SEARCH_INSTRUCTION}`),
         reportSponsor();
         sponsorCallRef.current++;
         setSponsor(null);
+        setAdSlots({});
       }
     },
     [
@@ -6002,10 +6517,21 @@ ${NO_SEARCH_INSTRUCTION}`),
               tone: "good",
               text: `  signed in as ${account.login ?? account.email ?? "you"} \xB7 balance ${account.balance.toLocaleString("en-US")} credits` + (account.created ? " (signup bonus)" : "")
             });
+            if (account.model) {
+              switchModel(account.model);
+              push({ kind: "notice", text: `  model \u2192 ${account.model} (the default for new accounts)` });
+            }
             const claimed = await client.claimStreak(signal);
             const line2 = claimed?.claimed ? streakLabel(claimed) : null;
             if (claimed?.claimed) setBalance(claimed.balance);
             if (line2) push({ kind: "notice", tone: "good", text: `  ${line2}` });
+            const w = await client.wallet(signal).catch(() => void 0);
+            if (w) {
+              setBalance(w.balance);
+              setFreeTier(w.free_tier);
+              const freeLine = freeTierNotice({ model: modelRef.current, balance: w.balance, free: w.free_tier });
+              if (freeLine) push({ kind: "notice", tone: w.balance <= 0 ? "warn" : "good", text: `  ${freeLine}` });
+            }
             return;
           }
           case "closed":
@@ -6032,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);
@@ -6050,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;
         }
@@ -6073,6 +6602,46 @@ ${NO_SEARCH_INSTRUCTION}`),
     push({ kind: "notice", tone: "good", text: "  credits added \u2014 continuing" });
     if (pending) await runTurn2(pending.task, pending.images);
   }, [balance, client, config.dashboardUrl, push, runBusy, runTurn2]);
+  const runPaywallChoice = useCallback(() => {
+    const free = pendingFreeRef.current.filter((m) => m.id !== EARN_ROW);
+    if (free.length === 0) return void runAdWall();
+    const items = [
+      ...free.map((m) => ({
+        value: m.id,
+        label: m.id,
+        hint: `free: ~${m.turnsLeft} turn${m.turnsLeft === 1 ? "" : "s"} left today`,
+        current: m.id === model
+      })),
+      {
+        value: EARN_ROW,
+        label: "earn credits instead",
+        // The wall keeps its figure here: this row is the one that costs time,
+        // and what it pays is the only thing that makes the time worth it.
+        hint: `opens the ad wall \u2014 offers pay ${grantLabel(pendingGrantRef.current)}`
+      }
+    ];
+    setPickerSel(0);
+    setPicker({
+      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) => {
+        if (choice.value === EARN_ROW) return void runAdWall();
+        const pending = pendingTaskRef.current;
+        pendingTaskRef.current = null;
+        pendingFreeRef.current = [];
+        config.model = choice.value;
+        saveConfig(config);
+        switchModel(choice.value);
+        push({
+          kind: "notice",
+          tone: "good",
+          text: `  model \u2192 ${choice.value} (free today) \u2014 continuing where you left off`
+        });
+        if (pending) void runTurn2(pending.task, pending.images);
+      }
+    });
+  }, [config, model, push, runAdWall, runTurn2, switchModel]);
   const runBuy = useCallback(async () => {
     await runBusy(LOADING, async (signal) => {
       const { enabled, packs } = await client.creditPacks(signal);
@@ -6104,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) => {
@@ -6128,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;
           }
@@ -6160,7 +6732,7 @@ ${NO_SEARCH_INSTRUCTION}`),
           exit();
           return;
         case "help":
-          push({ kind: "notice", text: helpText() });
+          push({ kind: "notice", text: helpText(freeHelpLine(freeTier)) });
           return;
         // Clears both halves of what "clear" means: the model's context *and*
         // the screen. It used to drop only the context, so nothing visibly
@@ -6211,11 +6783,12 @@ ${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;
         case "init":
+          initHintedRef.current = true;
           await runTurn2(INIT_PROMPT);
           return;
         // Always the picker — an id you have to remember and type is exactly
@@ -6248,7 +6821,7 @@ ${NO_SEARCH_INSTRUCTION}`),
               onPick: (choice) => {
                 config.model = choice.value;
                 saveConfig(config);
-                setModel2(choice.value);
+                switchModel(choice.value);
                 push({ kind: "notice", text: `  model \u2192 ${choice.value}` });
               }
             });
@@ -6391,8 +6964,8 @@ ${NO_SEARCH_INSTRUCTION}`),
         // stop" whenever it is locked.
         case "refer":
           await runBusy(LOADING, async (signal) => {
-            const info = await client.referral(signal);
-            push({ kind: "notice", text: referLines(info).map((line3) => `  ${line3}`).join("\n") });
+            const info2 = await client.referral(signal);
+            push({ kind: "notice", text: referLines(info2).map((line3) => `  ${line3}`).join("\n") });
           });
           return;
         case "buy":
@@ -6488,7 +7061,7 @@ ${output}` }
     lastTurnRef.current = null;
     const amount = turn.free ? wallet?.rewards?.feedback_credits_free ?? wallet?.rewards?.feedback_credits : wallet?.rewards?.feedback_credits;
     const pay = amount ? `Both answers pay ${amount.toLocaleString("en-US")} credits` : "Both answers pay the same";
-    const choice = await new Promise((resolve2) => {
+    const choice = await new Promise((resolve3) => {
       setPickerSel(0);
       setPicker({
         title: "Was that last answer any good?",
@@ -6498,10 +7071,10 @@ ${output}` }
           { value: "down", label: "no \u2014 that missed", hint: "" },
           { value: "skip", label: "skip", hint: "nothing is sent, nothing is stored" }
         ],
-        onPick: (item) => resolve2(item.value),
+        onPick: (item) => resolve3(item.value),
         // Esc and "skip" are the same outcome and must stay that way: a skip
         // that cost something is a prompt people stop reading.
-        onCancel: () => resolve2(null)
+        onCancel: () => resolve3(null)
       });
     });
     if (choice !== "up" && choice !== "down") return;
@@ -6752,7 +7325,7 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
     if (key.return) {
       if (key.meta || key.shift) return setEditor(newline(editor));
       if (endsWithContinuation(editor)) return setEditor(continueLine(editor));
-      if (!busy && pendingTaskRef.current && isEmpty(editor)) return void runAdWall();
+      if (!busy && pendingTaskRef.current && isEmpty(editor)) return void runPaywallChoice();
       return void submit(toText(editor));
     }
     if (key.ctrl && ch === "j") return setEditor(newline(editor));
@@ -6777,6 +7350,10 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   const spinner = spinnerRef.current[Math.floor(tick / SPINNER_TICKS_PER_FRAME) % spinnerRef.current.length];
   const sponsorLine = busy && sponsor ? sponsorRow(sponsor.text, cols, sponsor.origin) : null;
   const adColor = adColorEnabled({ isTTY: stdout.isTTY, env: process.env });
+  const modalOpen = Boolean(picker || ask2 || plan || buy);
+  modalOpenRef.current = modalOpen;
+  const card = busy && !modalOpen && adSlots.sidebar_card ? sidebarCard(adSlots.sidebar_card.text, cols) : null;
+  const statusBarLine = busy && !modalOpen && adSlots.status_bar ? sponsorRow(adSlots.status_bar.text, cols, "network") : null;
   const viewport = Math.max(1, rows - 1);
   const inputRows = Math.max(1, Math.min(MAX_INPUT_ROWS, editor.lines.length));
   const inputFrom = windowStart(editor.row, editor.lines.length, inputRows);
@@ -6798,8 +7375,18 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   const showStatus = grant(2) > 0;
   const queueRows = grant(queuedRows.length) > 0 ? queuedRows : [];
   const showSponsor = grant(sponsorLine ? 1 : 0) > 0;
+  const showStatusBar = grant(statusBarLine && showStatus && !quitHint && menu.length === 0 ? 1 : 0) > 0;
+  const showCard = busyHeight > 0 && card !== null;
   const inputBoxHeight = inputRows + (inputBorder ? 2 : 0);
-  const chromeHeight = inputBoxHeight + (showStatus ? 2 : 0) + (showSponsor ? 1 : 0) + queueRows.length;
+  const chromeHeight = inputBoxHeight + (showStatus ? 2 : 0) + (showSponsor ? 1 : 0) + (showStatusBar ? 1 : 0) + queueRows.length;
+  const drawnKey = [
+    showSponsor && sponsorLine?.origin === "network" ? sponsor?.impressionId : void 0,
+    showCard ? adSlots.sidebar_card?.impressionId : void 0,
+    showStatusBar ? adSlots.status_bar?.impressionId : void 0
+  ].filter(Boolean).join(" ");
+  useEffect(() => {
+    for (const id of drawnKey.split(" ")) if (id) drawnRef.current.add(id);
+  }, [drawnKey]);
   let budget = Math.max(0, viewport - chromeHeight - menu.length - busyHeight);
   const pickerCompact = Boolean(picker) && budget < PICKER_CHROME + 1;
   const pickerChrome = pickerCompact ? PICKER_CHROME_COMPACT : PICKER_CHROME;
@@ -6887,15 +7474,31 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
     Math.max(1, Math.floor(cols * 0.5)),
     menu.reduce((w, c2) => Math.max(w, visibleLength(c2.label)), 0)
   );
+  const conversationUsed = useMemo(
+    () => conversationTokens([{ role: "system", content: contextRef.current.systemPrompt }, ...messages]),
+    [messages]
+  );
   const contextPct = useMemo(() => {
     const window = contextWindow(model);
     if (!window) return 0;
-    const used2 = conversationTokens([
-      { role: "system", content: contextRef.current.systemPrompt },
-      ...messages
-    ]);
-    return used2 / window;
-  }, [contextWindow, messages, model]);
+    return conversationUsed / window;
+  }, [contextWindow, conversationUsed, model]);
+  const schemaTokens = useMemo(
+    () => estimateTokens(
+      JSON.stringify(toolSchemaFor(mode, mcpRef.current.toolSchemas(), { webSearch: searchRef.current }))
+    ),
+    [mode]
+  );
+  const typed = toText(editor);
+  let estimate;
+  const info = catalogRef.current.find((m) => m.id === model);
+  const shape = client.taskShape;
+  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 } : {} });
+    estimate = estimateClause(range, verdict, !onFree && (freeTier?.credits_left ?? 0) > 0);
+  }
   const modeText = `  ${MODE_STYLE[mode].glyph} ${MODE_LABEL[mode]}`;
   const statusText = fitRow(
     `  ${statusLine(
@@ -6908,12 +7511,19 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
         // Only while a free model is selected: on a premium one the allowance
         // is real but irrelevant, and a countdown that has nothing to do with
         // the next turn is a number that teaches people to stop reading the row.
-        ...freeTier?.models.includes(model) ? { freeLeft: freeTier.credits_left } : {}
+        ...freeTier?.models.includes(model) ? { freeLeft: freeTier.credits_left } : {},
+        ...estimate ? { estimate: estimate.variants } : {}
       },
       Math.max(1, cols - visibleLength(modeText) - 2)
     )}`,
     Math.max(0, cols - visibleLength(modeText))
   );
+  const statusParts = (() => {
+    const shown = estimate?.warn ? estimate.variants.find((v) => statusText.includes(v)) : void 0;
+    if (shown === void 0) return { before: statusText, after: "" };
+    const at = statusText.indexOf(shown);
+    return { before: statusText.slice(0, at), warn: shown, after: statusText.slice(at + shown.length) };
+  })();
   const hintText = quitHint ? fitRow("  press ctrl+c again to quit", cols) : `  ${pickHint(
     ["\u2191\u2193 choose \xB7 \u23CE run \xB7 tab complete \xB7 esc close", "\u2191\u2193 \xB7 \u23CE run \xB7 tab \xB7 esc", "\u2191\u2193 \u23CE tab esc"],
     Math.max(1, cols - 2)
@@ -6923,12 +7533,47 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
     const room = cols - visibleLength(head);
     return { key: item.value, selected: i === sel, head, hint: room > 1 ? fitRow(item.hint, room) : "" };
   });
-  const busyText = fitRow(`${busyLabel} ${elapsed}s \xB7 esc to stop`, Math.max(1, cols - visibleLength(`${spinner} `)));
+  const busyCols = showCard ? cols - SIDEBAR_CARD_COLS : cols;
+  const busyText = fitRow(
+    `${busyLabel} ${elapsed}s \xB7 esc to stop`,
+    Math.max(1, busyCols - visibleLength(`${spinner} `))
+  );
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx2(Static, { items: entries, children: (entry) => /* @__PURE__ */ jsx2(EntryView, { entry }, entry.id) }, staticEpoch),
     spacer > 0 ? /* @__PURE__ */ jsx2(Box2, { height: spacer }) : null,
     liveBlock ? /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: /* @__PURE__ */ jsx2(Text2, { children: liveBlock }) }) : null,
-    busyHeight > 0 ? /* @__PURE__ */ jsxs2(Box2, { marginTop: 1, children: [
+    busyHeight > 0 && showCard && card ? (
+      /*
+        The working line with the sidebar card beside it. Two columns, two
+        rows: the working line and the blank row under it on the left, the
+        card on the right. The blank row is the one the block below would
+        otherwise have spent on its margin, so the frame is exactly as tall
+        with the card as without it — the input box does not move when a card
+        arrives or goes, and the budget above never had to count it.
+      */
+      /* @__PURE__ */ jsxs2(Box2, { marginTop: 1, children: [
+        /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", width: busyCols, children: [
+          /* @__PURE__ */ jsxs2(Box2, { children: [
+            /* @__PURE__ */ jsxs2(Text2, { color: MANGO3, children: [
+              spinner,
+              " "
+            ] }),
+            /* @__PURE__ */ jsx2(Text2, { dimColor: true, wrap: "truncate-end", children: busyText })
+          ] }),
+          /* @__PURE__ */ jsx2(Text2, { children: " " })
+        ] }),
+        /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", width: SIDEBAR_CARD_COLS, children: [
+          /* @__PURE__ */ jsxs2(Box2, { children: [
+            /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: card.rule }),
+            /* @__PURE__ */ jsx2(Text2, { ...adColor ? { color: AD_MARK } : { dimColor: true }, wrap: "truncate-end", children: card.label })
+          ] }),
+          /* @__PURE__ */ jsxs2(Box2, { children: [
+            /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: card.rule }),
+            /* @__PURE__ */ jsx2(Text2, { ...adColor ? { color: AD_TEXT } : { dimColor: true }, wrap: "truncate-end", children: card.body })
+          ] })
+        ] })
+      ] })
+    ) : busyHeight > 0 ? /* @__PURE__ */ jsxs2(Box2, { marginTop: 1, children: [
       /* @__PURE__ */ jsxs2(Text2, { color: MANGO3, children: [
         spinner,
         " "
@@ -6968,20 +7613,9 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
       pickerCompact ? null : /* @__PURE__ */ jsx2(Box2, { height: 1 }),
       /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: pickerHint })
     ] }) : null,
-    /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginTop: 1, children: [
+    /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", marginTop: showCard ? 0 : 1, children: [
       queueRows.map((line2, i) => /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: line2 }, i)),
-      showSponsor && sponsorLine ? /* @__PURE__ */ jsxs2(Box2, { children: [
-        /* @__PURE__ */ jsx2(Text2, { dimColor: true, wrap: "truncate-end", children: sponsorLine.marker }),
-        sponsorLine.label ? /* @__PURE__ */ jsx2(Text2, { ...adColor ? { color: AD_MARK } : { dimColor: true }, wrap: "truncate-end", children: sponsorLine.label }) : null,
-        /* @__PURE__ */ jsx2(
-          Text2,
-          {
-            ...adColor && sponsorLine.origin === "network" ? { color: AD_TEXT } : { dimColor: true },
-            wrap: "truncate-end",
-            children: sponsorLine.body
-          }
-        )
-      ] }) : null,
+      showSponsor && sponsorLine ? /* @__PURE__ */ jsx2(SponsorRowView, { row: sponsorLine, adColor }) : null,
       inputBorder ? /* @__PURE__ */ jsxs2(Box2, { borderStyle: "round", borderColor: busy ? MANGO3 : MANGO_BRIGHT, paddingX: 1, children: [
         /* @__PURE__ */ jsx2(Text2, { color: MANGO_BRIGHT, children: "\u276F " }),
         /* @__PURE__ */ jsx2(Text2, { children: renderInput(editor, inputFrom, inputRows) })
@@ -6995,18 +7629,30 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
       ] }, row.key)),
       !showStatus ? null : quitHint || menu.length > 0 ? /* @__PURE__ */ jsx2(Text2, { dimColor: true, wrap: "truncate-end", children: hintText }) : /* @__PURE__ */ jsxs2(Box2, { children: [
         /* @__PURE__ */ jsx2(Text2, { color: MODE_STYLE[mode].color, bold: true, wrap: "truncate-end", children: modeText }),
-        /* @__PURE__ */ jsx2(Text2, { dimColor: true, wrap: "truncate-end", children: statusText })
-      ] })
+        statusParts.warn === void 0 ? /* @__PURE__ */ jsx2(Text2, { dimColor: true, wrap: "truncate-end", children: statusText }) : /* @__PURE__ */ jsxs2(Fragment, { children: [
+          /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: statusParts.before }),
+          /* @__PURE__ */ jsx2(Text2, { color: "yellow", children: statusParts.warn }),
+          /* @__PURE__ */ jsx2(Text2, { dimColor: true, wrap: "truncate-end", children: statusParts.after })
+        ] })
+      ] }),
+      showStatusBar && statusBarLine ? /* @__PURE__ */ jsx2(SponsorRowView, { row: statusBarLine, adColor }) : null
     ] })
   ] });
 }
+function SponsorRowView({ row, adColor }) {
+  return /* @__PURE__ */ jsxs2(Box2, { children: [
+    /* @__PURE__ */ jsx2(Text2, { dimColor: true, wrap: "truncate-end", children: row.marker }),
+    row.label ? /* @__PURE__ */ jsx2(Text2, { ...adColor ? { color: AD_MARK } : { dimColor: true }, wrap: "truncate-end", children: row.label }) : null,
+    /* @__PURE__ */ jsx2(Text2, { ...adColor && row.origin === "network" ? { color: AD_TEXT } : { dimColor: true }, wrap: "truncate-end", children: row.body })
+  ] });
+}
 function sleep4(ms, signal) {
-  return new Promise((resolve2) => {
-    if (signal.aborted) return resolve2();
+  return new Promise((resolve3) => {
+    if (signal.aborted) return resolve3();
     const done = () => {
       clearTimeout(timer);
       signal.removeEventListener("abort", done);
-      resolve2();
+      resolve3();
     };
     const timer = setTimeout(done, ms);
     signal.addEventListener("abort", done, { once: true });
@@ -7030,14 +7676,14 @@ function renderInput(state, from, rows) {
 function modelHint(m, free) {
   const effort = adsPerTaskLabel(m.est_ads_per_task);
   if (!m.free || !free?.models.includes(m.id)) return effort;
-  const turns = free.turns_left[m.id] ?? 0;
-  if (turns <= 0) return `free: none left today \xB7 ${effort}`;
-  return `free: ~${turns} turn${turns === 1 ? "" : "s"} left \xB7 ${effort}`;
+  const turns2 = free.turns_left[m.id] ?? 0;
+  if (turns2 <= 0) return `free: none left today \xB7 ${effort}`;
+  return `free: ~${turns2} turn${turns2 === 1 ? "" : "s"} left \xB7 ${effort}`;
 }
 function turnMeta(result) {
   const n = (v) => v.toLocaleString("en-US");
   const balance = `balance ${n(result.balance)}`;
-  if (result.creditsWaived <= 0) return `[${result.creditsCharged} credits \xB7 ${balance}]`;
+  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}]`;
@@ -7045,10 +7691,23 @@ function turnMeta(result) {
   return `[free \xB7 ${n(result.creditsWaived)} credits waived${left}]`;
 }
 function statusLine(o, cols) {
+  const phrasings = o.estimate === void 0 ? [] : typeof o.estimate === "string" ? [o.estimate] : [...o.estimate];
+  for (const estimate of [...phrasings, void 0]) {
+    const line2 = statusRow(o, estimate, cols);
+    if (estimate === void 0 || visibleLength(line2) <= cols) return fitRow(line2, cols);
+  }
+  return fitRow(statusRow(o, void 0, cols), cols);
+}
+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.
@@ -7056,6 +7715,7 @@ function statusLine(o, cols) {
       text: o.freeLeft === void 0 ? void 0 : `free ${o.freeLeft.toLocaleString("en-US")}`,
       rank: 4
     },
+    { text: estimate, rank: 5 },
     { text: o.spent > 0 ? `\u2212${o.spent.toLocaleString("en-US")}` : void 0, rank: 2 },
     { text: burn, rank: 1 },
     {
@@ -7067,7 +7727,7 @@ function statusLine(o, cols) {
   const join7 = (minRank) => clauses.filter((c2) => c2.rank >= minRank).map((c2) => c2.text).join(" \xB7 ");
   let line2 = join7(0);
   for (let minRank = 1; minRank <= 5 && visibleLength(line2) > cols; minRank++) line2 = join7(minRank);
-  return fitRow(line2, cols);
+  return line2;
 }
 function windowStart(sel, total, size) {
   if (total <= size) return 0;
@@ -7118,7 +7778,7 @@ function tailLines(text, max) {
   const lines = text.split("\n");
   return lines.length <= max ? text : lines.slice(-max).join("\n");
 }
-var WORKING, WAITING_FOR_REWARD, LOADING, COMPACTING, SIGNING_IN, RUNNING, SENDING_FEEDBACK, WAITING_FOR_PAYMENT, FEEDBACK_TURN_INTERVAL, NOT_SIGNED_IN, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES, DELTA_FLUSH_MS, MAX_INPUT_ROWS, MAX_PICKER_ROWS, MAX_QUEUE_ROWS, QUEUE_MARKER, PICKER_CURRENT, MIN_PICKER_LABEL_COLS, PICKER_CHROME, PICKER_CHROME_COMPACT, ASK_CHROME, PLAN_CHROME, BUY_CHROME, BUY_CHROME_COMPACT, ASK_HINT, PLAN_HINT, BUY_HINT, BUY_CONFIRM_WORD, BUY_TYPED_MAX, BUY_TOO_SHORT, EXPAND_MAX_LINES, FALLBACK_ROWS, FALLBACK_COLS, CONTEXT_NOTICE_AT, KEEP_ALWAYS;
+var WORKING, WAITING_FOR_REWARD, LOADING, COMPACTING, SIGNING_IN, RUNNING, SENDING_FEEDBACK, WAITING_FOR_PAYMENT, FEEDBACK_TURN_INTERVAL, NOT_SIGNED_IN, LIVE_OUTPUT_LINES, COMMITTED_OUTPUT_LINES, DELTA_FLUSH_MS, MAX_INPUT_ROWS, MAX_PICKER_ROWS, MAX_QUEUE_ROWS, QUEUE_MARKER, PICKER_CURRENT, MIN_PICKER_LABEL_COLS, PICKER_CHROME, PICKER_CHROME_COMPACT, ASK_CHROME, PLAN_CHROME, BUY_CHROME, BUY_CHROME_COMPACT, ASK_HINT, PLAN_HINT, BUY_HINT, BUY_CONFIRM_WORD, BUY_TYPED_MAX, BUY_TOO_SHORT, EXPAND_MAX_LINES, FALLBACK_ROWS, FALLBACK_COLS, INIT_HINT_AFTER_TURNS, EARN_ROW, CONTEXT_NOTICE_AT, KEEP_ALWAYS;
 var init_app = __esm({
   "src/tui/app.tsx"() {
     "use strict";
@@ -7133,6 +7793,8 @@ var init_app = __esm({
     init_context();
     init_mentions();
     init_compact();
+    init_estimate();
+    init_free_tier();
     init_kimi();
     init_browser();
     init_version();
@@ -7143,6 +7805,7 @@ var init_app = __esm({
     init_counter();
     init_provider();
     init_network();
+    init_formats();
     init_render();
     init_commands();
     init_editor();
@@ -7195,6 +7858,8 @@ var init_app = __esm({
     EXPAND_MAX_LINES = 400;
     FALLBACK_ROWS = 24;
     FALLBACK_COLS = 80;
+    INIT_HINT_AFTER_TURNS = 3;
+    EARN_ROW = "\0earn";
     CONTEXT_NOTICE_AT = 0.6;
     KEEP_ALWAYS = Number.POSITIVE_INFINITY;
   }
@@ -7228,6 +7893,7 @@ var init_tui = __esm({
 init_client();
 init_config();
 init_login();
+init_free_tier();
 init_agent();
 init_tools();
 init_context();
@@ -7279,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":
@@ -7343,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, {
@@ -7366,22 +8032,28 @@ async function login(client, config, args) {
 \u2713 logged in as ${who}`) + suffix);
       const bonus = account.created ? c.dim(account.signupBonus === void 0 ? " (signup bonus)" : ` (signup bonus ${credits(account.signupBonus)})`) : "";
       console.log(`  balance: ${c.bold(credits(account.balance))} credits${bonus}`);
+      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) {
@@ -7429,8 +8101,8 @@ async function listModels(client) {
   console.log(c.bold("Models  (credit prices per 1M tokens)"));
   for (const m of models) {
     const tag = m.ad_fundable ? "" : c.dim(" [paid/BYOK]");
-    const turns = free?.models.includes(m.id) ? free.turns_left[m.id] ?? 0 : void 0;
-    const freeTag = !m.free ? "" : turns === void 0 ? c.green(" [free]") : turns > 0 ? c.green(` [free: ~${turns} turn${turns === 1 ? "" : "s"} left today]`) : c.dim(" [free: none left today]");
+    const turns2 = free?.models.includes(m.id) ? free.turns_left[m.id] ?? 0 : void 0;
+    const freeTag = !m.free ? "" : turns2 === void 0 ? c.green(" [free]") : turns2 > 0 ? c.green(` [free: ~${turns2} turn${turns2 === 1 ? "" : "s"} left today]`) : c.dim(" [free: none left today]");
     console.log(
       `  ${c.cyan(m.id.padEnd(22))} ${m.tier.padEnd(8)} in ${String(m.credits_per_mtoken_input).padStart(9)}  out ${String(m.credits_per_mtoken_output).padStart(9)}  ${adsPerTaskLabel(m.est_ads_per_task)}${tag}${freeTag}`
     );
@@ -7583,7 +8255,9 @@ ${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(
         c.yellow(
           `Run \`clixad earn\` to open the offerwall \u2014 offers pay ${grantLabel(err.grantPerAd)}.`
@@ -7632,10 +8306,14 @@ 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."));
+      const pick = w.free_tier && w.free_tier.credits_left > 0 ? freeModelToName(w.free_tier, config.model) : void 0;
+      if (pick && pick.id !== config.model) {
+        console.log(c.green(`  ${freeAlternativeLine([{ id: pick.id, turnsLeft: pick.turns }], { rerun: false })}`));
+      }
     }
   }
   console.log(c.dim("  launching Kimi CLI (Clixad-configured)\u2026\n"));
@@ -7663,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;
@@ -7675,8 +8354,9 @@ 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();
   const { startTui: startTui2 } = await Promise.resolve().then(() => (init_tui(), tui_exports));
   await startTui2({
@@ -7685,23 +8365,32 @@ async function repl(client, config, opts = {}) {
     wallet,
     streak,
     session,
+    newAccount,
     initialTask: opts.task,
-    ...opts.notices?.length ? { notices: opts.notices } : {}
+    ...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(
         c.yellow(`Run \`clixad earn\` to open the offerwall \u2014 offers pay ${grantLabel(err.grantPerAd)}.`)
       );
@@ -7729,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
-  ${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));