adsinagents 0.1.0 → 0.1.2

package/README.md

@@ -1,7 +1,7 @@
 # AdsInAgents
 
 Get paid while you build. AdsInAgents puts a single sponsored line in your
-Claude Code status bar and pays you for every verified impression.
+coding agent's status line and pays you for every verified impression.
 
 ```sh
 npm install -g adsinagents
@@ -17,6 +17,6 @@ to attach a login and cash out.
 
 The ad is always disclosed (`· sponsored`), never injected into model context,
 and the daemon only counts an impression when the session is real, focused, and
-on-screen. macOS today; Windows next.
+on-screen. Claude Code on macOS today; more agents and Windows next.
 
 [adsinagents.com](https://adsinagents.com) · advertisers: [adsinagents.com/advertise](https://adsinagents.com/advertise)

package/cli/dist/index.js

@@ -4082,6 +4082,20 @@ var coerce = {
 };
 var NEVER = INVALID;
 
+// ../../shared/dist/categories.js
+var CATEGORIES = {
+  crypto: ["crypto", "web3", "blockchain", "nft", "token", "defi", "bitcoin", "ethereum", "wallet"],
+  gambling: ["casino", "betting", "sportsbook", "poker", "lottery", "wager", "slots"],
+  alcohol: ["beer", "whiskey", "whisky", "vodka", "wine", "tequila", "liquor", "cocktail"],
+  dating: ["dating", "hookup", "singles", "match with", "find love"],
+  politics: ["campaign", "vote for", "super pac", "ballot", "elect "]
+};
+var CATEGORY_KEYS = Object.keys(CATEGORIES);
+var CategorySchema = external_exports.enum(CATEGORY_KEYS);
+function isCategory(value) {
+  return CATEGORY_KEYS.includes(value);
+}
+
 // ../../shared/dist/schemas.js
 var AdSchema = external_exports.object({
   /** Stable impression id for this rotation; idempotency key for firing. */
@@ -4124,6 +4138,7 @@ var GravityAdSchema = external_exports.object({
 });
 var GravityResponseSchema = external_exports.array(GravityAdSchema);
 var PlacementSchema = external_exports.enum(["statusline", "spinner", "both", "off"]);
+var ThemeSchema = external_exports.enum(["plain", "dim", "accent"]);
 var AgentNameSchema = external_exports.enum(["claude-code"]);
 var ConfigSchema = external_exports.object({
   placement: PlacementSchema.default("statusline"),
@@ -4133,8 +4148,16 @@ var ConfigSchema = external_exports.object({
   production: external_exports.boolean().default(false),
   /** Send prompt text to Gravity for contextual matching. PRIVACY: off by default. */
   contextualAds: external_exports.boolean().default(false),
-  /** AdLine server base URL the daemon polls for ads / sync / flags. */
-  serverUrl: external_exports.string().default("http://127.0.0.1:3000"),
+  /**
+   * Ad categories the user opted out of. Best-effort keyword match on the ad's
+   * own text/brand, applied client-side in the daemon — a matched ad is dropped
+   * before it paints (no impression, not billed). See shared/src/categories.ts.
+   */
+  blockedCategories: external_exports.array(CategorySchema).default([]),
+  /** AdLine server base URL the daemon polls for ads / sync / flags.
+   *  Defaults to production — a fresh `npm i -g adsinagents` install must work
+   *  with zero config. Local dev: set serverUrl in ~/.adsinagents/config.json. */
+  serverUrl: external_exports.string().default("https://adsinagents.com"),
   /** Device bearer token minted by `adsinagents init` (server /api/register). */
   deviceToken: external_exports.string().default(""),
   /** Stable per-install device id. */
@@ -4149,10 +4172,18 @@ var ConfigSchema = external_exports.object({
   rateCapSec: external_exports.number().int().positive().default(60),
   /** Continuous focus seconds required before an impression verifies. */
   focusDwellSec: external_exports.number().int().positive().default(5),
+  /**
+   * Seconds the ad stays painted after a turn ends (Stop hook). Past the grace
+   * the status line goes clean until the next prompt. 0 = hide on Stop.
+   * Display AND billing follow this gate together (billed ⇒ on screen).
+   */
+  idleGraceSec: external_exports.number().int().nonnegative().default(120),
   /** Remote kill-switch flag URL (optional; falls back to serverUrl/api/flags). */
   killSwitchUrl: external_exports.string().default(""),
   /** Show a live earnings segment in the status line (separate from the ad). Off by default. */
-  showEarnings: external_exports.boolean().default(false)
+  showEarnings: external_exports.boolean().default(false),
+  /** Terminal styling for ad/earnings segments. Plain (no ANSI) by default. */
+  theme: ThemeSchema.default("plain")
 });
 var DEFAULT_CONFIG = ConfigSchema.parse({});
 var DaemonStateSchema = external_exports.object({
@@ -4171,7 +4202,10 @@ var DaemonStateSchema = external_exports.object({
   /** Publisher lifetime balance, cents. From the last sync response. Optional. */
   balanceCents: external_exports.number().int().nonnegative().default(0),
   /** Earnings today, cents. From the last sync response. Optional. */
-  todayCents: external_exports.number().int().nonnegative().default(0)
+  todayCents: external_exports.number().int().nonnegative().default(0),
+  /** Claude is mid-turn (prompt received, Stop not yet). Drives the statusline
+   *  working glyph. Additive — older daemons omit it. */
+  working: external_exports.boolean().default(false)
 });
 var ImpressionSchema = external_exports.object({
   id: external_exports.string(),
@@ -4420,7 +4454,7 @@ function getPlatform() {
 }
 
 // ../../shared/dist/agent/claude-code.js
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, copyFileSync, renameSync } from "node:fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, copyFileSync, renameSync, rmSync } from "node:fs";
 import { dirname as dirname2, join as join3 } from "node:path";
 import { execFileSync as execFileSync2 } from "node:child_process";
 var ClaudeCodeAdapter = class {
@@ -4428,6 +4462,9 @@ var ClaudeCodeAdapter = class {
     hasStatusLine: true,
     hasSpinner: true,
     hasHttpHooks: true,
+    // CC strips OSC 8 in the status line (anthropics/claude-code#21586).
+    statuslineHyperlinks: false,
+    hasSlashCommands: true,
     displayName: "Claude Code",
     binaryName: "claude"
   };
@@ -4482,7 +4519,8 @@ var ClaudeCodeAdapter = class {
       next.statusLine = {
         type: "command",
         command: plan.statuslineCommand,
-        refreshInterval: 2
+        // 1s so the working glyph animates at 1 frame/sec (was 2).
+        refreshInterval: 1
       };
     }
     if (plan.placement === "spinner" || plan.placement === "both") {
@@ -4524,8 +4562,27 @@ var ClaudeCodeAdapter = class {
     const backup = this.backup();
     const { next, diff } = this.merge(plan);
     this.write(next);
+    this.writeSlashCommand();
     return { backup, diff };
   }
+  /** Path of the in-session settings command, e.g. ~/.claude/commands/adsinagents.md. */
+  slashCommandPath() {
+    return join3(claudeConfigDir(), "commands", "adsinagents.md");
+  }
+  /**
+   * Install /adsinagents — the status line itself is display-only, so this is
+   * the in-session settings surface: the user types /adsinagents and Claude
+   * drives the CLI. File is fully ours (sentinel comment), safe to delete on
+   * remove. Best-effort: a failure here never fails install.
+   */
+  writeSlashCommand() {
+    try {
+      const p = this.slashCommandPath();
+      mkdirSync2(dirname2(p), { recursive: true });
+      writeFileSync2(p, SLASH_COMMAND_MD);
+    } catch {
+    }
+  }
   removeInstall() {
     const cur = this.read();
     const marker = cur[ADLINE_SENTINEL];
@@ -4550,6 +4607,13 @@ var ClaudeCodeAdapter = class {
     }
     delete next[ADLINE_SENTINEL];
     this.write(next);
+    try {
+      const p = this.slashCommandPath();
+      if (existsSync2(p) && readFileSync2(p, "utf8").includes(SLASH_SENTINEL)) {
+        rmSync(p);
+      }
+    } catch {
+    }
     return { restored: true };
   }
   /**
@@ -4612,6 +4676,30 @@ var ClaudeCodeAdapter = class {
     return rows;
   }
 };
+var SLASH_SENTINEL = "<!-- adsinagents:managed -->";
+var SLASH_COMMAND_MD = `---
+description: AdsInAgents \u2014 earnings, settings, doctor for the sponsored status line
+allowed-tools: Bash(adsinagents:*)
+---
+${SLASH_SENTINEL}
+
+You manage AdsInAgents (the sponsored status line) for the user via its CLI.
+
+Current state:
+- Config: !\`adsinagents config get\`
+- Stats: !\`adsinagents stats\`
+
+User request: $ARGUMENTS
+
+If the request is empty, show current config + stats and list what can be changed.
+Apply changes with the CLI (never edit config files directly):
+- \`adsinagents config set show-earnings <true|false>\` \u2014 toggle the earnings readout
+- \`adsinagents config set theme <plain|dim|accent>\` \u2014 status line colors (accent = amber mark, bold brand, green earnings; note: Claude Code currently dims all status line colors upstream)
+- \`adsinagents config block <category>\` / \`config unblock <category>\` \u2014 opt out of ad categories (crypto, gambling, alcohol, dating, politics). Best-effort keyword match on the ad's text; a blocked ad is dropped before it shows and is never billed. Run \`config blocked\` to list. Map natural requests like "no crypto ads" to \`config block crypto\`.
+- \`adsinagents doctor\` \u2014 diagnose setup issues
+- \`adsinagents stats\` \u2014 impressions, clicks, balance
+- \`adsinagents remove\` \u2014 uninstall (confirm with the user first)
+`;
 function spinnerVerbsFor(ad) {
   if (!ad)
     return [];
@@ -4944,11 +5032,49 @@ function writeConfigPatch(patch) {
   writeFileSync3(PATHS.config, JSON.stringify(next, null, 2) + "\n");
   return next;
 }
+var THEME_VALUES = ["plain", "dim", "accent"];
 function cmdConfig(positional, flags) {
   if (positional[0] === "set" && positional[1] === "show-earnings") {
     const on = positional[2] !== "false";
     writeConfigPatch({ showEarnings: on });
     process.stdout.write(`\u2713 showEarnings = ${on}
+`);
+    return;
+  }
+  if (positional[0] === "block" || positional[0] === "unblock") {
+    const cat = positional[1];
+    if (!cat || !isCategory(cat)) {
+      process.stdout.write(`category must be one of: ${CATEGORY_KEYS.join(" | ")}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    const cur = loadConfigSafe().blockedCategories;
+    const next = positional[0] === "block" ? Array.from(/* @__PURE__ */ new Set([...cur, cat])) : cur.filter((c) => c !== cat);
+    writeConfigPatch({ blockedCategories: next });
+    const verb = positional[0] === "block" ? "blocking" : "showing";
+    process.stdout.write(`\u2713 now ${verb} ${cat} ads \xB7 blocked: ${next.join(", ") || "(none)"}
+`);
+    return;
+  }
+  if (positional[0] === "blocked") {
+    const cur = loadConfigSafe().blockedCategories;
+    process.stdout.write(`blocked: ${cur.join(", ") || "(none)"}
+`);
+    process.stdout.write(`available: ${CATEGORY_KEYS.join(", ")}
+`);
+    return;
+  }
+  if (positional[0] === "set" && positional[1] === "theme") {
+    const t = positional[2];
+    if (!THEME_VALUES.includes(t)) {
+      process.stdout.write(`theme must be one of: ${THEME_VALUES.join(" | ")}
+`);
+      process.exitCode = 1;
+      return;
+    }
+    writeConfigPatch({ theme: t });
+    process.stdout.write(`\u2713 theme = ${t}
 `);
     return;
   }
@@ -4957,7 +5083,9 @@ function cmdConfig(positional, flags) {
     process.stdout.write(JSON.stringify(cfg, null, 2) + "\n");
     return;
   }
-  process.stdout.write("usage: adsinagents config get | config set show-earnings <true|false>\n");
+  process.stdout.write(
+    "usage: adsinagents config get | config set show-earnings <true|false> | config set theme <plain|dim|accent> | config block <category> | config unblock <category> | config blocked\n"
+  );
 }
 async function main() {
   const [, , cmd, ...rest] = process.argv;
@@ -4988,7 +5116,7 @@ async function main() {
   doctor
   stats
   claim                            print the URL to attach a login + get paid
-  config get | config set show-earnings <true|false>
+  config get | config set show-earnings <true|false> | config set theme <plain|dim|accent>
 `
       );
       return;

package/daemon/dist/main.js

@@ -4077,6 +4077,30 @@ var coerce = {
 };
 var NEVER = INVALID;
 
+// ../../shared/dist/categories.js
+var CATEGORIES = {
+  crypto: ["crypto", "web3", "blockchain", "nft", "token", "defi", "bitcoin", "ethereum", "wallet"],
+  gambling: ["casino", "betting", "sportsbook", "poker", "lottery", "wager", "slots"],
+  alcohol: ["beer", "whiskey", "whisky", "vodka", "wine", "tequila", "liquor", "cocktail"],
+  dating: ["dating", "hookup", "singles", "match with", "find love"],
+  politics: ["campaign", "vote for", "super pac", "ballot", "elect "]
+};
+var CATEGORY_KEYS = Object.keys(CATEGORIES);
+var CategorySchema = external_exports.enum(CATEGORY_KEYS);
+function matchesBlocked(ad, blocked) {
+  if (blocked.length === 0)
+    return false;
+  const haystack = `${ad.text} ${ad.brandName}`.toLowerCase();
+  for (const cat of blocked) {
+    const keywords = CATEGORIES[cat];
+    if (!keywords)
+      continue;
+    if (keywords.some((kw) => haystack.includes(kw)))
+      return true;
+  }
+  return false;
+}
+
 // ../../shared/dist/schemas.js
 var AdSchema = external_exports.object({
   /** Stable impression id for this rotation; idempotency key for firing. */
@@ -4119,6 +4143,7 @@ var GravityAdSchema = external_exports.object({
 });
 var GravityResponseSchema = external_exports.array(GravityAdSchema);
 var PlacementSchema = external_exports.enum(["statusline", "spinner", "both", "off"]);
+var ThemeSchema = external_exports.enum(["plain", "dim", "accent"]);
 var AgentNameSchema = external_exports.enum(["claude-code"]);
 var ConfigSchema = external_exports.object({
   placement: PlacementSchema.default("statusline"),
@@ -4128,8 +4153,16 @@ var ConfigSchema = external_exports.object({
   production: external_exports.boolean().default(false),
   /** Send prompt text to Gravity for contextual matching. PRIVACY: off by default. */
   contextualAds: external_exports.boolean().default(false),
-  /** AdLine server base URL the daemon polls for ads / sync / flags. */
-  serverUrl: external_exports.string().default("http://127.0.0.1:3000"),
+  /**
+   * Ad categories the user opted out of. Best-effort keyword match on the ad's
+   * own text/brand, applied client-side in the daemon — a matched ad is dropped
+   * before it paints (no impression, not billed). See shared/src/categories.ts.
+   */
+  blockedCategories: external_exports.array(CategorySchema).default([]),
+  /** AdLine server base URL the daemon polls for ads / sync / flags.
+   *  Defaults to production — a fresh `npm i -g adsinagents` install must work
+   *  with zero config. Local dev: set serverUrl in ~/.adsinagents/config.json. */
+  serverUrl: external_exports.string().default("https://adsinagents.com"),
   /** Device bearer token minted by `adsinagents init` (server /api/register). */
   deviceToken: external_exports.string().default(""),
   /** Stable per-install device id. */
@@ -4144,10 +4177,18 @@ var ConfigSchema = external_exports.object({
   rateCapSec: external_exports.number().int().positive().default(60),
   /** Continuous focus seconds required before an impression verifies. */
   focusDwellSec: external_exports.number().int().positive().default(5),
+  /**
+   * Seconds the ad stays painted after a turn ends (Stop hook). Past the grace
+   * the status line goes clean until the next prompt. 0 = hide on Stop.
+   * Display AND billing follow this gate together (billed ⇒ on screen).
+   */
+  idleGraceSec: external_exports.number().int().nonnegative().default(120),
   /** Remote kill-switch flag URL (optional; falls back to serverUrl/api/flags). */
   killSwitchUrl: external_exports.string().default(""),
   /** Show a live earnings segment in the status line (separate from the ad). Off by default. */
-  showEarnings: external_exports.boolean().default(false)
+  showEarnings: external_exports.boolean().default(false),
+  /** Terminal styling for ad/earnings segments. Plain (no ANSI) by default. */
+  theme: ThemeSchema.default("plain")
 });
 var DEFAULT_CONFIG = ConfigSchema.parse({});
 var DAEMON_STATE_SCHEMA_VERSION = 1;
@@ -4167,7 +4208,10 @@ var DaemonStateSchema = external_exports.object({
   /** Publisher lifetime balance, cents. From the last sync response. Optional. */
   balanceCents: external_exports.number().int().nonnegative().default(0),
   /** Earnings today, cents. From the last sync response. Optional. */
-  todayCents: external_exports.number().int().nonnegative().default(0)
+  todayCents: external_exports.number().int().nonnegative().default(0),
+  /** Claude is mid-turn (prompt received, Stop not yet). Drives the statusline
+   *  working glyph. Additive — older daemons omit it. */
+  working: external_exports.boolean().default(false)
 });
 var ImpressionSchema = external_exports.object({
   id: external_exports.string(),
@@ -4416,7 +4460,7 @@ function getPlatform() {
 }
 
 // ../../shared/dist/agent/claude-code.js
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, copyFileSync, renameSync } from "node:fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync as mkdirSync2, copyFileSync, renameSync, rmSync } from "node:fs";
 import { dirname as dirname2, join as join3 } from "node:path";
 import { execFileSync as execFileSync2 } from "node:child_process";
 var ClaudeCodeAdapter = class {
@@ -4424,6 +4468,9 @@ var ClaudeCodeAdapter = class {
     hasStatusLine: true,
     hasSpinner: true,
     hasHttpHooks: true,
+    // CC strips OSC 8 in the status line (anthropics/claude-code#21586).
+    statuslineHyperlinks: false,
+    hasSlashCommands: true,
     displayName: "Claude Code",
     binaryName: "claude"
   };
@@ -4478,7 +4525,8 @@ var ClaudeCodeAdapter = class {
       next.statusLine = {
         type: "command",
         command: plan.statuslineCommand,
-        refreshInterval: 2
+        // 1s so the working glyph animates at 1 frame/sec (was 2).
+        refreshInterval: 1
       };
     }
     if (plan.placement === "spinner" || plan.placement === "both") {
@@ -4520,8 +4568,27 @@ var ClaudeCodeAdapter = class {
     const backup = this.backup();
     const { next, diff } = this.merge(plan);
     this.write(next);
+    this.writeSlashCommand();
     return { backup, diff };
   }
+  /** Path of the in-session settings command, e.g. ~/.claude/commands/adsinagents.md. */
+  slashCommandPath() {
+    return join3(claudeConfigDir(), "commands", "adsinagents.md");
+  }
+  /**
+   * Install /adsinagents — the status line itself is display-only, so this is
+   * the in-session settings surface: the user types /adsinagents and Claude
+   * drives the CLI. File is fully ours (sentinel comment), safe to delete on
+   * remove. Best-effort: a failure here never fails install.
+   */
+  writeSlashCommand() {
+    try {
+      const p = this.slashCommandPath();
+      mkdirSync2(dirname2(p), { recursive: true });
+      writeFileSync2(p, SLASH_COMMAND_MD);
+    } catch {
+    }
+  }
   removeInstall() {
     const cur = this.read();
     const marker = cur[ADLINE_SENTINEL];
@@ -4546,6 +4613,13 @@ var ClaudeCodeAdapter = class {
     }
     delete next[ADLINE_SENTINEL];
     this.write(next);
+    try {
+      const p = this.slashCommandPath();
+      if (existsSync2(p) && readFileSync2(p, "utf8").includes(SLASH_SENTINEL)) {
+        rmSync(p);
+      }
+    } catch {
+    }
     return { restored: true };
   }
   /**
@@ -4608,6 +4682,30 @@ var ClaudeCodeAdapter = class {
     return rows;
   }
 };
+var SLASH_SENTINEL = "<!-- adsinagents:managed -->";
+var SLASH_COMMAND_MD = `---
+description: AdsInAgents \u2014 earnings, settings, doctor for the sponsored status line
+allowed-tools: Bash(adsinagents:*)
+---
+${SLASH_SENTINEL}
+
+You manage AdsInAgents (the sponsored status line) for the user via its CLI.
+
+Current state:
+- Config: !\`adsinagents config get\`
+- Stats: !\`adsinagents stats\`
+
+User request: $ARGUMENTS
+
+If the request is empty, show current config + stats and list what can be changed.
+Apply changes with the CLI (never edit config files directly):
+- \`adsinagents config set show-earnings <true|false>\` \u2014 toggle the earnings readout
+- \`adsinagents config set theme <plain|dim|accent>\` \u2014 status line colors (accent = amber mark, bold brand, green earnings; note: Claude Code currently dims all status line colors upstream)
+- \`adsinagents config block <category>\` / \`config unblock <category>\` \u2014 opt out of ad categories (crypto, gambling, alcohol, dating, politics). Best-effort keyword match on the ad's text; a blocked ad is dropped before it shows and is never billed. Run \`config blocked\` to list. Map natural requests like "no crypto ads" to \`config block crypto\`.
+- \`adsinagents doctor\` \u2014 diagnose setup issues
+- \`adsinagents stats\` \u2014 impressions, clicks, balance
+- \`adsinagents remove\` \u2014 uninstall (confirm with the user first)
+`;
 function spinnerVerbsFor(ad) {
   if (!ad)
     return [];
@@ -4845,6 +4943,7 @@ var SessionTracker = class {
   /** session_id -> startedAt ms. A session is live while present here. */
   live = /* @__PURE__ */ new Map();
   lastPromptAtMs = null;
+  lastStopAtMs = null;
   onSessionStart(sessionId, nowMs) {
     this.live.set(sessionId, nowMs);
   }
@@ -4856,7 +4955,16 @@ var SessionTracker = class {
     this.lastPromptAtMs = nowMs;
   }
   /** Stop hook: assistant turn ended. Session stays live (only End closes it). */
-  onStop(_sessionId, _nowMs) {
+  onStop(_sessionId, nowMs) {
+    this.lastStopAtMs = nowMs;
+  }
+  /** Mid-turn: a prompt arrived after the last Stop (Claude is "working"). */
+  working() {
+    if (!this.sessionLive() || this.lastPromptAtMs === null) return false;
+    return this.lastStopAtMs === null || this.lastPromptAtMs > this.lastStopAtMs;
+  }
+  lastStop() {
+    return this.lastStopAtMs;
   }
   sessionLive() {
     return this.live.size > 0;
@@ -4985,15 +5093,21 @@ var AdSource = class {
         id: json.id ?? newImpId(nowMs),
         fetchedAt: nowMs
       });
-      return parsed.success ? parsed.data : void 0;
+      if (!parsed.success) return void 0;
+      if (matchesBlocked(parsed.data, this.cfg.blockedCategories)) return null;
+      return parsed.data;
     } catch {
       return void 0;
     }
   }
   builtinTestAd(nowMs) {
-    const base = BUILTIN_TEST_ADS[this.rotation % BUILTIN_TEST_ADS.length];
-    this.rotation += 1;
-    return AdSchema.parse({ ...base, id: newImpId(nowMs), fetchedAt: nowMs, nonce: "" });
+    for (let i = 0; i < BUILTIN_TEST_ADS.length; i++) {
+      const base = BUILTIN_TEST_ADS[this.rotation % BUILTIN_TEST_ADS.length];
+      this.rotation += 1;
+      const ad = AdSchema.parse({ ...base, id: newImpId(nowMs), fetchedAt: nowMs, nonce: "" });
+      if (!matchesBlocked(ad, this.cfg.blockedCategories)) return ad;
+    }
+    return null;
   }
 };
 
@@ -5254,6 +5368,9 @@ async function main() {
         await fileLog(`ad fetch error: ${String(e)}`);
       }
     }
+    const working = sessions.working();
+    const lastStop = sessions.lastStop();
+    const adDisplayable = working || lastStop !== null && nowMs - lastStop <= cfg.idleGraceSec * 1e3;
     const probe = focus.current();
     const sample = {
       nowMs,
@@ -5262,7 +5379,7 @@ async function main() {
       screenUnlocked: !probe.locked,
       displayAwake: probe.screenAwake,
       disabled,
-      adPresent: currentAd !== null,
+      adPresent: currentAd !== null && adDisplayable,
       lastPromptAtMs: sessions.lastPrompt(),
       adId: currentAd?.id ?? null,
       focusDwellSec: cfg.focusDwellSec,
@@ -5283,11 +5400,12 @@ async function main() {
       schemaVersion: DAEMON_STATE_SCHEMA_VERSION,
       sessionLive,
       disabled,
-      adVisible: !disabled && sessionLive && currentAd !== null,
+      adVisible: !disabled && sessionLive && currentAd !== null && adDisplayable,
       port,
       updatedAt: nowMs,
       balanceCents: earnings.balanceCents,
-      todayCents: earnings.todayCents
+      todayCents: earnings.todayCents,
+      working
     };
     writeDaemonState(state);
     if (tickCount % SYNC_EVERY_TICKS === 0) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "adsinagents",
-  "version": "0.1.0",
-  "description": "Get paid while you build. A terminal-native ad layer for Claude Code that pays you for every verified impression.",
+  "version": "0.1.2",
+  "description": "Get paid while you build. AdsInAgents is the terminal-native ad layer for AI coding agents. Verified impressions pay you.",
   "homepage": "https://adsinagents.com",
   "license": "UNLICENSED",
   "type": "module",

package/statusline/dist/index.js

@@ -4070,6 +4070,17 @@ var coerce = {
 };
 var NEVER = INVALID;
 
+// ../../shared/dist/categories.js
+var CATEGORIES = {
+  crypto: ["crypto", "web3", "blockchain", "nft", "token", "defi", "bitcoin", "ethereum", "wallet"],
+  gambling: ["casino", "betting", "sportsbook", "poker", "lottery", "wager", "slots"],
+  alcohol: ["beer", "whiskey", "whisky", "vodka", "wine", "tequila", "liquor", "cocktail"],
+  dating: ["dating", "hookup", "singles", "match with", "find love"],
+  politics: ["campaign", "vote for", "super pac", "ballot", "elect "]
+};
+var CATEGORY_KEYS = Object.keys(CATEGORIES);
+var CategorySchema = external_exports.enum(CATEGORY_KEYS);
+
 // ../../shared/dist/schemas.js
 var AdSchema = external_exports.object({
   /** Stable impression id for this rotation; idempotency key for firing. */
@@ -4112,6 +4123,7 @@ var GravityAdSchema = external_exports.object({
 });
 var GravityResponseSchema = external_exports.array(GravityAdSchema);
 var PlacementSchema = external_exports.enum(["statusline", "spinner", "both", "off"]);
+var ThemeSchema = external_exports.enum(["plain", "dim", "accent"]);
 var AgentNameSchema = external_exports.enum(["claude-code"]);
 var ConfigSchema = external_exports.object({
   placement: PlacementSchema.default("statusline"),
@@ -4121,8 +4133,16 @@ var ConfigSchema = external_exports.object({
   production: external_exports.boolean().default(false),
   /** Send prompt text to Gravity for contextual matching. PRIVACY: off by default. */
   contextualAds: external_exports.boolean().default(false),
-  /** AdLine server base URL the daemon polls for ads / sync / flags. */
-  serverUrl: external_exports.string().default("http://127.0.0.1:3000"),
+  /**
+   * Ad categories the user opted out of. Best-effort keyword match on the ad's
+   * own text/brand, applied client-side in the daemon — a matched ad is dropped
+   * before it paints (no impression, not billed). See shared/src/categories.ts.
+   */
+  blockedCategories: external_exports.array(CategorySchema).default([]),
+  /** AdLine server base URL the daemon polls for ads / sync / flags.
+   *  Defaults to production — a fresh `npm i -g adsinagents` install must work
+   *  with zero config. Local dev: set serverUrl in ~/.adsinagents/config.json. */
+  serverUrl: external_exports.string().default("https://adsinagents.com"),
   /** Device bearer token minted by `adsinagents init` (server /api/register). */
   deviceToken: external_exports.string().default(""),
   /** Stable per-install device id. */
@@ -4137,10 +4157,18 @@ var ConfigSchema = external_exports.object({
   rateCapSec: external_exports.number().int().positive().default(60),
   /** Continuous focus seconds required before an impression verifies. */
   focusDwellSec: external_exports.number().int().positive().default(5),
+  /**
+   * Seconds the ad stays painted after a turn ends (Stop hook). Past the grace
+   * the status line goes clean until the next prompt. 0 = hide on Stop.
+   * Display AND billing follow this gate together (billed ⇒ on screen).
+   */
+  idleGraceSec: external_exports.number().int().nonnegative().default(120),
   /** Remote kill-switch flag URL (optional; falls back to serverUrl/api/flags). */
   killSwitchUrl: external_exports.string().default(""),
   /** Show a live earnings segment in the status line (separate from the ad). Off by default. */
-  showEarnings: external_exports.boolean().default(false)
+  showEarnings: external_exports.boolean().default(false),
+  /** Terminal styling for ad/earnings segments. Plain (no ANSI) by default. */
+  theme: ThemeSchema.default("plain")
 });
 var DEFAULT_CONFIG = ConfigSchema.parse({});
 var DaemonStateSchema = external_exports.object({
@@ -4159,7 +4187,10 @@ var DaemonStateSchema = external_exports.object({
   /** Publisher lifetime balance, cents. From the last sync response. Optional. */
   balanceCents: external_exports.number().int().nonnegative().default(0),
   /** Earnings today, cents. From the last sync response. Optional. */
-  todayCents: external_exports.number().int().nonnegative().default(0)
+  todayCents: external_exports.number().int().nonnegative().default(0),
+  /** Claude is mid-turn (prompt received, Stop not yet). Drives the statusline
+   *  working glyph. Additive — older daemons omit it. */
+  working: external_exports.boolean().default(false)
 });
 var ImpressionSchema = external_exports.object({
   id: external_exports.string(),
@@ -4189,19 +4220,41 @@ var FocusProbeSchema = external_exports.object({
 function osc8(url, text) {
   return `\x1B]8;;${url}\x07${text}\x1B]8;;\x07`;
 }
+var ID = (s) => s;
+var DIM = (s) => `\x1B[2m${s}\x1B[22m`;
+var BOLD = (s) => `\x1B[1m${s}\x1B[22m`;
+var GREEN = (s) => `\x1B[32m${s}\x1B[39m`;
+var AMBER = (s) => `\x1B[38;5;215m${s}\x1B[39m`;
+var THEMES = {
+  plain: { disclosure: ID, mark: ID, brand: ID, money: ID },
+  dim: { disclosure: DIM, mark: ID, brand: ID, money: ID },
+  accent: { disclosure: DIM, mark: AMBER, brand: BOLD, money: GREEN }
+};
+var MAX_AD_TEXT = 60;
 function renderAdSegment(ad, opts) {
-  const star = "\u2736";
-  const arrow = "\u2197";
-  const label = ad.brandName ? `${ad.text} \xB7 ${ad.brandName}` : ad.text;
-  const core = `${star} ${label} ${arrow}`;
+  const t = THEMES[opts.theme ?? "plain"];
+  const star = t.mark("\u2736");
+  const arrow = t.mark("\u2197");
+  const text = ad.text.length > MAX_AD_TEXT ? ad.text.slice(0, MAX_AD_TEXT - 1).trimEnd() + "\u2026" : ad.text;
+  const label = ad.brandName ? `${text} \xB7 ${t.brand(ad.brandName)}` : text;
   const clickUrl = `${opts.clickBase}/click/${encodeURIComponent(ad.id)}`;
-  const linked = opts.supportsOsc8 ? osc8(clickUrl, core) : core;
-  return `Ad: ${linked} \xB7 sponsored`;
+  const linked = opts.supportsOsc8 ? osc8(clickUrl, `${star} ${label} ${arrow}`) : opts.plainLink ? `${star} ${label} \xB7 ${opts.plainLink} ${arrow}` : `${star} ${label} ${arrow}`;
+  return `${t.disclosure("Ad:")} ${linked} ${t.disclosure("\xB7 sponsored")}`;
 }
-function renderEarningsSegment(balanceCents, todayCents) {
-  const d = (c) => `$${(Math.max(0, c) / 100).toFixed(2)}`;
+function renderEarningsSegment(balanceCents, todayCents, theme = "plain") {
+  const t = THEMES[theme];
+  const d = (c) => t.money(`$${(Math.max(0, c) / 100).toFixed(2)}`);
   return `${d(todayCents)} today \xB7 ${d(balanceCents)}`;
 }
+function renderLoadingSegment(theme = "plain") {
+  const s = "Ad: loading\u2026";
+  return theme === "plain" ? s : DIM(s);
+}
+var WORKING_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+function workingGlyph(nowMs, theme = "plain") {
+  const frame = WORKING_FRAMES[Math.floor(nowMs / 1e3) % WORKING_FRAMES.length];
+  return THEMES[theme ?? "plain"].mark(frame);
+}
 function composeStatusLine(priorOutput, ...segments) {
   const parts = [priorOutput.trim(), ...segments.map((s) => s.trim())].filter(Boolean);
   return parts.join(" \u2502 ");
@@ -4215,6 +4268,32 @@ import { execFile, execFileSync } from "node:child_process";
 import { promisify } from "node:util";
 var pExecFile = promisify(execFile);
 
+// ../../shared/dist/agent/claude-code.js
+var SLASH_SENTINEL = "<!-- adsinagents:managed -->";
+var SLASH_COMMAND_MD = `---
+description: AdsInAgents \u2014 earnings, settings, doctor for the sponsored status line
+allowed-tools: Bash(adsinagents:*)
+---
+${SLASH_SENTINEL}
+
+You manage AdsInAgents (the sponsored status line) for the user via its CLI.
+
+Current state:
+- Config: !\`adsinagents config get\`
+- Stats: !\`adsinagents stats\`
+
+User request: $ARGUMENTS
+
+If the request is empty, show current config + stats and list what can be changed.
+Apply changes with the CLI (never edit config files directly):
+- \`adsinagents config set show-earnings <true|false>\` \u2014 toggle the earnings readout
+- \`adsinagents config set theme <plain|dim|accent>\` \u2014 status line colors (accent = amber mark, bold brand, green earnings; note: Claude Code currently dims all status line colors upstream)
+- \`adsinagents config block <category>\` / \`config unblock <category>\` \u2014 opt out of ad categories (crypto, gambling, alcohol, dating, politics). Best-effort keyword match on the ad's text; a blocked ad is dropped before it shows and is never billed. Run \`config blocked\` to list. Map natural requests like "no crypto ads" to \`config block crypto\`.
+- \`adsinagents doctor\` \u2014 diagnose setup issues
+- \`adsinagents stats\` \u2014 impressions, clicks, balance
+- \`adsinagents remove\` \u2014 uninstall (confirm with the user first)
+`;
+
 // ../statusline/src/index.ts
 var STATE_STALE_MS = 3e4;
 function readJson(path) {
@@ -4225,11 +4304,15 @@ function readJson(path) {
     return null;
   }
 }
-function terminalSupportsOsc8() {
-  if (process.env.FORCE_HYPERLINK === "1") return true;
-  const term = process.env.TERM_PROGRAM ?? "";
-  if (term === "Apple_Terminal") return false;
-  return true;
+function hostPreservesOsc8() {
+  return process.env.FORCE_HYPERLINK === "1";
+}
+function plainClickLink(ad, serverUrl, clickBase) {
+  const localServer = /127\.0\.0\.1|localhost/.test(serverUrl);
+  if (ad.source === "direct" && !localServer) {
+    return `${serverUrl.replace(/\/$/, "")}/c/${encodeURIComponent(ad.campaignId)}`;
+  }
+  return `${clickBase}/click/${encodeURIComponent(ad.id)}`;
 }
 function priorStatusline(stdinJson) {
   const cmd = process.env.ADSINAGENTS_PRIOR_STATUSLINE;
@@ -4263,20 +4346,23 @@ function main() {
   const stale = Date.now() - state.updatedAt > STATE_STALE_MS;
   const cfg = ConfigSchema.safeParse(readJson(PATHS.config));
   const showEarnings = cfg.success && cfg.data.showEarnings;
-  const earningsSeg = showEarnings && state.sessionLive && !stale ? renderEarningsSegment(state.balanceCents, state.todayCents) : "";
-  if (stale || state.disabled || !state.adVisible) {
-    process.stdout.write(composeStatusLine(prior, earningsSeg) + "\n");
-    return;
-  }
+  const theme = cfg.success ? cfg.data.theme : "plain";
+  const earningsSeg = showEarnings && state.sessionLive && !stale ? renderEarningsSegment(state.balanceCents, state.todayCents, theme) : "";
   const adParsed = AdSchema.safeParse(readJson(PATHS.currentAd));
-  if (!adParsed.success) {
-    process.stdout.write(composeStatusLine(prior, earningsSeg) + "\n");
+  if (stale || state.disabled || !state.adVisible || !adParsed.success) {
+    const loadingSeg = !stale && !state.disabled && state.working && !adParsed.success ? renderLoadingSegment(theme) : "";
+    process.stdout.write(composeStatusLine(prior, loadingSeg, earningsSeg) + "\n");
     return;
   }
+  const clickBase = `http://127.0.0.1:${state.port}`;
+  const serverUrl = cfg.success ? cfg.data.serverUrl : "";
   const adSeg = renderAdSegment(adParsed.data, {
-    clickBase: `http://127.0.0.1:${state.port}`,
-    supportsOsc8: terminalSupportsOsc8()
+    clickBase,
+    supportsOsc8: hostPreservesOsc8(),
+    plainLink: plainClickLink(adParsed.data, serverUrl, clickBase),
+    theme
   });
-  process.stdout.write(composeStatusLine(prior, adSeg, earningsSeg) + "\n");
+  const seg = state.working ? `${workingGlyph(Date.now(), theme)} ${adSeg}` : adSeg;
+  process.stdout.write(composeStatusLine(prior, seg, earningsSeg) + "\n");
 }
 main();