@sleds/cli 0.1.17 → 0.1.19

package/dist/sleds.mjs

@@ -152,7 +152,24 @@ var BASE_URL_KEY = "ANTHROPIC_BASE_URL", AUTH_TOKEN_KEY = "ANTHROPIC_AUTH_TOKEN"
   if (!list.some(isSledsSpecHook))
     return { ...settings };
   return withEventHooks(settings, POST_TOOL_EVENT, list.filter((e) => !isSledsSpecHook(e)));
-}, hasSpecHook = (settings) => eventHooks(settings, POST_TOOL_EVENT).some(isSledsSpecHook), isSeatToken = (token) => /^sled_[A-Za-z0-9_-]+$/.test(token), maskToken = (token) => token.length <= 9 ? `${token.slice(0, 5)}…` : `${token.slice(0, 9)}…`, serialize = (settings) => `${JSON.stringify(settings, null, 2)}
+}, hasSpecHook = (settings) => eventHooks(settings, POST_TOOL_EVENT).some(isSledsSpecHook), PROMPT_EVENT = "UserPromptSubmit", PROMPT_EVENT_TIMEOUT_S = 3, isSledsPromptHook = (entry) => {
+  if (!isObject(entry) || !Array.isArray(entry.hooks))
+    return false;
+  return entry.hooks.some((h) => isObject(h) && h.type === "command" && typeof h.command === "string" && /\bprompt-event\b/.test(h.command));
+}, promptHookEntry = (command) => ({
+  hooks: [{ type: "command", command, timeout: PROMPT_EVENT_TIMEOUT_S }]
+}), applyPromptHook = (settings, command) => {
+  const list = eventHooks(settings, PROMPT_EVENT);
+  const idx = list.findIndex(isSledsPromptHook);
+  const entry = promptHookEntry(command);
+  const next = idx === -1 ? [...list, entry] : list.map((e, i) => i === idx ? entry : e);
+  return withEventHooks(settings, PROMPT_EVENT, next);
+}, removePromptHook = (settings) => {
+  const list = eventHooks(settings, PROMPT_EVENT);
+  if (!list.some(isSledsPromptHook))
+    return { ...settings };
+  return withEventHooks(settings, PROMPT_EVENT, list.filter((e) => !isSledsPromptHook(e)));
+}, hasPromptHook = (settings) => eventHooks(settings, PROMPT_EVENT).some(isSledsPromptHook), isSeatToken = (token) => /^sled_[A-Za-z0-9_-]+$/.test(token), maskToken = (token) => token.length <= 9 ? `${token.slice(0, 5)}…` : `${token.slice(0, 9)}…`, serialize = (settings) => `${JSON.stringify(settings, null, 2)}
 `, hasClaudeCode = (home) => existsSync(claudeDir(home)), readSettings = (home) => {
   const p = settingsPath(home);
   if (!existsSync(p))
@@ -514,6 +531,8 @@ var init_meter = __esm(() => {
 // src/seat.ts
 var exports_seat = {};
 __export(exports_seat, {
+  APPROACHING_PCT: () => APPROACHING_PCT2,
+  CREDITS_PATTERN: () => CREDITS_PATTERN2,
   SEAT_POST_MIN_DELTA_PCT: () => SEAT_POST_MIN_DELTA_PCT2,
   SEAT_POST_MIN_INTERVAL_MS: () => SEAT_POST_MIN_INTERVAL_MS2,
   SEAT_POST_TIMEOUT_MS: () => SEAT_POST_TIMEOUT_MS2,
@@ -521,8 +540,10 @@ __export(exports_seat, {
   SEAT_WALL_LINE_NO_KEY: () => SEAT_WALL_LINE_NO_KEY2,
   STDIN_TIMEOUT_MS: () => STDIN_TIMEOUT_MS2,
   bindingResetAt: () => bindingResetAt2,
+  creditsHitIn: () => creditsHitIn2,
   formatSeatFragment: () => formatSeatFragment2,
   markPosted: () => markPosted2,
+  markWarned: () => markWarned2,
   parseResetsAt: () => parseResetsAt2,
   parseSeatState: () => parseSeatState2,
   parseSeatWindow: () => parseSeatWindow2,
@@ -530,16 +551,29 @@ __export(exports_seat, {
   postSeatWindow: () => postSeatWindow2,
   readSeatState: () => readSeatState2,
   readStdin: () => readStdin2,
+  scanTranscriptForCredits: () => scanTranscriptForCredits2,
   seatSessionFromStdin: () => seatSessionFromStdin2,
   seatStatePath: () => seatStatePath2,
-  seatWallDue: () => seatWallDue2,
+  seatWallDue: () => seatWallDue,
+  seatWallEvents: () => seatWallEvents2,
   seatWallLine: () => seatWallLine2,
   seatWindowBody: () => seatWindowBody2,
   seatWindowFromStdin: () => seatWindowFromStdin2,
   shouldPostSeat: () => shouldPostSeat2,
+  transcriptPathFromStdin: () => transcriptPathFromStdin2,
   writeSeatState: () => writeSeatState2
 });
-import { existsSync as existsSync16, mkdirSync as mkdirSync13, readFileSync as readFileSync13, renameSync as renameSync6, writeFileSync as writeFileSync13 } from "node:fs";
+import {
+  closeSync as closeSync2,
+  existsSync as existsSync16,
+  mkdirSync as mkdirSync13,
+  openSync as openSync2,
+  readFileSync as readFileSync13,
+  readSync as readSync2,
+  renameSync as renameSync6,
+  statSync as statSync3,
+  writeFileSync as writeFileSync13
+} from "node:fs";
 import { join as join14 } from "node:path";
 var SEAT_POST_MIN_DELTA_PCT2 = 1, SEAT_POST_MIN_INTERVAL_MS2, SEAT_POST_TIMEOUT_MS2 = 1500, STDIN_TIMEOUT_MS2 = 300, isObject11 = (v) => typeof v === "object" && v !== null && !Array.isArray(v), num6 = (v) => typeof v === "number" && Number.isFinite(v) ? v : undefined, EPOCH_MS_THRESHOLD2 = 100000000000, parseResetsAt2 = (v) => {
   const n = num6(v);
@@ -600,7 +634,7 @@ var SEAT_POST_MIN_DELTA_PCT2 = 1, SEAT_POST_MIN_INTERVAL_MS2, SEAT_POST_TIMEOUT_
   } catch {
     return null;
   }
-}, formatSeatFragment2 = (w) => {
+}, formatSeatFragment2 = (w, now = Date.now()) => {
   if (!w)
     return null;
   const parts = [];
@@ -612,8 +646,19 @@ var SEAT_POST_MIN_DELTA_PCT2 = 1, SEAT_POST_MIN_INTERVAL_MS2, SEAT_POST_TIMEOUT_
     parts.push(`spend ${Math.round(w.spendLimit.usedPct)}%`);
   if (parts.length === 0)
     return null;
+  const hot = [
+    ["wk", w.sevenDay],
+    ["5h", w.fiveHour],
+    ["spend", w.spendLimit]
+  ].filter((x) => x[1] !== undefined && x[1].usedPct >= APPROACHING_PCT2).sort((a, b) => b[1].usedPct - a[1].usedPct)[0];
+  if (hot) {
+    const mins = Math.max(0, Math.round((hot[1].resetsAt - now) / 60000));
+    const reset = mins >= 60 ? `${Math.floor(mins / 60)}h${mins % 60 ? `${mins % 60}m` : ""}` : `${mins}m`;
+    const verb = hot[1].usedPct >= 100 ? "at the wall" : `${Math.round(hot[1].usedPct)}%`;
+    return `⚠ seat ${hot[0]} ${verb}${SEP}resets ${reset}${SEP}/sled handoff · sleds defer`;
+  }
   return `seat ${parts.join(SEP)}`;
-}, seatStatePath2 = (home) => join14(configDir(home), "seat.json"), parseWindowStored2 = (v) => {
+}, APPROACHING_PCT2 = 90, seatStatePath2 = (home) => join14(configDir(home), "seat.json"), parseWindowStored2 = (v) => {
   if (!isObject11(v))
     return;
   const capturedAt = num6(v.capturedAt);
@@ -646,6 +691,49 @@ var SEAT_POST_MIN_DELTA_PCT2 = 1, SEAT_POST_MIN_INTERVAL_MS2, SEAT_POST_TIMEOUT_
   const lastWallResetsAt = num6(raw.lastWallResetsAt);
   if (lastWallResetsAt !== undefined)
     out.lastWallResetsAt = lastWallResetsAt;
+  if (isObject11(raw.warned)) {
+    const warned = {};
+    for (const bar of ["fiveHour", "sevenDay", "spendLimit", "credits"]) {
+      const w = raw.warned[bar];
+      if (!isObject11(w))
+        continue;
+      const entry = {};
+      const ap = num6(w.approaching);
+      const hit = num6(w.hit);
+      if (ap !== undefined)
+        entry.approaching = ap;
+      if (hit !== undefined)
+        entry.hit = hit;
+      warned[bar] = entry;
+    }
+    out.warned = warned;
+  }
+  if (isObject11(raw.told)) {
+    const told = {};
+    for (const bar of ["fiveHour", "sevenDay", "spendLimit", "credits"]) {
+      const w = raw.told[bar];
+      if (!isObject11(w))
+        continue;
+      const entry = {};
+      const ap = num6(w.approaching);
+      const hit = num6(w.hit);
+      if (ap !== undefined)
+        entry.approaching = ap;
+      if (hit !== undefined)
+        entry.hit = hit;
+      told[bar] = entry;
+    }
+    out.told = told;
+  }
+  if (isObject11(raw.transcriptScan) && typeof raw.transcriptScan.path === "string") {
+    const offset = num6(raw.transcriptScan.offset);
+    const hitAt = num6(raw.transcriptScan.hitAt);
+    out.transcriptScan = {
+      path: raw.transcriptScan.path,
+      offset: offset ?? 0,
+      ...hitAt !== undefined ? { hitAt } : {}
+    };
+  }
   const session = parseSeatSession2(raw.session);
   if (session)
     out.session = session;
@@ -737,10 +825,77 @@ var SEAT_POST_MIN_DELTA_PCT2 = 1, SEAT_POST_MIN_INTERVAL_MS2, SEAT_POST_TIMEOUT_
   if (w.spendLimit)
     lastPosted.spendLimit = w.spendLimit.usedPct;
   return { ...state, window: w, lastPostedAt: now, lastPosted };
-}, seatWallDue2 = (state, w) => {
+}, seatWallDue = (state, w) => {
   if (!w?.sevenDay || w.sevenDay.usedPct < 100)
     return false;
   return state.lastWallResetsAt === undefined || state.lastWallResetsAt < w.sevenDay.resetsAt;
+}, seatWallEvents2 = (state, w) => {
+  if (!w)
+    return [];
+  const out = [];
+  const bars = [
+    ["fiveHour", w.fiveHour],
+    ["sevenDay", w.sevenDay],
+    ["spendLimit", w.spendLimit]
+  ];
+  for (const [bar, b] of bars) {
+    if (!b)
+      continue;
+    const seen = state.warned?.[bar] ?? {};
+    const weeklyOld = bar === "sevenDay" && state.lastWallResetsAt !== undefined && state.lastWallResetsAt >= b.resetsAt;
+    if (b.usedPct >= APPROACHING_PCT2 && (seen.approaching ?? -1) < b.resetsAt && !weeklyOld)
+      out.push({ bar, stage: "approaching", usedPct: b.usedPct, resetsAt: b.resetsAt });
+    if (b.usedPct >= 100 && (seen.hit ?? -1) < b.resetsAt && !weeklyOld)
+      out.push({ bar, stage: "hit", usedPct: b.usedPct, resetsAt: b.resetsAt });
+  }
+  return out;
+}, markWarned2 = (state, events) => {
+  if (events.length === 0)
+    return state;
+  const warned = { ...state.warned ?? {} };
+  let lastWallResetsAt = state.lastWallResetsAt;
+  for (const e of events) {
+    warned[e.bar] = { ...warned[e.bar] ?? {}, [e.stage]: e.resetsAt };
+    if (e.bar === "sevenDay" && e.stage === "hit")
+      lastWallResetsAt = e.resetsAt;
+  }
+  return { ...state, warned, ...lastWallResetsAt !== undefined ? { lastWallResetsAt } : {} };
+}, CREDITS_PATTERN2, creditsHitIn2 = (text) => CREDITS_PATTERN2.test(text), transcriptPathFromStdin2 = (text) => {
+  try {
+    const raw = JSON.parse(text.trim());
+    return isObject11(raw) && typeof raw.transcript_path === "string" && raw.transcript_path ? raw.transcript_path : null;
+  } catch {
+    return null;
+  }
+}, scanTranscriptForCredits2 = (path, prior) => {
+  const from = prior && prior.path === path ? prior.offset : 0;
+  try {
+    const size = statSync3(path).size;
+    if (size <= from)
+      return {
+        hit: false,
+        next: { path, offset: size, ...prior?.hitAt ? { hitAt: prior.hitAt } : {} }
+      };
+    const start = Math.max(from, size - 256 * 1024);
+    const fd = openSync2(path, "r");
+    try {
+      const buf = Buffer.alloc(size - start);
+      readSync2(fd, buf, 0, buf.length, start);
+      const hit = creditsHitIn2(buf.toString("utf8"));
+      return {
+        hit,
+        next: {
+          path,
+          offset: size,
+          ...hit ? { hitAt: Date.now() } : prior?.hitAt ? { hitAt: prior.hitAt } : {}
+        }
+      };
+    } finally {
+      closeSync2(fd);
+    }
+  } catch {
+    return { hit: false, next: prior && prior.path === path ? prior : { path, offset: 0 } };
+  }
 }, seatWindowBody2 = (w) => ({
   capturedAt: w.capturedAt,
   ...w.fiveHour ? { fiveHour: w.fiveHour } : {},
@@ -786,6 +941,7 @@ var init_seat = __esm(() => {
   init_config();
   init_meter();
   SEAT_POST_MIN_INTERVAL_MS2 = 5 * 60000;
+  CREDITS_PATTERN2 = /out of usage credits|cc_cli_limit_message/i;
 });
 
 // src/index.ts
@@ -1155,7 +1311,17 @@ var parsePayload = (payload) => {
 // src/seat.ts
 init_config();
 init_meter();
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync5, renameSync as renameSync4, writeFileSync as writeFileSync5 } from "node:fs";
+import {
+  closeSync,
+  existsSync as existsSync5,
+  mkdirSync as mkdirSync5,
+  openSync,
+  readFileSync as readFileSync5,
+  readSync,
+  renameSync as renameSync4,
+  statSync,
+  writeFileSync as writeFileSync5
+} from "node:fs";
 import { join as join6 } from "node:path";
 var SEAT_POST_MIN_DELTA_PCT = 1;
 var SEAT_POST_MIN_INTERVAL_MS = 5 * 60000;
@@ -1227,7 +1393,7 @@ var seatWindowFromStdin = (text, capturedAt) => {
     return null;
   }
 };
-var formatSeatFragment = (w) => {
+var formatSeatFragment = (w, now = Date.now()) => {
   if (!w)
     return null;
   const parts = [];
@@ -1239,8 +1405,20 @@ var formatSeatFragment = (w) => {
     parts.push(`spend ${Math.round(w.spendLimit.usedPct)}%`);
   if (parts.length === 0)
     return null;
+  const hot = [
+    ["wk", w.sevenDay],
+    ["5h", w.fiveHour],
+    ["spend", w.spendLimit]
+  ].filter((x) => x[1] !== undefined && x[1].usedPct >= APPROACHING_PCT).sort((a, b) => b[1].usedPct - a[1].usedPct)[0];
+  if (hot) {
+    const mins = Math.max(0, Math.round((hot[1].resetsAt - now) / 60000));
+    const reset = mins >= 60 ? `${Math.floor(mins / 60)}h${mins % 60 ? `${mins % 60}m` : ""}` : `${mins}m`;
+    const verb = hot[1].usedPct >= 100 ? "at the wall" : `${Math.round(hot[1].usedPct)}%`;
+    return `⚠ seat ${hot[0]} ${verb}${SEP}resets ${reset}${SEP}/sled handoff · sleds defer`;
+  }
   return `seat ${parts.join(SEP)}`;
 };
+var APPROACHING_PCT = 90;
 var seatStatePath = (home) => join6(configDir(home), "seat.json");
 var parseWindowStored = (v) => {
   if (!isObject5(v))
@@ -1276,6 +1454,49 @@ var parseSeatState = (raw) => {
   const lastWallResetsAt = num3(raw.lastWallResetsAt);
   if (lastWallResetsAt !== undefined)
     out.lastWallResetsAt = lastWallResetsAt;
+  if (isObject5(raw.warned)) {
+    const warned = {};
+    for (const bar of ["fiveHour", "sevenDay", "spendLimit", "credits"]) {
+      const w = raw.warned[bar];
+      if (!isObject5(w))
+        continue;
+      const entry = {};
+      const ap = num3(w.approaching);
+      const hit = num3(w.hit);
+      if (ap !== undefined)
+        entry.approaching = ap;
+      if (hit !== undefined)
+        entry.hit = hit;
+      warned[bar] = entry;
+    }
+    out.warned = warned;
+  }
+  if (isObject5(raw.told)) {
+    const told = {};
+    for (const bar of ["fiveHour", "sevenDay", "spendLimit", "credits"]) {
+      const w = raw.told[bar];
+      if (!isObject5(w))
+        continue;
+      const entry = {};
+      const ap = num3(w.approaching);
+      const hit = num3(w.hit);
+      if (ap !== undefined)
+        entry.approaching = ap;
+      if (hit !== undefined)
+        entry.hit = hit;
+      told[bar] = entry;
+    }
+    out.told = told;
+  }
+  if (isObject5(raw.transcriptScan) && typeof raw.transcriptScan.path === "string") {
+    const offset = num3(raw.transcriptScan.offset);
+    const hitAt = num3(raw.transcriptScan.hitAt);
+    out.transcriptScan = {
+      path: raw.transcriptScan.path,
+      offset: offset ?? 0,
+      ...hitAt !== undefined ? { hitAt } : {}
+    };
+  }
   const session = parseSeatSession(raw.session);
   if (session)
     out.session = session;
@@ -1376,10 +1597,78 @@ var markPosted = (state, w, now) => {
     lastPosted.spendLimit = w.spendLimit.usedPct;
   return { ...state, window: w, lastPostedAt: now, lastPosted };
 };
-var seatWallDue = (state, w) => {
-  if (!w?.sevenDay || w.sevenDay.usedPct < 100)
-    return false;
-  return state.lastWallResetsAt === undefined || state.lastWallResetsAt < w.sevenDay.resetsAt;
+var seatWallEvents = (state, w) => {
+  if (!w)
+    return [];
+  const out = [];
+  const bars = [
+    ["fiveHour", w.fiveHour],
+    ["sevenDay", w.sevenDay],
+    ["spendLimit", w.spendLimit]
+  ];
+  for (const [bar, b] of bars) {
+    if (!b)
+      continue;
+    const seen = state.warned?.[bar] ?? {};
+    const weeklyOld = bar === "sevenDay" && state.lastWallResetsAt !== undefined && state.lastWallResetsAt >= b.resetsAt;
+    if (b.usedPct >= APPROACHING_PCT && (seen.approaching ?? -1) < b.resetsAt && !weeklyOld)
+      out.push({ bar, stage: "approaching", usedPct: b.usedPct, resetsAt: b.resetsAt });
+    if (b.usedPct >= 100 && (seen.hit ?? -1) < b.resetsAt && !weeklyOld)
+      out.push({ bar, stage: "hit", usedPct: b.usedPct, resetsAt: b.resetsAt });
+  }
+  return out;
+};
+var markWarned = (state, events) => {
+  if (events.length === 0)
+    return state;
+  const warned = { ...state.warned ?? {} };
+  let lastWallResetsAt = state.lastWallResetsAt;
+  for (const e of events) {
+    warned[e.bar] = { ...warned[e.bar] ?? {}, [e.stage]: e.resetsAt };
+    if (e.bar === "sevenDay" && e.stage === "hit")
+      lastWallResetsAt = e.resetsAt;
+  }
+  return { ...state, warned, ...lastWallResetsAt !== undefined ? { lastWallResetsAt } : {} };
+};
+var CREDITS_PATTERN = /out of usage credits|cc_cli_limit_message/i;
+var creditsHitIn = (text) => CREDITS_PATTERN.test(text);
+var transcriptPathFromStdin = (text) => {
+  try {
+    const raw = JSON.parse(text.trim());
+    return isObject5(raw) && typeof raw.transcript_path === "string" && raw.transcript_path ? raw.transcript_path : null;
+  } catch {
+    return null;
+  }
+};
+var scanTranscriptForCredits = (path, prior) => {
+  const from = prior && prior.path === path ? prior.offset : 0;
+  try {
+    const size = statSync(path).size;
+    if (size <= from)
+      return {
+        hit: false,
+        next: { path, offset: size, ...prior?.hitAt ? { hitAt: prior.hitAt } : {} }
+      };
+    const start = Math.max(from, size - 256 * 1024);
+    const fd = openSync(path, "r");
+    try {
+      const buf = Buffer.alloc(size - start);
+      readSync(fd, buf, 0, buf.length, start);
+      const hit = creditsHitIn(buf.toString("utf8"));
+      return {
+        hit,
+        next: {
+          path,
+          offset: size,
+          ...hit ? { hitAt: Date.now() } : prior?.hitAt ? { hitAt: prior.hitAt } : {}
+        }
+      };
+    } finally {
+      closeSync(fd);
+    }
+  } catch {
+    return { hit: false, next: prior && prior.path === path ? prior : { path, offset: 0 } };
+  }
 };
 var seatWindowBody = (w) => ({
   capturedAt: w.capturedAt,
@@ -2671,13 +2960,15 @@ var hooks = (o) => {
   const had = hasSeatHook(settings);
   const hadSpec = hasSpecHook(settings);
   const withSeat = applySeatHook(settings, o.seatEventCommand ?? sledsCommand("seat-event", o.home, o.env));
-  const withSpec = applySpecHook(withSeat, o.specEventCommand ?? sledsCommand("spec-event", o.home, o.env));
+  const hadPrompt = hasPromptHook(settings);
+  const withSpec = applyPromptHook(applySpecHook(withSeat, o.specEventCommand ?? sledsCommand("spec-event", o.home, o.env)), o.promptEventCommand ?? sledsCommand("prompt-event", o.home, o.env));
   const hadLine = o.refreshStatusLine !== false && isSledsStatusLine(withSpec[STATUS_LINE_KEY]);
   writeSettings(o.home, hadLine ? applyStatusLine(withSpec, sledsCommand("statusline", o.home, o.env)).settings : withSpec);
   log(`${had ? "refreshed" : "set"} hooks.Notification (${SEAT_EVENT_MATCHER}) in ${settingsPath(o.home)}`);
   if (hadLine)
     log(`refreshed statusLine in ${settingsPath(o.home)}`);
   log(`${hadSpec ? "refreshed" : "set"} hooks.PostToolUse (${SPEC_EVENT_MATCHER} → estimate spec files) in ${settingsPath(o.home)}`);
+  log(`${hadPrompt ? "refreshed" : "set"} hooks.UserPromptSubmit (the seat speaks up in the session at 90 % and at a wall) in ${settingsPath(o.home)}`);
   return 0;
 };
 
@@ -2832,13 +3123,15 @@ var hooks2 = (o) => {
   const had = hasSeatHook(settings);
   const hadSpec = hasSpecHook(settings);
   const withSeat = applySeatHook(settings, o.seatEventCommand ?? sledsCommand("seat-event", o.home, o.env));
-  const withSpec = applySpecHook(withSeat, o.specEventCommand ?? sledsCommand("spec-event", o.home, o.env));
+  const hadPrompt = hasPromptHook(settings);
+  const withSpec = applyPromptHook(applySpecHook(withSeat, o.specEventCommand ?? sledsCommand("spec-event", o.home, o.env)), o.promptEventCommand ?? sledsCommand("prompt-event", o.home, o.env));
   const hadLine = o.refreshStatusLine !== false && isSledsStatusLine(withSpec[STATUS_LINE_KEY]);
   writeSettings(o.home, hadLine ? applyStatusLine(withSpec, sledsCommand("statusline", o.home, o.env)).settings : withSpec);
   log(`${had ? "refreshed" : "set"} hooks.Notification (${SEAT_EVENT_MATCHER}) in ${settingsPath(o.home)}`);
   if (hadLine)
     log(`refreshed statusLine in ${settingsPath(o.home)}`);
   log(`${hadSpec ? "refreshed" : "set"} hooks.PostToolUse (${SPEC_EVENT_MATCHER} → estimate spec files) in ${settingsPath(o.home)}`);
+  log(`${hadPrompt ? "refreshed" : "set"} hooks.UserPromptSubmit (the seat speaks up in the session at 90 % and at a wall) in ${settingsPath(o.home)}`);
   return 0;
 };
 
@@ -3050,6 +3343,7 @@ var init = async (o) => {
     refreshStatusLine: false,
     seatEventCommand: o.seatEventCommand,
     specEventCommand: o.specEventCommand,
+    promptEventCommand: o.promptEventCommand,
     log: (line) => wrote.push(line),
     error
   });
@@ -3570,6 +3864,93 @@ var on = (o) => {
   return 0;
 };
 
+// src/commands/promptEvent.ts
+init_config();
+
+// src/commands/seatEvent.ts
+init_config();
+init_meter();
+var HOOK_STDIN_TIMEOUT_MS = 1000;
+
+// src/commands/promptEvent.ts
+var LABEL = {
+  fiveHour: "5-hour",
+  sevenDay: "weekly",
+  spendLimit: "spend",
+  credits: "usage credits"
+};
+var fmtIn = (ms) => {
+  const m = Math.max(1, Math.round(ms / 60000));
+  if (m < 60)
+    return `${m} min`;
+  const h = Math.floor(m / 60);
+  const r = m % 60;
+  return r ? `${h} h ${r} min` : `${h} h`;
+};
+var untold = (state) => {
+  const out = [];
+  for (const bar of ["credits", "spendLimit", "sevenDay", "fiveHour"]) {
+    const w = state.warned?.[bar];
+    if (!w)
+      continue;
+    for (const stage of ["hit", "approaching"]) {
+      const at = w[stage];
+      if (at === undefined)
+        continue;
+      if ((state.told?.[bar]?.[stage] ?? -1) >= at)
+        continue;
+      out.push({ bar, stage, resetsAt: at });
+    }
+  }
+  return out;
+};
+var exitsLine = (hasUpstreamKey) => hasUpstreamKey ? "`/sled handoff <what you were doing>` hands the work to a teammate or buddy; `sleds defer` resumes this session at the reset; `sleds on` continues now on the workspace's platform key." : "`/sled handoff <what you were doing>` hands the work to a teammate or buddy; `sleds defer` resumes this session at the reset (this workspace has no platform key to switch to).";
+var approachingContext = (bar, usedPct, resetsAt, hasUpstreamKey, now) => `[SLEDS] This seat is at ${usedPct !== undefined ? `${Math.round(usedPct)}%` : "90%+"} of its ${LABEL[bar]} limit; it resets in ${fmtIn(resetsAt - now)}. Tell the user in one short line before you answer, and offer the exits: ${exitsLine(hasUpstreamKey)} Do not mention this again unless asked.`;
+var hitContext = (bar, resetsAt, hasUpstreamKey, now) => `[SLEDS] This seat hit its ${LABEL[bar]} limit; it resets in ${fmtIn(resetsAt - now)}. If this reply fails or the user is stuck, the exits are: ${exitsLine(hasUpstreamKey)} Say so in one line.`;
+var creditsBlockText = (hasUpstreamKey) => `SLEDS: this seat is out of usage credits — the next reply would fail, so this prompt was not sent. ${hasUpstreamKey ? "Exits: /sled handoff <task> (a buddy picks it up), sleds on (continue on the workspace's platform key), or /model to a cheaper model." : "Exits: /sled handoff <task> (a buddy picks it up), sleds defer (resume when credits are topped up), or /model to a cheaper model."} Re-send your prompt after choosing; SLEDS will not block again.`;
+var promptEvent = async (o) => {
+  const log = o.log ?? console.log;
+  const error = o.error ?? console.error;
+  const now = (o.now ?? Date.now)();
+  if (o.stdin === undefined)
+    await readStdin(HOOK_STDIN_TIMEOUT_MS);
+  let state;
+  try {
+    state = readSeatState(o.home);
+  } catch {
+    return 0;
+  }
+  const pending = untold(state);
+  if (pending.length === 0)
+    return 0;
+  const hasKey = readConfig(o.home).org?.capabilities.upstreamKey !== false;
+  const told = { ...state.told ?? {} };
+  const mark = (bar, stage, at) => {
+    told[bar] = { ...told[bar] ?? {}, [stage]: at };
+  };
+  let code = 0;
+  const lines = [];
+  for (const e of pending) {
+    mark(e.bar, e.stage, e.resetsAt);
+    if (e.bar === "credits") {
+      if (code !== 2) {
+        error(creditsBlockText(hasKey));
+        code = 2;
+      }
+      continue;
+    }
+    const pct = state.window?.[e.bar]?.usedPct;
+    lines.push(e.stage === "approaching" ? approachingContext(e.bar, pct, e.resetsAt, hasKey, now) : hitContext(e.bar, e.resetsAt, hasKey, now));
+  }
+  try {
+    writeSeatState(o.home, { ...state, told });
+  } catch {}
+  if (code === 0 && lines.length > 0)
+    log(lines.join(`
+`));
+  return code;
+};
+
 // src/commands/run.ts
 init_config();
 init_meter();
@@ -3634,8 +4015,7 @@ var run = async (o) => {
 // src/commands/seatEvent.ts
 init_config();
 init_meter();
-var HOOK_STDIN_TIMEOUT_MS = 1000;
-var NOTIFICATION_TITLE = "sleds";
+var HOOK_STDIN_TIMEOUT_MS2 = 1000;
 var isObject8 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var notificationType = (text) => {
   try {
@@ -3647,20 +4027,10 @@ var notificationType = (text) => {
     return;
   }
 };
-var osascriptArgs = (title, body) => [
-  "-e",
-  "on run argv",
-  "-e",
-  "display notification (item 2 of argv) with title (item 1 of argv)",
-  "-e",
-  "end run",
-  title,
-  body
-];
 var seatEvent = async (o) => {
   const log = o.log ?? console.log;
   const now = (o.now ?? Date.now)();
-  const input = o.stdin ?? await readStdin(HOOK_STDIN_TIMEOUT_MS);
+  const input = o.stdin ?? await readStdin(HOOK_STDIN_TIMEOUT_MS2);
   const kind = notificationType(input);
   try {
     const state = readSeatState(o.home);
@@ -3677,11 +4047,6 @@ var seatEvent = async (o) => {
   } catch {}
   const line = seatWallLine(readConfig(o.home).org?.capabilities.upstreamKey !== false);
   log(line);
-  if ((o.platform ?? process.platform) === "darwin" && o.exec) {
-    try {
-      o.exec("osascript", osascriptArgs(NOTIFICATION_TITLE, line));
-    } catch {}
-  }
   return 0;
 };
 
@@ -4222,9 +4587,9 @@ async function postSeat(proxyUrl, token, body, fetchFn) {
 
 // src/commands/specEvent.ts
 init_meter();
-import { readFileSync as readFileSync10, statSync } from "node:fs";
+import { readFileSync as readFileSync10, statSync as statSync2 } from "node:fs";
 import { basename as basename2, isAbsolute, relative } from "node:path";
-var HOOK_STDIN_TIMEOUT_MS2 = 1000;
+var HOOK_STDIN_TIMEOUT_MS3 = 1000;
 var ESTIMATE_TIMEOUT_MS = 4000;
 var MIN_SPEC_CHARS = 200;
 var MAX_SPEC_CHARS = 12000;
@@ -4276,7 +4641,7 @@ function projectKey(filePath, cwd) {
 }
 function readFileOrNull(path) {
   try {
-    if (statSync(path).size > 2000000)
+    if (statSync2(path).size > 2000000)
       return null;
     return readFileSync10(path, "utf8");
   } catch {
@@ -4285,7 +4650,7 @@ function readFileOrNull(path) {
 }
 var specEvent = async (o) => {
   const log = o.log ?? console.log;
-  const raw = o.stdin ?? await readStdin(HOOK_STDIN_TIMEOUT_MS2);
+  const raw = o.stdin ?? await readStdin(HOOK_STDIN_TIMEOUT_MS3);
   const input = raw ? parseHookInput(raw) : null;
   if (!input || !isSpecPath(input.filePath))
     return 0;
@@ -4463,11 +4828,23 @@ var statusline = async (o) => {
   let posts = [];
   try {
     if (window)
-      posts = rememberSeat(o, window, session, now);
-    else if (session)
-      writeSeatState(o.home, { ...readSeatState(o.home), session });
+      posts = rememberSeat(o, window, session, now, input);
+    else {
+      const st = readSeatState(o.home);
+      const credits = creditsEvent(o, st, input, now);
+      if (session || credits.scan) {
+        const next = {
+          ...st,
+          ...session ? { session } : {},
+          ...credits.scan ? { transcriptScan: credits.scan } : {}
+        };
+        writeSeatState(o.home, credits.event ? markWarned(next, [credits.event]) : next);
+      }
+      if (credits.event)
+        posts = announce(o, [credits.event]);
+    }
   } catch {}
-  const seatFragment = formatSeatFragment(window);
+  const seatFragment = formatSeatFragment(window, now);
   let line;
   try {
     const meter2 = await loadMeter({
@@ -4484,29 +4861,50 @@ var statusline = async (o) => {
   await Promise.allSettled(posts);
   return 0;
 };
-var rememberSeat = (o, window, session, now) => {
+var rememberSeat = (o, window, session, now, input) => {
   const prior = readSeatState(o.home);
   let state = { ...prior, window, ...session ? { session } : {} };
   const src = meterSource(o.home);
   const posts = [];
-  if (src) {
-    const opts = { ...src, fetchFn: o.fetchFn, timeoutMs: o.timeoutMs ?? SEAT_POST_TIMEOUT_MS };
-    if (shouldPostSeat(prior, window, now)) {
-      state = markPosted(state, window, now);
-      posts.push(postSeatWindow(opts, window));
-    }
-    if (seatWallDue(prior, window) && window.sevenDay) {
-      state = { ...state, lastWallResetsAt: window.sevenDay.resetsAt };
-      posts.push(postSeatWall(opts, {
-        resetsAt: window.sevenDay.resetsAt,
-        usedPct: window.sevenDay.usedPct,
-        notification: "statusline"
-      }));
-    }
-  }
+  if (src && shouldPostSeat(prior, window, now)) {
+    state = markPosted(state, window, now);
+    posts.push(postSeatWindow({ ...src, fetchFn: o.fetchFn, timeoutMs: o.timeoutMs ?? SEAT_POST_TIMEOUT_MS }, window));
+  }
+  const events = seatWallEvents(prior, window);
+  const credits = creditsEvent(o, prior, input, now);
+  if (credits.scan)
+    state = { ...state, transcriptScan: credits.scan };
+  if (credits.event)
+    events.push(credits.event);
+  state = markWarned(state, events);
+  posts.push(...announce(o, events));
   writeSeatState(o.home, state);
   return posts;
 };
+var creditsEvent = (o, prior, input, now) => {
+  const path = transcriptPathFromStdin(input);
+  if (!path)
+    return { event: null, scan: undefined };
+  const { hit, next } = scanTranscriptForCredits(path, prior.transcriptScan);
+  const recent = prior.warned?.credits?.hit !== undefined && now - prior.warned.credits.hit < 6 * 3600000;
+  if (!hit || recent)
+    return { event: null, scan: next };
+  return { event: { bar: "credits", stage: "hit", usedPct: 100, resetsAt: now }, scan: next };
+};
+var announce = (o, events) => {
+  if (events.length === 0)
+    return [];
+  const src = meterSource(o.home);
+  if (!src)
+    return [];
+  return events.map((e) => postSeatWall({ ...src, fetchFn: o.fetchFn, timeoutMs: o.timeoutMs ?? SEAT_POST_TIMEOUT_MS }, {
+    bar: e.bar,
+    stage: e.stage,
+    usedPct: e.usedPct,
+    ...e.bar === "credits" ? {} : { resetsAt: e.resetsAt },
+    notification: e.bar === "credits" ? "transcript" : "statusline"
+  }));
+};
 
 // src/commands/uninstall.ts
 import { spawnSync as spawnSync4 } from "node:child_process";
@@ -4593,6 +4991,11 @@ var uninstall2 = (o) => {
       changed = true;
       removed.push(`hooks.Notification seat-event entry from ${settingsPath(o.home)}`);
     }
+    if (hasPromptHook(settings)) {
+      settings = removePromptHook(settings);
+      changed = true;
+      removed.push(`hooks.UserPromptSubmit prompt-event entry from ${settingsPath(o.home)}`);
+    }
     if (hasSpecHook(settings)) {
       settings = removeSpecHook(settings);
       changed = true;
@@ -4875,6 +5278,8 @@ commands:
   statusline  Print the one-line meter Claude Code shows (installed by init; 10s cache).
   hooks       Register the Claude Code Notification hook for seat limits (init does this too).
   seat-event  Claude Code hook: record a seat wall and say how to continue. Reads hook JSON on stdin.
+  prompt-event Claude Code UserPromptSubmit hook: at 90 % of a seat bar the seat speaks up in the
+              session (once per bar per reset); out of usage credits blocks the prompt once with the exits.
   spec-event  Claude Code PostToolUse hook: when a spec-shaped markdown file is written, size it
               (POST /proxy/estimate with the file path as the project). Silent unless it estimates.
   --version   Print the CLI version.
@@ -4927,6 +5332,7 @@ var sledsArgv = () => {
 var shellQuote = (s) => /^[\w./-]+$/.test(s) ? s : `'${s.replace(/'/g, "'\\''")}'`;
 var statusLineCommand = (argv, home = homedir()) => withSeatEnv2([...argv, "statusline"].map(shellQuote).join(" "), home);
 var seatEventCommand = (argv, home = homedir()) => withSeatEnv2([...argv, "seat-event"].map(shellQuote).join(" "), home);
