@sleds/cli 0.1.17 → 0.1.18

package/dist/sleds.mjs

@@ -514,6 +514,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 +523,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 +534,30 @@ __export(exports_seat, {
   postSeatWindow: () => postSeatWindow2,
   readSeatState: () => readSeatState2,
   readStdin: () => readStdin2,
+  scanTranscriptForCredits: () => scanTranscriptForCredits2,
   seatSessionFromStdin: () => seatSessionFromStdin2,
   seatStatePath: () => seatStatePath2,
-  seatWallDue: () => seatWallDue2,
+  seatWallBanner: () => seatWallBanner2,
+  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);
@@ -613,7 +631,7 @@ var SEAT_POST_MIN_DELTA_PCT2 = 1, SEAT_POST_MIN_INTERVAL_MS2, SEAT_POST_TIMEOUT_
   if (parts.length === 0)
     return null;
   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 +664,32 @@ 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.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 +781,92 @@ 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 } };
+  }
+}, seatWallBanner2 = (e, hasUpstreamKey, now) => {
+  const label = {
+    fiveHour: "5-hour",
+    sevenDay: "weekly",
+    spendLimit: "spend",
+    credits: "usage credits"
+  }[e.bar];
+  const mins = Math.max(1, Math.round((e.resetsAt - now) / 60000));
+  const reset = e.bar === "credits" ? "" : mins < 60 ? ` · resets in ${mins} min` : ` · resets in ${Math.floor(mins / 60)} h ${mins % 60 ? `${mins % 60} min` : ""}`.trimEnd();
+  const exits = hasUpstreamKey ? "/sled handoff · sleds defer · sleds on" : "/sled handoff · sleds defer (no platform key here)";
+  if (e.stage === "approaching")
+    return `Seat ${label} at ${Math.round(e.usedPct)}%${reset}. Plan the exit now: ${exits}`;
+  if (e.bar === "credits")
+    return `Out of usage credits. ${exits}`;
+  return `Seat ${label} limit hit${reset}. ${exits}`;
 }, seatWindowBody2 = (w) => ({
   capturedAt: w.capturedAt,
   ...w.fiveHour ? { fiveHour: w.fiveHour } : {},
@@ -786,6 +912,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 +1282,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;
@@ -1241,6 +1378,7 @@ var formatSeatFragment = (w) => {
     return null;
   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 +1414,32 @@ 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.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 +1540,94 @@ 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 seatWallBanner = (e, hasUpstreamKey, now) => {
+  const label = {
+    fiveHour: "5-hour",
+    sevenDay: "weekly",
+    spendLimit: "spend",
+    credits: "usage credits"
+  }[e.bar];
+  const mins = Math.max(1, Math.round((e.resetsAt - now) / 60000));
+  const reset = e.bar === "credits" ? "" : mins < 60 ? ` · resets in ${mins} min` : ` · resets in ${Math.floor(mins / 60)} h ${mins % 60 ? `${mins % 60} min` : ""}`.trimEnd();
+  const exits = hasUpstreamKey ? "/sled handoff · sleds defer · sleds on" : "/sled handoff · sleds defer (no platform key here)";
+  if (e.stage === "approaching")
+    return `Seat ${label} at ${Math.round(e.usedPct)}%${reset}. Plan the exit now: ${exits}`;
+  if (e.bar === "credits")
+    return `Out of usage credits. ${exits}`;
+  return `Seat ${label} limit hit${reset}. ${exits}`;
 };
 var seatWindowBody = (w) => ({
   capturedAt: w.capturedAt,
@@ -4222,7 +4470,7 @@ 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 ESTIMATE_TIMEOUT_MS = 4000;
@@ -4276,7 +4524,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 {
@@ -4453,7 +4701,25 @@ var status = async (o) => {
 };
 
 // src/commands/statusline.ts
+init_config();
 init_meter();
+
+// src/commands/seatEvent.ts
+init_config();
+init_meter();
+var NOTIFICATION_TITLE2 = "sleds";
+var osascriptArgs2 = (title, body) => [
+  "-e",
+  "on run argv",
+  "-e",
+  "display notification (item 2 of argv) with title (item 1 of argv)",
+  "-e",
+  "end run",
+  title,
+  body
+];
+
+// src/commands/statusline.ts
 var statusline = async (o) => {
   const log = o.log ?? console.log;
   const now = (o.now ?? Date.now)();
@@ -4463,9 +4729,21 @@ 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], now);
+    }
   } catch {}
   const seatFragment = formatSeatFragment(window);
   let line;
@@ -4484,27 +4762,58 @@ 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 (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, now));
+  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, now) => {
+  if (events.length === 0)
+    return [];
+  const src = meterSource(o.home);
+  const hasKey = readConfig(o.home).org?.capabilities.upstreamKey !== false;
+  const platform2 = o.platform ?? process.platform;
+  const posts = [];
+  for (const e of events) {
+    if (platform2 === "darwin" && o.exec) {
+      try {
+        o.exec("osascript", osascriptArgs2(NOTIFICATION_TITLE2, seatWallBanner(e, hasKey, now)));
+      } catch {}
     }
-    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)
+      posts.push(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"
       }));
-    }
   }
-  writeSeatState(o.home, state);
   return posts;
 };
 
@@ -5043,7 +5352,7 @@ var main = async (argv) => {
     case "seat-sync":
       return seatSync({ home, argv: process.argv.slice(3) });
     case "statusline":
-      return statusline({ home });
+      return statusline({ home, platform: platform2(), exec: defaultExec });
     case "help":
     case "--help":
     case "-h":
@@ -5052,7 +5361,7 @@ var main = async (argv) => {
     case "version":
     case "--version":
     case "-v":
-      console.log("sleds 0.1.17");
+      console.log("sleds 0.1.18");
       return 0;
     default:
       console.error(`unknown command: ${cmd}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleds/cli",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "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",