@nightlab-agent/subagent-spend 0.8.2 → 0.8.3

package/.claude-plugin/marketplace.json

@@ -8,7 +8,7 @@
       "name": "subagent-spend",
       "source": "./",
       "description": "A spend cap for interactive sessions, and per-subagent tokens, rate-limit windows, context fill, cost, steps, tool calls and tool errors of a Claude Code session, in a notice under the prompt, local files and panes (the usage pane not yet seen on a screen).",
-      "version": "0.8.2",
+      "version": "0.8.3",
       "category": "productivity"
     }
   ],

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "subagent-spend",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "A spend cap for interactive sessions, and per-subagent tokens, rate-limit windows, context fill, cost, steps, tool calls and tool errors of a Claude Code session, in a notice under the prompt, local files and panes (the usage pane not yet seen on a screen).",
   "author": {
     "name": "Nightlab"

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 The form is Keep a Changelog; versions follow SemVer.
 
+## 0.8.3 - 2026-11-03
+
+### Fixed
+- The npm package left out hooks/cap.ts, which hooks/register.tsx imports, so an install from npm failed to load
+  from 0.8.0 on. The marketplace install was not affected. The checklist now fails when a packed hook imports a
+  file the package leaves out.
+
 ## 0.8.2 - 2026-11-03
 
 ### Changed

package/hooks/cap.ts

@@ -0,0 +1,59 @@
+// The spend cap (option `capUsd`, off at 0): what the session may cost, by Claude Code's own
+// estimate (`session.measure`'s `cost.usd`, the figure `--max-budget-usd` checks in print mode).
+// At WARN_AT of the cap a toast says so, once; at the cap every model step, the main loop's and
+// each subagent's, is answered by the mod with no request made, until /spend-cap raises or lifts it.
+// A step already running finishes: its cost can pass the cap, so leave headroom.
+
+export const WARN_AT = 0.8
+
+export const cap = {
+  /** The cap in dollars; null is off. */
+  usd: null as number | null,
+  /** The session's cost so far, from the newest measurement; null before the first. */
+  spent: null as number | null,
+  warned: false,
+}
+
+/** The option's value as a cap: a positive number of dollars, anything else off. */
+export function capOf(v: unknown): number | null {
+  const n = typeof v === 'number' ? v : typeof v === 'string' && v.trim() !== '' ? Number(v.trim().replace(/^\$/, '')) : NaN
+  return Number.isFinite(n) && n > 0 ? n : null
+}
+
+export const money = (n: number) => `$${n.toFixed(2)}`
+
+/** Whether the next step is held: a cap is set and the cost has reached it. */
+export const reached = () => cap.usd !== null && cap.spent !== null && cap.spent >= cap.usd
+
+/** The warning's text once the cost first reaches WARN_AT of the cap (and stays under it), else null; said once per cap. */
+export function warnNow(): string | null {
+  if (cap.warned || cap.usd === null || cap.spent === null || reached() || cap.spent < cap.usd * WARN_AT) return null
+  cap.warned = true
+  return `Spend cap: ${money(cap.spent)} of ${money(cap.usd)} used`
+}
+
+/** What a held step answers in the chat. */
+export const heldText = () =>
+  `Spend cap reached: this session has cost ${money(cap.spent ?? 0)} of the ${money(cap.usd ?? 0)} cap ` +
+  `(Claude Code's own estimate), so subagent-spend sent no request. ` +
+  `To go on, raise it with /spend-cap <dollars>, or lift it with /spend-cap off.`
+
+/** `/spend-cap` with its args: a number sets the cap, `off` lifts it, nothing shows it. The reply's text. */
+export function capCommand(args: string): string {
+  const a = args.trim().toLowerCase()
+  if (a === 'off') {
+    cap.usd = null
+    cap.warned = false
+    return `Spend cap off for this session. ${spentText()}`
+  }
+  if (a !== '') {
+    const n = capOf(a)
+    if (n === null) return `Not a cap: "${args.trim()}". Give dollars, like /spend-cap 5, or /spend-cap off.`
+    cap.usd = n
+    cap.warned = false
+    return `Spend cap set to ${money(n)} for this session. ${spentText()}`
+  }
+  return cap.usd === null ? `No spend cap. ${spentText()}` : `Spend cap ${money(cap.usd)}. ${spentText()}`
+}
+
+const spentText = () => (cap.spent === null ? 'No cost reading yet.' : `Cost so far ${money(cap.spent)}.`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nightlab-agent/subagent-spend",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "Claude Code plugin: a spend cap for interactive sessions, and per-subagent tokens, rate-limit windows, context fill, cost, steps, tool calls and tool errors of a session, in a notice under the prompt, local files and panes (the usage pane not yet seen on a screen).",
   "keywords": [
     "claude-code",
@@ -26,6 +26,7 @@
     ".claude-plugin/",
     "hooks/hooks.json",
     "hooks/register.tsx",
+    "hooks/cap.ts",
     "hooks/spend.ts",
     "hooks/turns.ts",
     "hooks/usage.ts",

package/subagent_spend.py

@@ -1,5 +1,5 @@
 #!/usr/bin/env python3
-"""subagent-spend 0.8.2: attribute Claude Code token usage to each subagent.
+"""subagent-spend 0.8.3: attribute Claude Code token usage to each subagent.
 
   subagent_spend.py hook        SubagentStop hook: reads the hook JSON on stdin, sums the usage
                                 in the subagent transcript, appends one line to the session's rows file.