@hydra-acp/budgeter 0.1.2

package/dist/tracker.js

@@ -0,0 +1,264 @@
+import { mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { logger } from "./util/log.js";
+const log = logger("tracker");
+export class CostTracker {
+    opts;
+    sessions = new Map();
+    currentState = "ok";
+    // Last JSON we wrote to disk. The watcher uses this to ignore its own
+    // writes — if the file's content matches, we did it.
+    lastWrittenJson = "";
+    constructor(opts) {
+        this.opts = opts;
+        if (opts.statePath) {
+            this.loadFromDisk();
+        }
+    }
+    applyUsageUpdate(sessionId, update) {
+        log.debug(`usage_update session=${sessionId.slice(0, 12)} raw=${JSON.stringify(update).slice(0, 200)}`);
+        const cost = readCost(update);
+        if (cost === undefined) {
+            log.debug(`readCost returned undefined for session=${sessionId.slice(0, 12)}`);
+            return this.snapshotFor(sessionId);
+        }
+        const prior = this.sessions.get(sessionId) ?? { cost: 0, baseline: 0, currency: undefined };
+        const next = {
+            cost: Math.max(prior.cost, cost.amount),
+            baseline: prior.baseline,
+            currency: cost.currency ?? prior.currency,
+        };
+        this.sessions.set(sessionId, next);
+        this.persist();
+        return this.snapshotFor(sessionId);
+    }
+    // Public snapshot accessor for the synthetic events (session_opened,
+    // prompt_request) that don't carry a cost in their own envelope.
+    snapshotFor(sessionId) {
+        const per = this.sessions.get(sessionId);
+        const total = this.totalCost();
+        return {
+            total,
+            perSession: per ? Math.max(0, per.cost - per.baseline) : 0,
+            currency: per?.currency ?? this.opts.currency,
+            soft: this.opts.softLimit,
+            hard: this.opts.hardLimit,
+            state: deriveState(total, this.opts.softLimit, this.opts.hardLimit),
+        };
+    }
+    // Returns the new state if this call transitioned to a higher tier
+    // (ok→soft, ok→hard, soft→hard). Returns undefined if the state didn't
+    // change or if it dropped (e.g. a reset zeroed everything).
+    consumeStateTransition() {
+        const next = deriveState(this.totalCost(), this.opts.softLimit, this.opts.hardLimit);
+        if (rank(next) > rank(this.currentState)) {
+            this.currentState = next;
+            return next;
+        }
+        if (next !== this.currentState) {
+            this.currentState = next;
+        }
+        return undefined;
+    }
+    get state() {
+        return this.currentState;
+    }
+    // Baseline all sessions from their current cost so effective spend
+    // reads zero without discarding the agent's running total.
+    reset() {
+        this.baselineFromCurrent();
+        this.persist();
+    }
+    baselineFromCurrent() {
+        for (const [id, s] of this.sessions) {
+            this.sessions.set(id, { ...s, baseline: s.cost });
+        }
+        this.currentState = "ok";
+    }
+    // Re-read the state file and replace in-memory state if it changed
+    // from what we last wrote. Called from the fs.watch handler in bridge.
+    // Returns true when state was adopted (caller can react if it cares).
+    adoptFromDisk() {
+        if (!this.opts.statePath) {
+            return false;
+        }
+        let raw;
+        try {
+            raw = readFileSync(this.opts.statePath, "utf8");
+        }
+        catch (err) {
+            const e = err;
+            if (e.code === "ENOENT") {
+                // File deleted = reset. Baseline all sessions from current cost
+                // so effective spend reads zero without discarding the agent's
+                // running total (it will keep reporting the same numbers).
+                if (this.sessions.size === 0) {
+                    return false;
+                }
+                log.info("state file removed externally — baselining from current totals");
+                this.baselineFromCurrent();
+                this.lastWrittenJson = "";
+                return true;
+            }
+            log.warn(`read state failed: ${e.message}`);
+            return false;
+        }
+        if (raw === this.lastWrittenJson) {
+            return false;
+        }
+        // Don't advance currentState — leave it at the pre-load value so
+        // consumeStateTransition detects any upward crossing on the next tick.
+        const adopted = this.applyPersisted(raw, false);
+        if (adopted) {
+            this.lastWrittenJson = raw;
+            log.info(`adopted state from disk (total=${this.totalCost().toFixed(2)})`);
+        }
+        return adopted;
+    }
+    loadFromDisk() {
+        if (!this.opts.statePath) {
+            return;
+        }
+        let raw;
+        try {
+            raw = readFileSync(this.opts.statePath, "utf8");
+        }
+        catch (err) {
+            const e = err;
+            if (e.code !== "ENOENT") {
+                log.warn(`read state failed: ${e.message}; starting fresh`);
+            }
+            return;
+        }
+        if (this.applyPersisted(raw)) {
+            this.lastWrittenJson = raw;
+            log.info(`loaded state from ${this.opts.statePath} (total=${this.totalCost().toFixed(2)})`);
+        }
+    }
+    applyPersisted(raw, updateState = true) {
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            log.warn(`state file malformed: ${err.message}; ignoring`);
+            return false;
+        }
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            log.warn("state file is not an object; ignoring");
+            return false;
+        }
+        const obj = parsed;
+        const sessions = obj.sessions ?? {};
+        if (typeof sessions !== "object" || Array.isArray(sessions)) {
+            log.warn("state.sessions is not an object; ignoring");
+            return false;
+        }
+        this.sessions.clear();
+        for (const [id, val] of Object.entries(sessions)) {
+            if (val && typeof val === "object" && typeof val.cost === "number") {
+                const v = val;
+                this.sessions.set(id, {
+                    cost: v.cost,
+                    baseline: typeof v.baseline === "number" ? v.baseline : 0,
+                    currency: typeof v.currency === "string" ? v.currency : undefined,
+                });
+            }
+        }
+        if (updateState) {
+            this.currentState = deriveState(this.totalCost(), this.opts.softLimit, this.opts.hardLimit);
+        }
+        return true;
+    }
+    persist() {
+        if (!this.opts.statePath) {
+            return;
+        }
+        const payload = {
+            version: 1,
+            sessions: Object.fromEntries(this.sessions),
+        };
+        const json = JSON.stringify(payload, null, 2);
+        if (json === this.lastWrittenJson) {
+            return;
+        }
+        try {
+            mkdirSync(dirname(this.opts.statePath), { recursive: true });
+            const tmp = `${this.opts.statePath}.tmp`;
+            writeFileSync(tmp, json, { encoding: "utf8", mode: 0o600 });
+            renameSync(tmp, this.opts.statePath);
+            this.lastWrittenJson = json;
+        }
+        catch (err) {
+            log.warn(`persist failed: ${err.message}`);
+        }
+    }
+    totalCost() {
+        let sum = 0;
+        for (const s of this.sessions.values()) {
+            sum += Math.max(0, s.cost - s.baseline);
+        }
+        return sum;
+    }
+}
+// Delete the persisted state file. Used by the `reset` subcommand when
+// no live process is running (or as the message the live process picks
+// up via fs.watch).
+export function deleteStateFile(statePath) {
+    try {
+        unlinkSync(statePath);
+        return true;
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT") {
+            return false;
+        }
+        throw err;
+    }
+}
+function deriveState(total, soft, hard) {
+    if (total >= hard) {
+        return "hard";
+    }
+    if (total >= soft) {
+        return "soft";
+    }
+    return "ok";
+}
+function rank(state) {
+    if (state === "hard")
+        return 2;
+    if (state === "soft")
+        return 1;
+    return 0;
+}
+function readCost(update) {
+    // hydra injects cumulative cost via _meta.hydra-acp.cumulativeCost on
+    // usage_update for sessions that have lived across multiple agents.
+    // Prefer that when present so resurrects don't undercount.
+    const cumulative = readCumulativeFromMeta(update._meta);
+    const cost = (update.cost ?? undefined);
+    const amount = cumulative !== undefined
+        ? cumulative
+        : typeof cost?.amount === "number"
+            ? cost.amount
+            : undefined;
+    if (amount === undefined) {
+        return undefined;
+    }
+    const currency = typeof cost?.currency === "string" ? cost.currency : undefined;
+    return { amount, currency };
+}
+function readCumulativeFromMeta(meta) {
+    if (!meta || typeof meta !== "object" || Array.isArray(meta)) {
+        return undefined;
+    }
+    const ns = meta["hydra-acp"];
+    if (!ns || typeof ns !== "object" || Array.isArray(ns)) {
+        return undefined;
+    }
+    const v = ns.cumulativeCost;
+    return typeof v === "number" ? v : undefined;
+}
+//# sourceMappingURL=tracker.js.map

