@hasna/statusline 0.0.6 → 0.0.7

package/README.md

@@ -45,6 +45,8 @@ anything that returns `null` or throws. A failed segment never breaks the host U
 | `auth-email` | off | Account email this session is logged in as | the agent's own login record for this config dir, else the registry | no login recorded | `dev@example.com` |
 | `five-hour-limit` | off | Percentage of the 5-hour rate limit used | `rate_limits.five_hour.used_percentage` | host reports no limit data | `5h:42%` |
 | `seven-day-limit` | off | Percentage of the 7-day rate limit used | `rate_limits.seven_day.used_percentage` | host reports no limit data | `7d:12%` |
+| `usage-session` | off | Session (5-hour) usage **remaining** for this pane's own account | this process's `CLAUDE_CONFIG_DIR` account uuid → the accounts usage cache at `~/.hasna/accounts/cache/usage/<uuid>.json` (kept warm by `@hasna/accounts`; **no cloud call**) | never omitted — shows `5h —` when usage is unknown, missing, stale, or rate-limited | `5h 87%` |
+| `usage-weekly` | off | Weekly usage **remaining** for this pane's own account (the binding limit) | same local usage cache as `usage-session` | never omitted — shows `7d —` when usage is unavailable | `7d 92%` |
 | `thread-title` | off | Thread title set with `/rename` | `session_name` | thread not renamed | `ship it` |
 | `context-used` | off | Percentage of context window used | session transcript JSONL (`contextUsage`) | transcript missing/unreadable | `10%` |
 | `context-remaining` | on | Percentage of context window remaining | transcript via `contextUsage` | transcript missing/unreadable | `90% left` |

package/dist/accounts.d.ts

@@ -49,4 +49,28 @@ export declare function sessionAccount(env?: Env, tool?: string): Promise<Sessio
  * blob, which is large enough to only touch when a segment asks for it.
  */
 export declare function sessionAccountEmail(env?: Env, tool?: string): Promise<string | null>;
+/**
+ * The account uuid the host agent recorded as logged in for this config dir.
+ * Read from the same live state blob `sessionAccountEmail` prefers, so it names
+ * whoever is actually signed in now — the account whose usage the warmer
+ * cached — rather than a registry entry that can lag a re-login or a switch.
+ * Returns null when no record is present or the value is not a safe cache key.
+ */
+export declare function sessionAccountUuid(env?: Env): string | null;
+/** Usage headroom for this session's account, as percent still available. */
+export interface SessionUsage {
+    /** The ~5-hour session window's remaining percent, or null when unknown. */
+    sessionHeadroom: number | null;
+    /** The weekly window's remaining percent — the binding limit — or null. */
+    weeklyHeadroom: number | null;
+}
+/**
+ * Session and weekly usage headroom for the account this pane is running as,
+ * read straight from the accounts usage cache — never the cloud API, which the
+ * launched, registry-stripped session cannot reach and could not afford on
+ * every render anyway. Returns nulls (so a segment shows a neutral marker)
+ * whenever the account is unknown, the cache is missing, stale, corrupt, or
+ * keyed to a different account. Never throws.
+ */
+export declare function sessionUsage(env?: Env, now?: Date): SessionUsage;
 export {};

package/dist/cli.js

@@ -250,6 +250,11 @@ var STATE_FILE_PREFIX = ".claude";
 var STATE_FILE_SUFFIX = ".json";
 var CUSTOM_OAUTH_ENV = "CLAUDE_CODE_CUSTOM_OAUTH_URL";
 var OAUTH_VARIANTS = ["", "-custom-oauth", "-local-oauth", "-staging-oauth"];
+var CACHE_SUBDIR = "cache";
+var USAGE_CACHE_SUBDIR = "usage";
+var USAGE_CACHE_MAX_AGE_MS = 15 * 60 * 1000;
+var SESSION_WINDOW_MAX_MS = 5 * 60 * 60 * 1000;
+var SAFE_UUID = /^[A-Za-z0-9][A-Za-z0-9-]{0,63}$/;
 function str(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -396,6 +401,95 @@ async function sessionAccountEmail(env = process.env, tool) {
     return null;
   }
 }