+var promptEventCommand = (argv, home = homedir()) => withSeatEnv2([...argv, "prompt-event"].map(shellQuote).join(" "), home);
 var specEventCommand = (argv, home = homedir()) => withSeatEnv2([...argv, "spec-event"].map(shellQuote).join(" "), home);
 var main = async (argv) => {
   const { cmd, flags } = parseArgs(argv);
@@ -4998,19 +5404,23 @@ var main = async (argv) => {
         prompt: promptStdin,
         statusLineCommand: statusLineCommand(sledsArgv()),
         seatEventCommand: seatEventCommand(sledsArgv()),
-        specEventCommand: specEventCommand(sledsArgv())
+        specEventCommand: specEventCommand(sledsArgv()),
+        promptEventCommand: promptEventCommand(sledsArgv())
       });
     }
     case "hooks":
       return hooks({
         home,
         seatEventCommand: seatEventCommand(sledsArgv()),
-        specEventCommand: specEventCommand(sledsArgv())
+        specEventCommand: specEventCommand(sledsArgv()),
+        promptEventCommand: promptEventCommand(sledsArgv())
       });
     case "seat-event":
-      return seatEvent({ home, platform: platform2(), exec: defaultExec });
+      return seatEvent({ home });
     case "spec-event":
       return specEvent({ home });
+    case "prompt-event":
+      return promptEvent({ home });
     case "on":
       return on({
         home,
@@ -5052,7 +5462,7 @@ var main = async (argv) => {
     case "version":
     case "--version":
     case "-v":
-      console.log("sleds 0.1.17");
+      console.log("sleds 0.1.19");
       return 0;
     default:
       console.error(`unknown command: ${cmd}
@@ -5081,6 +5491,7 @@ if (isMain()) {
 }
 export {
   parseArgs,
+  promptEventCommand,
   seatEventCommand,
   specEventCommand,
   statusLineCommand

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleds/cli",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "SLEDS CLI \u2014 the cost and limits of AI agent work, decided at the wall. Point Claude Code at a SLEDS proxy; estimate before you run; hold, switch model, or run overnight when you hit a limit.",
   "license": "UNLICENSED",
   "type": "module",