@hydra-acp/budgeter 0.1.2

package/dist/config.js

@@ -0,0 +1,99 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+const PRIMARY_CONF_PATH = resolve(homedir(), ".hydra-acp", "budgeter.conf");
+export function configPath() {
+    const override = process.env.HYDRA_ACP_BUDGETER_CONF;
+    if (override) {
+        return override;
+    }
+    return PRIMARY_CONF_PATH;
+}
+function parseEnvFile(text) {
+    const out = new Map();
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#")) {
+            continue;
+        }
+        const eq = line.indexOf("=");
+        if (eq === -1) {
+            continue;
+        }
+        const key = line.slice(0, eq).trim();
+        let val = line.slice(eq + 1).trim();
+        if ((val.startsWith('"') && val.endsWith('"')) ||
+            (val.startsWith("'") && val.endsWith("'"))) {
+            val = val.slice(1, -1);
+        }
+        out.set(key, val);
+    }
+    return out;
+}
+function deriveWsUrl(httpUrl) {
+    if (httpUrl.startsWith("https://")) {
+        return "wss://" + httpUrl.slice("https://".length).replace(/\/$/, "") + "/acp";
+    }
+    if (httpUrl.startsWith("http://")) {
+        return "ws://" + httpUrl.slice("http://".length).replace(/\/$/, "") + "/acp";
+    }
+    throw new Error(`hydraDaemonUrl must start with http:// or https://: ${httpUrl}`);
+}
+function floatVal(map, envName, key, fallback) {
+    const v = process.env[envName] ?? map.get(key);
+    if (v === undefined || v === "") {
+        return fallback;
+    }
+    const n = Number.parseFloat(v);
+    return Number.isFinite(n) ? n : fallback;
+}
+const TRUTHY = new Set(["1", "true", "yes", "on", "t"]);
+function boolVal(map, envName, key, fallback) {
+    const v = process.env[envName] ?? map.get(key);
+    if (v === undefined) {
+        return fallback;
+    }
+    return TRUTHY.has(v.toLowerCase());
+}
+function strVal(map, envName, key, fallback) {
+    return process.env[envName] ?? map.get(key) ?? fallback;
+}
+export function loadConfig(path = configPath()) {
+    let map = new Map();
+    if (existsSync(path)) {
+        try {
+            map = parseEnvFile(readFileSync(path, "utf8"));
+        }
+        catch (err) {
+            // Non-fatal — log and continue with env vars / defaults.
+            process.stderr.write(`hydra-acp-budgeter: warning: could not read ${path}: ${err.message}\n`);
+        }
+    }
+    // Hydra-injected connection vars: env always wins, conf file is fallback.
+    const hydraDaemonUrl = process.env.HYDRA_ACP_DAEMON_URL ??
+        map.get("HYDRA_DAEMON_URL") ??
+        "http://127.0.0.1:8765";
+    const hydraToken = process.env.HYDRA_ACP_TOKEN ?? map.get("HYDRA_TOKEN") ?? "";
+    if (!hydraToken) {
+        throw new Error("Missing HYDRA_ACP_TOKEN env var (or HYDRA_TOKEN in budgeter.conf). " +
+            "When run as a hydra transformer, hydra injects this automatically.");
+    }
+    const hydraWsUrl = process.env.HYDRA_ACP_WS_URL ??
+        map.get("HYDRA_WS_URL") ??
+        deriveWsUrl(hydraDaemonUrl);
+    const softLimit = floatVal(map, "HYDRA_ACP_BUDGETER_SOFT", "SOFT", 5);
+    const hardLimit = floatVal(map, "HYDRA_ACP_BUDGETER_HARD", "HARD", 10);
+    if (hardLimit < softLimit) {
+        throw new Error(`HARD (${hardLimit}) must be >= SOFT (${softLimit})`);
+    }
+    return {
+        hydraDaemonUrl,
+        hydraWsUrl,
+        hydraToken,
+        softLimit,
+        hardLimit,
+        currency: strVal(map, "HYDRA_ACP_BUDGETER_CURRENCY", "CURRENCY", "USD"),
+        debug: boolVal(map, "DEBUG", "DEBUG", false),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/enforce.js

@@ -0,0 +1,81 @@
+// Builds outbound emit_message payloads and stop responses for the
+// router. Centralises the "what does a warning/rejection look like on
+// the wire" decisions so the router only deals with verdicts.
+export class Enforcer {
+    client;
+    log;
+    trace;
+    constructor(client, log, trace) {
+        this.client = client;
+        this.log = log;
+        this.trace = trace;
+    }
+    // Emit a warning to every client attached to the session. Sent as a
+    // session/update with sessionUpdate="agent_message_chunk" so it
+    // surfaces in the conversation log on every well-behaved client. A
+    // _meta.hydra-acp.budgeter marker lets renderer-aware clients style it
+    // differently (or filter it out, if they prefer their own UI).
+    async warn(sessionId, warn) {
+        const text = warn.body ? `\n\n${warn.title}\n${warn.body}\n\n` : `\n\n${warn.title}\n\n`;
+        const envelope = {
+            sessionId,
+            update: {
+                sessionUpdate: "agent_message_chunk",
+                content: { type: "text", text },
+                _meta: {
+                    "hydra-acp": {
+                        budgeter: {
+                            title: warn.title,
+                            ...(warn.body !== undefined ? { body: warn.body } : {}),
+                        },
+                    },
+                },
+            },
+        };
+        if (this.trace) {
+            this.trace.emits.push({
+                sessionId,
+                method: "session/update",
+                envelope,
+            });
+        }
+        try {
+            await this.client.request("hydra-acp/emit_message", {
+                sessionId,
+                method: "session/update",
+                envelope,
+                route: "chain",
+            });
+        }
+        catch (err) {
+            this.log.warn(`emit_message warn for ${sessionId} failed: ${err.message}`);
+        }
+    }
+    // Build the payload that the router returns as the stop action's
+    // payload. Becomes the response delivered to the originator of the
+    // session/prompt — clients render the stopReason and the _meta.
+    buildRejectPayload(reject) {
+        return {
+            stopReason: reject.stopReason ?? "refusal",
+            _meta: {
+                "hydra-acp": {
+                    budgeter: { message: reject.message },
+                },
+            },
+        };
+    }
+    // Convenience: combine a warn + reject into the appropriate side
+    // effects. Called by the router on a prompt_request verdict that
+    // includes both — the warn fires asynchronously so the stop payload
+    // can be returned to the daemon without blocking on emit_message.
+    async dispatch(sessionId, verdict) {
+        if (verdict.warn) {
+            void this.warn(sessionId, verdict.warn);
+        }
+        if (verdict.reject) {
+            return this.buildRejectPayload(verdict.reject);
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=enforce.js.map

package/dist/enforce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforce.js","sourceRoot":"","sources":["../src/enforce.ts"],"names":[],"mappings":"AAUA,mEAAmE;AACnE,sEAAsE;AACtE,8DAA8D;AAC9D,MAAM,OAAO,QAAQ;IAEA;IACA;IACA;IAHnB,YACmB,MAA0C,EAC1C,GAAW,EACX,KAAiB;QAFjB,WAAM,GAAN,MAAM,CAAoC;QAC1C,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAY;IACjC,CAAC;IAEJ,oEAAoE;IACpE,gEAAgE;IAChE,mEAAmE;IACnE,uEAAuE;IACvE,+DAA+D;IAC/D,KAAK,CAAC,IAAI,CACR,SAAiB,EACjB,IAAsC;QAEtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,KAAK,MAAM,CAAC;QACzF,MAAM,QAAQ,GAAG;YACf,SAAS;YACT,MAAM,EAAE;gBACN,aAAa,EAAE,qBAAqB;gBACpC,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;gBAC/B,KAAK,EAAE;oBACL,WAAW,EAAE;wBACX,QAAQ,EAAE;4BACR,KAAK,EAAE,IAAI,CAAC,KAAK;4BACjB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;yBACxD;qBACF;iBACF;aACF;SACF,CAAC;QACF,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;gBACpB,SAAS;gBACT,MAAM,EAAE,gBAAgB;gBACxB,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE;gBAClD,SAAS;gBACT,MAAM,EAAE,gBAAgB;gBACxB,QAAQ;gBACR,KAAK,EAAE,OAAO;aACf,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,IAAI,CACX,yBAAyB,SAAS,YAAa,GAAa,CAAC,OAAO,EAAE,CACvE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iEAAiE;IACjE,mEAAmE;IACnE,gEAAgE;IAChE,kBAAkB,CAChB,MAAgD;QAEhD,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,SAAS;YAC1C,KAAK,EAAE;gBACL,WAAW,EAAE;oBACX,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAED,iEAAiE;IACjE,iEAAiE;IACjE,oEAAoE;IACpE,kEAAkE;IAClE,KAAK,CAAC,QAAQ,CACZ,SAAiB,EACjB,OAAsB;QAEtB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,KAAK,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/index.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { loadConfig } from "./config.js";
+import { BudgeterBridge } from "./bridge.js";
+import { stateFilePath } from "./paths.js";
+import { DEFAULT_RULE } from "./rule.js";
+import { deleteStateFile } from "./tracker.js";
+import { logger, setDebug } from "./util/log.js";
+const log = logger("main");
+function readVersion() {
+    try {
+        const here = dirname(fileURLToPath(import.meta.url));
+        const pkg = JSON.parse(readFileSync(resolve(here, "../package.json"), "utf8"));
+        return pkg.version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+function runReset() {
+    deleteStateFile(stateFilePath());
+    process.stdout.write("hydra-acp-budgeter accumulated cost reset\n");
+}
+async function runTransformer() {
+    const config = loadConfig();
+    setDebug(config.debug);
+    const statePath = stateFilePath();
+    const bridge = new BudgeterBridge({
+        daemonWsUrl: config.hydraWsUrl,
+        token: config.hydraToken,
+        softLimit: config.softLimit,
+        hardLimit: config.hardLimit,
+        currency: config.currency,
+        rule: DEFAULT_RULE,
+        statePath,
+    });
+    bridge.start();
+    const shutdown = (sig) => {
+        log.info(`${sig} received — shutting down`);
+        bridge.stop();
+        setTimeout(() => process.exit(0), 200).unref();
+    };
+    process.on("SIGINT", () => shutdown("SIGINT"));
+    process.on("SIGTERM", () => shutdown("SIGTERM"));
+    log.info(`hydra-acp-budgeter up; daemon=${config.hydraDaemonUrl} soft=${config.softLimit} hard=${config.hardLimit} ${config.currency} state=${statePath}`);
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.includes("--version") || argv.includes("-v")) {
+        process.stdout.write(`hydra-acp-budgeter ${readVersion()}\n`);
+        return;
+    }
+    if (argv[0] === "reset") {
+        runReset();
+        return;
+    }
+    await runTransformer();
+}
+main().catch((err) => {
+    process.stderr.write(`hydra-acp-budgeter: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/paths.js

@@ -0,0 +1,12 @@
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+// hydra-acp injects HYDRA_ACP_HOME when it spawns transformers; this file
+// is invoked both in that role and as a one-shot subcommand from the
+// user's shell, so fall back to ~/.hydra-acp when the env isn't set.
+function hydraHome() {
+    return process.env.HYDRA_ACP_HOME ?? resolve(homedir(), ".hydra-acp");
+}
+export function stateFilePath() {
+    return resolve(hydraHome(), "budgeter-cost.json");
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,0EAA0E;AAC1E,qEAAqE;AACrE,qEAAqE;AACrE,SAAS,SAAS;IAChB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,YAAY,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,SAAS,EAAE,EAAE,oBAAoB,CAAC,CAAC;AACpD,CAAC"}

package/dist/router.js

@@ -0,0 +1,161 @@
+// Translates incoming transformer/message and transformer/session_event
+// envelopes into BudgetEvents, runs them through the rule, and dispatches
+// the resulting verdicts via the Enforcer. Unlike the notifier's
+// EventRouter (one instance per session), this is a singleton — the
+// transformer process holds one connection for every session, so the
+// router keeps a sessionId → SessionMeta map.
+export class EventRouter {
+    rule;
+    tracker;
+    enforcer;
+    log;
+    metas = new Map();
+    constructor(rule, tracker, enforcer, log) {
+        this.rule = rule;
+        this.tracker = tracker;
+        this.enforcer = enforcer;
+        this.log = log;
+    }
+    setMeta(sessionId, meta) {
+        this.metas.set(sessionId, meta);
+    }
+    forgetSession(sessionId) {
+        this.metas.delete(sessionId);
+    }
+    // Fired by the bridge when an agent→client session/update notification
+    // is being routed. usage_update is the only kind we care about for cost
+    // tracking; other kinds may still flow through the rule so a custom
+    // rule can observe (but the default rule ignores them).
+    async onResponseUpdate(sessionId, update) {
+        const kind = typeof update.sessionUpdate === "string" ? update.sessionUpdate : "";
+        // session_info_update may carry an updated title; mirror the notifier
+        // and refresh meta so subsequent warning messages reflect the latest.
+        if (kind === "session_info_update") {
+            this.applySessionInfoUpdate(sessionId, update);
+        }
+        if (kind !== "usage_update") {
+            return;
+        }
+        this.tracker.applyUsageUpdate(sessionId, update);
+        const transition = this.tracker.consumeStateTransition();
+        if (transition !== undefined) {
+            await this.fire({
+                sessionId,
+                kind: "threshold_cross",
+                raw: { to: transition, from: this.tracker.state },
+                meta: this.metaFor(sessionId),
+                budget: this.tracker.snapshotFor(sessionId),
+            });
+        }
+        // Also run a plain usage_update event so a custom rule can act on
+        // every tick (e.g. emit a status notification every $1 spent). The
+        // default rule ignores this kind.
+        await this.fire({
+            sessionId,
+            kind: "usage_update",
+            raw: update,
+            meta: this.metaFor(sessionId),
+            budget: this.tracker.snapshotFor(sessionId),
+        });
+    }
+    // Fired by the bridge for a request:session/prompt intercept. Returns
+    // the stop payload to send back to the daemon, or undefined to let the
+    // prompt continue. The rule decides — the default rule rejects when
+    // we're in the "hard" state.
+    async onPromptRequest(sessionId, envelope) {
+        const verdict = await this.runRule({
+            sessionId,
+            kind: "prompt_request",
+            raw: { envelope },
+            meta: this.metaFor(sessionId),
+            budget: this.tracker.snapshotFor(sessionId),
+        });
+        if (!verdict) {
+            return undefined;
+        }
+        return this.enforcer.dispatch(sessionId, verdict);
+    }
+    // Fired by the bridge for lifecycle:session.opened and session.closed.
+    async onLifecycle(event, sessionId) {
+        if (event === "session.opened") {
+            await this.fire({
+                sessionId,
+                kind: "session_opened",
+                raw: {},
+                meta: this.metaFor(sessionId),
+                budget: this.tracker.snapshotFor(sessionId),
+            });
+            return;
+        }
+        if (event === "session.closed") {
+            // Note: we deliberately do NOT drop the session's cost from the
+            // tracker — total spend is sticky across session.closed so the
+            // budget reflects every dollar this transformer has seen. Reset
+            // via `hydra-acp-budgeter reset` (deletes the state file) when
+            // you want to zero it.
+            await this.fire({
+                sessionId,
+                kind: "session_closed",
+                raw: {},
+                meta: this.metaFor(sessionId),
+                budget: this.tracker.snapshotFor(sessionId),
+            });
+            this.forgetSession(sessionId);
+        }
+    }
+    async fire(ev) {
+        const verdict = await this.runRule(ev);
+        if (!verdict) {
+            return;
+        }
+        // For non-prompt events, only the warn side can fire — reject without
+        // a prompt to attach it to is a no-op. Log and skip so a misconfigured
+        // rule doesn't fail silently.
+        if (verdict.reject && ev.kind !== "prompt_request") {
+            this.log.warn(`rule returned reject on kind=${ev.kind} for ${ev.sessionId.slice(0, 12)} — only valid on prompt_request; ignored`);
+        }
+        if (verdict.warn) {
+            await this.enforcer.warn(ev.sessionId, verdict.warn);
+        }
+    }
+    async runRule(ev) {
+        try {
+            return await this.rule(ev);
+        }
+        catch (err) {
+            this.log.warn(`rule threw on kind=${ev.kind} sessionId=${ev.sessionId.slice(0, 12)}: ${err.message}; skipping`);
+            return null;
+        }
+    }
+    metaFor(sessionId) {
+        return this.metas.get(sessionId) ?? {};
+    }
+    applySessionInfoUpdate(sessionId, update) {
+        const cur = { ...this.metaFor(sessionId) };
+        let changed = false;
+        if (typeof update.title === "string" && cur.title !== update.title) {
+            cur.title = update.title;
+            changed = true;
+        }
+        const agentId = readHydraAgentId(update._meta);
+        if (agentId !== undefined && cur.agentId !== agentId) {
+            cur.agentId = agentId;
+            changed = true;
+        }
+        if (changed) {
+            this.metas.set(sessionId, cur);
+        }
+    }
+}
+function readHydraAgentId(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.agentId;
+    return typeof v === "string" ? v : undefined;
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/dist/rule.js

@@ -0,0 +1,86 @@
+const CURRENCY_SYMBOLS = {
+    USD: "$",
+    EUR: "€",
+    GBP: "£",
+    JPY: "¥",
+    CNY: "¥",
+    CAD: "C$",
+    AUD: "A$",
+    NZD: "NZ$",
+    CHF: "CHF ",
+    HKD: "HK$",
+    SGD: "S$",
+    INR: "₹",
+    KRW: "₩",
+    BRL: "R$",
+    MXN: "MX$",
+};
+function fmtMoney(amount, currency) {
+    const fixed = amount.toFixed(2);
+    const sym = CURRENCY_SYMBOLS[currency.toUpperCase()];
+    if (sym) {
+        return `${sym}${fixed}`;
+    }
+    return `${currency} ${fixed}`;
+}
+// The rule the budgeter runs on every event. Strategy:
+//   - threshold_cross to "soft": warn (one-shot, the tracker only fires
+//     crosses once per transition)
+//   - threshold_cross to "hard": warn (also one-shot)
+//   - prompt_request in "hard" state: reject with stopReason "refusal"
+//     and an explanation in the message
+//   - session_opened in "hard" state: warn the new session so the user
+//     understands why their next prompt will bounce
+//   - usage_update and session_closed: do nothing
+export const DEFAULT_RULE = (ev) => {
+    const { budget } = ev;
+    const totalStr = fmtMoney(budget.total, budget.currency);
+    const softStr = fmtMoney(budget.soft, budget.currency);
+    const hardStr = fmtMoney(budget.hard, budget.currency);
+    if (ev.kind === "threshold_cross") {
+        const to = (ev.raw.to ?? "ok");
+        if (to === "hard") {
+            return {
+                warn: {
+                    title: `🛑 Budget hard limit hit`,
+                    body: `Spent ${totalStr} ≥ ${hardStr} hard limit. Further prompts will be rejected until the budget is reset.`,
+                },
+            };
+        }
+        return null;
+    }
+    // Warn on every turn that reports a cost while over the soft limit.
+    if (ev.kind === "usage_update" && budget.state !== "ok" && typeof ev.raw.cost?.amount === "number") {
+        const label = budget.state === "hard" ? "🛑 Over hard limit" : "💰 Over soft limit";
+        return {
+            warn: {
+                title: `${label} · ${totalStr} spent`,
+                body: budget.state === "hard"
+                    ? `Hard limit ${hardStr} reached. Prompts will be rejected until budget is reset.`
+                    : `Soft limit ${softStr} reached (hard: ${hardStr}).`,
+            },
+        };
+    }
+    if (ev.kind === "prompt_request" && budget.state === "hard") {
+        return {
+            warn: {
+                title: `🛑 Prompt blocked — budget exceeded`,
+                body: `Spent ${totalStr} ≥ ${hardStr} hard limit. Reset the budget or raise HYDRA_ACP_BUDGETER_HARD to continue.`,
+            },
+            reject: {
+                message: `Budget exceeded: spent ${totalStr} ≥ ${hardStr} hard limit. Reset the budget or raise HYDRA_ACP_BUDGETER_HARD to continue.`,
+                stopReason: "refusal",
+            },
+        };
+    }
+    if (ev.kind === "session_opened" && budget.state === "hard") {
+        return {
+            warn: {
+                title: `🛑 Session opened over budget`,
+                body: `Total spend ${totalStr} ≥ ${hardStr}. Prompts on this session will be rejected.`,
+            },
+        };
+    }
+    return null;
+};
+//# sourceMappingURL=rule.js.map

package/dist/rule.js.map

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