package/dist/tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.js","sourceRoot":"","sources":["../src/tracker.ts"],"names":[],"mappings":"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"}

package/dist/util/log.js

@@ -0,0 +1,46 @@
+let debugEnabled = false;
+export function setDebug(on) {
+    debugEnabled = on;
+}
+function emit(level, scope, args) {
+    const ts = new Date().toISOString();
+    const stream = level === "error" || level === "warn" ? process.stderr : process.stdout;
+    stream.write(`[${ts}] ${level} [${scope}] ${formatArgs(args)}\n`);
+}
+function formatArgs(args) {
+    return args
+        .map((a) => {
+        if (typeof a === "string") {
+            return a;
+        }
+        if (a instanceof Error) {
+            return a.stack ?? a.message;
+        }
+        try {
+            return JSON.stringify(a);
+        }
+        catch {
+            return String(a);
+        }
+    })
+        .join(" ");
+}
+export function logger(scope) {
+    return {
+        debug(...args) {
+            if (debugEnabled) {
+                emit("debug", scope, args);
+            }
+        },
+        info(...args) {
+            emit("info", scope, args);
+        },
+        warn(...args) {
+            emit("warn", scope, args);
+        },
+        error(...args) {
+            emit("error", scope, args);
+        },
+    };
+}
+//# sourceMappingURL=log.js.map