+function accountsHomeDir(env) {
+  const override = str(env[ACCOUNTS_HOME_ENV]);
+  return override ? expandHome(override, env) : join2(home(env), ...DEFAULT_ACCOUNTS_HOME);
+}
+function sessionAccountUuid(env = process.env) {
+  try {
+    const stateFile = sessionStateFile(env);
+    if (!stateFile)
+      return null;
+    const uuid = str(readJson(stateFile)?.oauthAccount?.accountUuid);
+    return uuid && SAFE_UUID.test(uuid) ? uuid : null;
+  } catch {
+    return null;
+  }
+}
+function classifyWindow(w, fetchedAt) {
+  if (w.scoped === true)
+    return "scoped";
+  const group = str(w.group);
+  if (group === "session" || group === "weekly")
+    return group;
+  const id = str(w.id);
+  if (id) {
+    if (id.includes("session"))
+      return "session";
+    if (id.includes("weekly"))
+      return "weekly";
+  }
+  const resetsAt = typeof w.resetsAt === "string" ? Date.parse(w.resetsAt) : Number.NaN;
+  if (Number.isFinite(resetsAt) && fetchedAt !== null && resetsAt - fetchedAt > SESSION_WINDOW_MAX_MS) {
+    return "weekly";
+  }
+  return "unknown";
+}
+function windowHeadroom(w, now, fetchedAt) {
+  const resetsAt = typeof w.resetsAt === "string" ? Date.parse(w.resetsAt) : Number.NaN;
+  const rolled = Number.isFinite(resetsAt) && resetsAt <= now && (fetchedAt === null || resetsAt > fetchedAt);
+  if (rolled)
+    return 100;
+  const util = typeof w.utilization === "number" && Number.isFinite(w.utilization) ? w.utilization : null;
+  if (util === null)
+    return null;
+  return Math.max(0, Math.min(100, Math.round(100 - util)));
+}
+function deriveUsage(usage, now) {
+  const u = usage ?? {};
+  const windows = Array.isArray(u.windows) ? u.windows : [];
+  const fetchedAtMs = typeof u.fetchedAt === "string" ? Date.parse(u.fetchedAt) : Number.NaN;
+  const fetchedAt = Number.isFinite(fetchedAtMs) ? fetchedAtMs : null;
+  let session = null;
+  let weekly = null;
+  let unknownMin = null;
+  for (const w of windows) {
+    const cls = classifyWindow(w, fetchedAt);
+    if (cls === "scoped")
+      continue;
+    const h = windowHeadroom(w, now, fetchedAt);
+    if (h === null)
+      continue;
+    if (cls === "session")
+      session = session === null ? h : Math.min(session, h);
+    else if (cls === "weekly")
+      weekly = weekly === null ? h : Math.min(weekly, h);
+    else
+      unknownMin = unknownMin === null ? h : Math.min(unknownMin, h);
+  }
+  const weeklyHeadroom = weekly !== null ? unknownMin !== null ? Math.min(weekly, unknownMin) : weekly : unknownMin;
+  return { sessionHeadroom: session, weeklyHeadroom };
+}
+function sessionUsage(env = process.env, now = new Date) {
+  const empty = { sessionHeadroom: null, weeklyHeadroom: null };
+  try {
+    const uuid = sessionAccountUuid(env);
+    if (!uuid)
+      return empty;
+    const path = join2(accountsHomeDir(env), CACHE_SUBDIR, USAGE_CACHE_SUBDIR, `${uuid}.json`);
+    if (!existsSync3(path))
+      return empty;
+    const entry = readJson(path);
+    if (!entry || entry.accountUuid !== uuid)
+      return empty;
+    const fetchedAt = typeof entry.fetchedAt === "string" ? Date.parse(entry.fetchedAt) : Number.NaN;
+    if (!Number.isFinite(fetchedAt) || now.getTime() - fetchedAt > USAGE_CACHE_MAX_AGE_MS)
+      return empty;
+    return deriveUsage(entry.usage, now.getTime());
+  } catch {
+    return empty;
+  }
+}
 
 // src/settings.ts
 import { readFileSync as readFileSync4 } from "fs";
