@nightlab-agent/subagent-spend 0.8.1 → 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.1",
+      "version": "0.8.3",
       "category": "productivity"
     }
   ],

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "subagent-spend",
-  "version": "0.8.1",
+  "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,19 @@
 
 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
+- README: the opening says what an unwatched long job costs before what the plugin does, and the spend cap
+  picture (seen 2026-10-31) is on the first screen. No code change.
+
 ## 0.8.1 - 2026-11-02
 
 ### Changed

package/README.md

@@ -1,8 +1,9 @@
 # subagent-spend
 
-Claude Code meters: subagent tokens, usage limits and turn counts, and a
-spend cap per session that stops requests at the limit you set
-([Spend cap](#spend-cap)).
+Hand Claude Code a long job and its subagents keep spending tokens while you
+are away. This plugin puts what they used, your usage limits and a count of
+steps and tool calls in one line under the prompt. If you set a dollar cap, once a session's cost
+reaches it no new request goes out ([Spend cap](#spend-cap)).
 
 Install at the Claude Code prompt (more under [Install](#install)):
 
@@ -10,6 +11,12 @@ Install at the Claude Code prompt (more under [Install](#install)):
 /plugin install subagent-spend --marketplace nightlab-agent/subagent-spend
 ```
 
+![Claude Code with a $0.10 cap: asked to read every file and describe each, Claude reads four files; the next step is answered by the plugin's line saying the session cost $0.11 of the $0.10 cap and no request was sent](https://raw.githubusercontent.com/nightlab-agent/subagent-spend/bcb368556c20a40c62ce952574e5a1bec5210923/docs/spend-cap-midturn.png)
+
+The spend cap, seen on 2026-10-31: a $0.10 cap, and the next step got the
+line above instead of a request ([Spend cap](#spend-cap)). The line under
+the prompt, after three subagents ran:
+
 ![Claude Code after three subagents ran: the subagent pane lists the three with their turns and tokens, and the line under the prompt reads subagents 3, tok 218k, then the usage windows, cost and step counts](https://raw.githubusercontent.com/nightlab-agent/subagent-spend/c676e8c3462af96a5b8d581b0adb479fa706f470/docs/preview.png)
 
 Seen in a Claude Code 2.1.312 terminal (150 columns) on 2026-10-29, after

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,7 +1,7 @@
 {
   "name": "@nightlab-agent/subagent-spend",
-  "version": "0.8.1",
-  "description": "Claude Code mod: 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).",
+  "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",
     "claude-code-mod",
@@ -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.1: 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.