package/dist/util/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/util/log.ts"],"names":[],"mappings":"AAEA,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,MAAM,UAAU,QAAQ,CAAC,EAAW;IAClC,YAAY,GAAG,EAAE,CAAC;AACpB,CAAC;AAED,SAAS,IAAI,CAAC,KAAY,EAAE,KAAa,EAAE,IAAe;IACxD,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,MAAM,GAAG,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvF,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK,KAAK,KAAK,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,UAAU,CAAC,IAAe;IACjC,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,YAAY,KAAK,EAAE,CAAC;YACvB,OAAO,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;SACD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AASD,MAAM,UAAU,MAAM,CAAC,KAAa;IAClC,OAAO;QACL,KAAK,CAAC,GAAG,IAAe;YACtB,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,GAAG,IAAe;YACrB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,GAAG,IAAe;YACrB,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QACD,KAAK,CAAC,GAAG,IAAe;YACtB,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@hydra-acp/budgeter",
+  "version": "0.1.2",
+  "description": "Cost-budget transformer extension for hydra-acp — warns on soft limit, rejects further prompts/sessions on hard limit.",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "dist/index.js",
+  "bin": {
+    "hydra-acp-budgeter": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "watch": "tsc -p . --watch",
+    "start": "node dist/index.js",
+    "dev": "tsc -p . && node dist/index.js",
+    "test": "node --test --import tsx 'test/**/*.test.ts'",
+    "lint": "tsc -p . --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@types/ws": "^8.18.1",
+    "tsx": "^4.20.0",
+    "typescript": "^5.6.3"
+  }
+}