@@ -434,6 +528,18 @@ function modelName(ctx) {
 function limitPercent(pct) {
   return typeof pct === "number" ? pct : 0;
 }
+function usageLabel(prefix, headroom) {
+  return headroom === null ? `${prefix} \u2014` : `${prefix} ${headroom}%`;
+}
+function usageColor(headroom, binding = false) {
+  if (headroom === null)
+    return "dim";
+  if (headroom < 20)
+    return "red";
+  if (headroom < 50)
+    return "yellow";
+  return binding ? "green" : null;
+}
 var segments = [
   {
     id: "machine",
@@ -572,6 +678,20 @@ var segments = [
       return typeof pct === "number" ? `7d:${Math.round(pct)}%` : null;
     }
   },
+  {
+    id: "usage-session",
+    description: "Session (5-hour) usage remaining for this pane's own account, from the local accounts usage cache",
+    defaultEnabled: false,
+    color: () => usageColor(sessionUsage(process.env).sessionHeadroom),
+    render: () => usageLabel("5h", sessionUsage(process.env).sessionHeadroom)
+  },
+  {
+    id: "usage-weekly",
+    description: "Weekly usage remaining for this pane's own account \u2014 the binding limit \u2014 from the local accounts usage cache",
+    defaultEnabled: false,
+    color: () => usageColor(sessionUsage(process.env).weeklyHeadroom, true),
+    render: () => usageLabel("7d", sessionUsage(process.env).weeklyHeadroom)
+  },
   {
     id: "thread-title",
     description: "Thread title set with /rename (omitted until named)",
@@ -719,7 +839,7 @@ async function renderLine(ctx, cfg) {
 // package.json
 var package_default = {
   name: "@hasna/statusline",
-  version: "0.0.6",
+  version: "0.0.7",
   description: "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   license: "Apache-2.0",
   type: "module",

package/dist/index.js

@@ -249,6 +249,11 @@ var STATE_FILE_PREFIX = ".claude";
 var STATE_FILE_SUFFIX = ".json";
 var CUSTOM_OAUTH_ENV = "CLAUDE_CODE_CUSTOM_OAUTH_URL";
 var OAUTH_VARIANTS = ["", "-custom-oauth", "-local-oauth", "-staging-oauth"];
+var CACHE_SUBDIR = "cache";
+var USAGE_CACHE_SUBDIR = "usage";
+var USAGE_CACHE_MAX_AGE_MS = 15 * 60 * 1000;
+var SESSION_WINDOW_MAX_MS = 5 * 60 * 60 * 1000;
+var SAFE_UUID = /^[A-Za-z0-9][A-Za-z0-9-]{0,63}$/;
 function str(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -395,6 +400,95 @@ async function sessionAccountEmail(env = process.env, tool) {
     return null;
   }
 }
+function accountsHomeDir(env) {
+  const override = str(env[ACCOUNTS_HOME_ENV]);
+  return override ? expandHome(override, env) : join2(home(env), ...DEFAULT_ACCOUNTS_HOME);
+}
+function sessionAccountUuid(env = process.env) {
+  try {
+    const stateFile = sessionStateFile(env);
+    if (!stateFile)
+      return null;
+    const uuid = str(readJson(stateFile)?.oauthAccount?.accountUuid);
+    return uuid && SAFE_UUID.test(uuid) ? uuid : null;
+  } catch {
+    return null;
+  }
+}
+function classifyWindow(w, fetchedAt) {
+  if (w.scoped === true)
+    return "scoped";
+  const group = str(w.group);
+  if (group === "session" || group === "weekly")
+    return group;
+  const id = str(w.id);
+  if (id) {
+    if (id.includes("session"))
+      return "session";
+    if (id.includes("weekly"))
+      return "weekly";
+  }
+  const resetsAt = typeof w.resetsAt === "string" ? Date.parse(w.resetsAt) : Number.NaN;
+  if (Number.isFinite(resetsAt) && fetchedAt !== null && resetsAt - fetchedAt > SESSION_WINDOW_MAX_MS) {
+    return "weekly";
+  }
+  return "unknown";
+}
+function windowHeadroom(w, now, fetchedAt) {
+  const resetsAt = typeof w.resetsAt === "string" ? Date.parse(w.resetsAt) : Number.NaN;
+  const rolled = Number.isFinite(resetsAt) && resetsAt <= now && (fetchedAt === null || resetsAt > fetchedAt);
+  if (rolled)
+    return 100;
+  const util = typeof w.utilization === "number" && Number.isFinite(w.utilization) ? w.utilization : null;
+  if (util === null)
+    return null;
+  return Math.max(0, Math.min(100, Math.round(100 - util)));
+}
+function deriveUsage(usage, now) {
+  const u = usage ?? {};
+  const windows = Array.isArray(u.windows) ? u.windows : [];
+  const fetchedAtMs = typeof u.fetchedAt === "string" ? Date.parse(u.fetchedAt) : Number.NaN;
+  const fetchedAt = Number.isFinite(fetchedAtMs) ? fetchedAtMs : null;
+  let session = null;
+  let weekly = null;
+  let unknownMin = null;
+  for (const w of windows) {
+    const cls = classifyWindow(w, fetchedAt);
+    if (cls === "scoped")
+      continue;
+    const h = windowHeadroom(w, now, fetchedAt);
+    if (h === null)
+      continue;
+    if (cls === "session")
+      session = session === null ? h : Math.min(session, h);
+    else if (cls === "weekly")
+      weekly = weekly === null ? h : Math.min(weekly, h);
+    else
+      unknownMin = unknownMin === null ? h : Math.min(unknownMin, h);
+  }
+  const weeklyHeadroom = weekly !== null ? unknownMin !== null ? Math.min(weekly, unknownMin) : weekly : unknownMin;
+  return { sessionHeadroom: session, weeklyHeadroom };
+}
+function sessionUsage(env = process.env, now = new Date) {
+  const empty = { sessionHeadroom: null, weeklyHeadroom: null };
+  try {
+    const uuid = sessionAccountUuid(env);
+    if (!uuid)
+      return empty;
+    const path = join2(accountsHomeDir(env), CACHE_SUBDIR, USAGE_CACHE_SUBDIR, `${uuid}.json`);
+    if (!existsSync3(path))
+      return empty;
+    const entry = readJson(path);
+    if (!entry || entry.accountUuid !== uuid)
+      return empty;
+    const fetchedAt = typeof entry.fetchedAt === "string" ? Date.parse(entry.fetchedAt) : Number.NaN;
+    if (!Number.isFinite(fetchedAt) || now.getTime() - fetchedAt > USAGE_CACHE_MAX_AGE_MS)
+      return empty;
+    return deriveUsage(entry.usage, now.getTime());
+  } catch {
+    return empty;
+  }
+}
 
 // src/settings.ts
 import { readFileSync as readFileSync4 } from "fs";
@@ -433,6 +527,18 @@ function modelName(ctx) {
 function limitPercent(pct) {
   return typeof pct === "number" ? pct : 0;
 }
+function usageLabel(prefix, headroom) {
+  return headroom === null ? `${prefix} \u2014` : `${prefix} ${headroom}%`;
+}
+function usageColor(headroom, binding = false) {
+  if (headroom === null)
+    return "dim";
+  if (headroom < 20)
+    return "red";
+  if (headroom < 50)
+    return "yellow";
+  return binding ? "green" : null;
+}
 var segments = [
   {
     id: "machine",
@@ -571,6 +677,20 @@ var segments = [
       return typeof pct === "number" ? `7d:${Math.round(pct)}%` : null;
     }
   },
+  {
+    id: "usage-session",
+    description: "Session (5-hour) usage remaining for this pane's own account, from the local accounts usage cache",
+    defaultEnabled: false,
+    color: () => usageColor(sessionUsage(process.env).sessionHeadroom),
+    render: () => usageLabel("5h", sessionUsage(process.env).sessionHeadroom)
+  },
+  {
+    id: "usage-weekly",
+    description: "Weekly usage remaining for this pane's own account \u2014 the binding limit \u2014 from the local accounts usage cache",
+    defaultEnabled: false,
+    color: () => usageColor(sessionUsage(process.env).weeklyHeadroom, true),
+    render: () => usageLabel("7d", sessionUsage(process.env).weeklyHeadroom)
+  },
   {
     id: "thread-title",
     description: "Thread title set with /rename (omitted until named)",
@@ -718,7 +838,7 @@ async function renderLine(ctx, cfg) {
 // package.json
 var package_default = {
   name: "@hasna/statusline",
-  version: "0.0.6",
+  version: "0.0.7",
   description: "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   license: "Apache-2.0",
   type: "module",

package/dist/mcp/index.js

@@ -250,6 +250,11 @@ var STATE_FILE_PREFIX = ".claude";
 var STATE_FILE_SUFFIX = ".json";
 var CUSTOM_OAUTH_ENV = "CLAUDE_CODE_CUSTOM_OAUTH_URL";
 var OAUTH_VARIANTS = ["", "-custom-oauth", "-local-oauth", "-staging-oauth"];
+var CACHE_SUBDIR = "cache";
+var USAGE_CACHE_SUBDIR = "usage";
+var USAGE_CACHE_MAX_AGE_MS = 15 * 60 * 1000;
+var SESSION_WINDOW_MAX_MS = 5 * 60 * 60 * 1000;
+var SAFE_UUID = /^[A-Za-z0-9][A-Za-z0-9-]{0,63}$/;
 function str(value) {
   return typeof value === "string" && value.trim() ? value.trim() : null;
 }
@@ -396,6 +401,95 @@ async function sessionAccountEmail(env = process.env, tool) {
     return null;
   }
 }
+function accountsHomeDir(env) {
+  const override = str(env[ACCOUNTS_HOME_ENV]);
+  return override ? expandHome(override, env) : join2(home(env), ...DEFAULT_ACCOUNTS_HOME);
+}
+function sessionAccountUuid(env = process.env) {
+  try {
+    const stateFile = sessionStateFile(env);
+    if (!stateFile)
+      return null;
+    const uuid = str(readJson(stateFile)?.oauthAccount?.accountUuid);
+    return uuid && SAFE_UUID.test(uuid) ? uuid : null;
+  } catch {
+    return null;
+  }
+}
+function classifyWindow(w, fetchedAt) {
+  if (w.scoped === true)
+    return "scoped";
+  const group = str(w.group);
+  if (group === "session" || group === "weekly")
+    return group;
+  const id = str(w.id);
+  if (id) {
+    if (id.includes("session"))
+      return "session";
+    if (id.includes("weekly"))
+      return "weekly";
+  }
+  const resetsAt = typeof w.resetsAt === "string" ? Date.parse(w.resetsAt) : Number.NaN;
+  if (Number.isFinite(resetsAt) && fetchedAt !== null && resetsAt - fetchedAt > SESSION_WINDOW_MAX_MS) {
+    return "weekly";
+  }
+  return "unknown";
+}
+function windowHeadroom(w, now, fetchedAt) {
+  const resetsAt = typeof w.resetsAt === "string" ? Date.parse(w.resetsAt) : Number.NaN;
+  const rolled = Number.isFinite(resetsAt) && resetsAt <= now && (fetchedAt === null || resetsAt > fetchedAt);
+  if (rolled)
+    return 100;
+  const util = typeof w.utilization === "number" && Number.isFinite(w.utilization) ? w.utilization : null;
+  if (util === null)
+    return null;
+  return Math.max(0, Math.min(100, Math.round(100 - util)));
+}
+function deriveUsage(usage, now) {
+  const u = usage ?? {};
+  const windows = Array.isArray(u.windows) ? u.windows : [];
+  const fetchedAtMs = typeof u.fetchedAt === "string" ? Date.parse(u.fetchedAt) : Number.NaN;
+  const fetchedAt = Number.isFinite(fetchedAtMs) ? fetchedAtMs : null;
+  let session = null;
+  let weekly = null;
+  let unknownMin = null;
+  for (const w of windows) {
+    const cls = classifyWindow(w, fetchedAt);
+    if (cls === "scoped")
+      continue;
+    const h = windowHeadroom(w, now, fetchedAt);
+    if (h === null)
+      continue;
+    if (cls === "session")
+      session = session === null ? h : Math.min(session, h);
+    else if (cls === "weekly")
+      weekly = weekly === null ? h : Math.min(weekly, h);
+    else
+      unknownMin = unknownMin === null ? h : Math.min(unknownMin, h);
+  }
+  const weeklyHeadroom = weekly !== null ? unknownMin !== null ? Math.min(weekly, unknownMin) : weekly : unknownMin;
+  return { sessionHeadroom: session, weeklyHeadroom };
+}
+function sessionUsage(env = process.env, now = new Date) {
+  const empty = { sessionHeadroom: null, weeklyHeadroom: null };
+  try {
+    const uuid = sessionAccountUuid(env);
+    if (!uuid)
+      return empty;
+    const path = join2(accountsHomeDir(env), CACHE_SUBDIR, USAGE_CACHE_SUBDIR, `${uuid}.json`);
+    if (!existsSync3(path))
+      return empty;
+    const entry = readJson(path);
+    if (!entry || entry.accountUuid !== uuid)
+      return empty;
+    const fetchedAt = typeof entry.fetchedAt === "string" ? Date.parse(entry.fetchedAt) : Number.NaN;
+    if (!Number.isFinite(fetchedAt) || now.getTime() - fetchedAt > USAGE_CACHE_MAX_AGE_MS)
+      return empty;
+    return deriveUsage(entry.usage, now.getTime());
+  } catch {
+    return empty;
+  }
+}
 
 // src/settings.ts
 import { readFileSync as readFileSync4 } from "fs";
@@ -434,6 +528,18 @@ function modelName(ctx) {
 function limitPercent(pct) {
   return typeof pct === "number" ? pct : 0;
 }
+function usageLabel(prefix, headroom) {
+  return headroom === null ? `${prefix} \u2014` : `${prefix} ${headroom}%`;
+}
+function usageColor(headroom, binding = false) {
+  if (headroom === null)
+    return "dim";
+  if (headroom < 20)
+    return "red";
+  if (headroom < 50)
+    return "yellow";
+  return binding ? "green" : null;
+}
 var segments = [
   {
     id: "machine",
@@ -572,6 +678,20 @@ var segments = [
       return typeof pct === "number" ? `7d:${Math.round(pct)}%` : null;
     }
   },
+  {
+    id: "usage-session",
+    description: "Session (5-hour) usage remaining for this pane's own account, from the local accounts usage cache",
+    defaultEnabled: false,
+    color: () => usageColor(sessionUsage(process.env).sessionHeadroom),
+    render: () => usageLabel("5h", sessionUsage(process.env).sessionHeadroom)
+  },
+  {
+    id: "usage-weekly",
+    description: "Weekly usage remaining for this pane's own account \u2014 the binding limit \u2014 from the local accounts usage cache",
+    defaultEnabled: false,
+    color: () => usageColor(sessionUsage(process.env).weeklyHeadroom, true),
+    render: () => usageLabel("7d", sessionUsage(process.env).weeklyHeadroom)
+  },
   {
     id: "thread-title",
     description: "Thread title set with /rename (omitted until named)",
@@ -719,7 +839,7 @@ async function renderLine(ctx, cfg) {
 // package.json
 var package_default = {
   name: "@hasna/statusline",
-  version: "0.0.6",
+  version: "0.0.7",
   description: "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   license: "Apache-2.0",
   type: "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/statusline",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Tiny composable statusline CLI for AI coding agents \u2014 pre-built toggleable segments for Claude Code, with a provider model for others",
   "license": "Apache-2.0",
   "type": "module",