clixad 0.0.1-beta.21 → 0.0.1-beta.22

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}` } };
 }
@@ -252,7 +351,10 @@ function asSignupClosed(status, data) {
   return d && d.error === "signup_closed" && typeof d.message === "string" ? { error: d.error, message: d.message, waitlist_url: d.waitlist_url ?? "https://clixad.io" } : void 0;
 }
 function paywallError(body) {
-  return new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad);
+  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);
 }
 async function authFailure(res, what) {
   const body = await res.text().catch(() => "");
@@ -278,16 +380,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 });
@@ -331,6 +433,8 @@ var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError,
 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,16 +465,18 @@ 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;
     };
     AuthError = class extends Error {
       constructor() {
@@ -640,8 +746,18 @@ var init_client = __esm({
         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);
         return data.data;
       }
+      /**
+       * 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.
        *
@@ -701,11 +817,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;
@@ -735,6 +853,7 @@ var init_client = __esm({
             ...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,
@@ -1132,12 +1251,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 +1265,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 +1308,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 +1344,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 +1353,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 +1377,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 +1415,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 +2556,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 +2570,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 +4164,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 +4225,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 +4333,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 +4381,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 +4500,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) {
@@ -4804,6 +5020,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 +5044,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 +5061,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 +5075,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 +5098,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 +5130,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 +5619,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 +5662,18 @@ 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,
+  initialTask,
+  notices: notices2,
+  sponsorServe,
+  sponsorFormats,
+  initHint
+}) {
   const { exit } = useApp();
   const { stdout, write: writeToStdout } = useStdout();
   const idRef = useRef(1);
@@ -5466,7 +5709,12 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
   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 +5728,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 +5759,15 @@ 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 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 +5775,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());
@@ -5593,9 +5869,17 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
     if (files.length) push({ kind: "notice", text: `  context: ${files.join(", ")}` });
     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;
@@ -5645,6 +5929,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 +5945,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 +5993,7 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
             permRef.current.mode = decision;
             setMode(decision);
           }
-          resolve2(decision);
+          resolve3(decision);
         }
       });
     }),
@@ -5704,7 +6005,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 +6017,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 +6099,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 });
@@ -5824,7 +6127,7 @@ function App({ client, config, wallet, streak, session, initialTask, notices: no
           }
         }
         const result = await runAgent(client, task, {
-          model,
+          model: model2,
           root,
           history,
           attachments: images,
@@ -5866,7 +6169,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 +6185,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 +6196,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,14 +6220,26 @@ ${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;
+          const free = err.freeModels[0];
           push({
             kind: "notice",
             tone: "warn",
-            text: `  Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).
+            text: free ? `  Out of credits on ${model2} (balance ${err.balance}, need ~${err.estimatedCost}).
+  Press enter \u2014 ${free.id} is still free today (~${free.turnsLeft} turn${free.turnsLeft === 1 ? "" : "s"} left), or take an offer instead.
+  Your request is kept either way, so you will not have to type it again.
+  Offers you are screened out of pay nothing; that is normal, just start another.
+  /buy is there too, if you would rather pay than do an offer.` : `  Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).
   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.
@@ -5932,6 +6258,7 @@ ${NO_SEARCH_INSTRUCTION}`),
         reportSponsor();
         sponsorCallRef.current++;
         setSponsor(null);
+        setAdSlots({});
       }
     },
     [
@@ -6002,10 +6329,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":
@@ -6073,6 +6411,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: "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);
@@ -6160,7 +6538,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
@@ -6216,6 +6594,7 @@ ${NO_SEARCH_INSTRUCTION}`),
           });
           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 +6627,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 +6770,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 +6867,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 +6877,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 +7131,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 +7156,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 +7181,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 +7280,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 && 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 +7317,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 +7339,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 +7419,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 +7435,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,9 +7482,9 @@ 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");
@@ -7045,6 +7497,14 @@ 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 },
@@ -7056,6 +7516,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 +7528,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 +7579,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 +7594,8 @@ var init_app = __esm({
     init_context();
     init_mentions();
     init_compact();
+    init_estimate();
+    init_free_tier();
     init_kimi();
     init_browser();
     init_version();
@@ -7143,6 +7606,7 @@ var init_app = __esm({
     init_counter();
     init_provider();
     init_network();
+    init_formats();
     init_render();
     init_commands();
     init_editor();
@@ -7195,6 +7659,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 +7694,7 @@ var init_tui = __esm({
 init_client();
 init_config();
 init_login();
+init_free_tier();
 init_agent();
 init_tools();
 init_context();
@@ -7366,6 +7833,7 @@ 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;
@@ -7429,8 +7897,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}`
     );
@@ -7584,6 +8052,8 @@ ${NO_SEARCH_INSTRUCTION}`),
     if (err instanceof PaywallError) {
       console.log(c.yellow(`
 Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
+      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)}.`
@@ -7636,6 +8106,10 @@ async function codeCmd(client, config, rest) {
     );
     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"));
@@ -7677,6 +8151,8 @@ async function repl(client, config, opts = {}) {
   }
   const streak = await client.claimStreak();
   const wallet = await safeWallet(client);
+  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({
@@ -7686,7 +8162,8 @@ async function repl(client, config, opts = {}) {
     streak,
     session,
     initialTask: opts.task,
-    ...opts.notices?.length ? { notices: opts.notices } : {}
+    ...opts.notices?.length ? { notices: opts.notices } : {},
+    ...initHint ? { initHint } : {}
   });
 }
 async function runTurn(client, config, messages) {
@@ -7702,6 +8179,8 @@ async function runTurn(client, config, messages) {
     process.stdout.write("\n");
     if (err instanceof PaywallError) {
       console.log(c.yellow(`Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
+      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)}.`)
       );
@@ -7735,7 +8214,7 @@ function printHelp() {
   ${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("models")}            list models with credit prices, and which are free today
   ${c.cyan("model")} <id>        set default model
   ${c.cyan("wallet")}            balance, ads today, ledger
   ${c.cyan("earn")}              open the ad wall to earn credits