reasonix 0.12.19 → 0.12.20

package/dist/index.d.ts

@@ -993,6 +993,18 @@ interface CacheFirstLoopOptions {
      * presets pass `false` to lock the running session to one model.
      */
     autoEscalate?: boolean;
+    /**
+     * Soft USD budget for the entire session. When set, the loop:
+     *   - Emits a one-shot warning event when cumulative cost crosses 80%
+     *   - Refuses to run the next turn once cumulative cost ≥ budget,
+     *     yielding an error that explains how to bump or clear the cap
+     *
+     * Default `undefined` — no cap, no warnings. Reasonix is the cost-
+     * focused agent; the budget is opt-in so users new to the tool
+     * don't get blocked at $0.50 wondering what happened, but heavy /
+     * headless / CI users have a clean circuit breaker available.
+     */
+    budgetUsd?: number;
     /**
      * Session name. When set, the loop pre-loads the session's prior messages
      * into its log on construction, and appends every new log entry to
@@ -1071,6 +1083,19 @@ declare class CacheFirstLoop {
      * flip it live alongside `model`.
      */
     autoEscalate: boolean;
+    /**
+     * Soft USD budget — see {@link CacheFirstLoopOptions.budgetUsd}.
+     * Mutable so `/budget` slash can set / change / clear it mid-session.
+     * `null` (the default) disables all budget checks.
+     */
+    budgetUsd: number | null;
+    /**
+     * Set the first time a turn crosses 80% of the budget so the warning
+     * doesn't repeat every turn afterwards. Cleared by `setBudget` (any
+     * change re-arms the warning, including raising the cap above the
+     * current spend).
+     */
+    private _budgetWarned;
     sessionName: string | null;
     /**
      * Hook list, mutable so `/hooks reload` can swap it without
@@ -1227,6 +1252,13 @@ declare class CacheFirstLoop {
      * flip a knob between turns.
      */
     configure(opts: ReconfigurableOptions): void;
+    /**
+     * Set / change / clear the soft USD budget. `null` (or any non-
+     * positive number) disables the cap entirely. Re-arms the 80%
+     * warning so a user who bumps the cap mid-session sees a fresh
+     * threshold message at the new boundary.
+     */
+    setBudget(usd: number | null): void;
     /**
      * Arm pro for the next turn (consumed at turn start). Called by
      * `/pro`. Idempotent — repeated calls stay armed, `disarmPro()`

package/dist/index.js

@@ -1855,6 +1855,19 @@ var CacheFirstLoop = class {
    * flip it live alongside `model`.
    */
   autoEscalate = true;
+  /**
+   * Soft USD budget — see {@link CacheFirstLoopOptions.budgetUsd}.
+   * Mutable so `/budget` slash can set / change / clear it mid-session.
+   * `null` (the default) disables all budget checks.
+   */
+  budgetUsd;
+  /**
+   * Set the first time a turn crosses 80% of the budget so the warning
+   * doesn't repeat every turn afterwards. Cleared by `setBudget` (any
+   * change re-arms the warning, including raising the cap above the
+   * current spend).
+   */
+  _budgetWarned = false;
   sessionName;
   /**
    * Hook list, mutable so `/hooks reload` can swap it without
@@ -1920,6 +1933,7 @@ var CacheFirstLoop = class {
     this.model = opts.model ?? "deepseek-v4-flash";
     this.reasoningEffort = opts.reasoningEffort ?? "max";
     if (opts.autoEscalate !== void 0) this.autoEscalate = opts.autoEscalate;
+    this.budgetUsd = typeof opts.budgetUsd === "number" && opts.budgetUsd > 0 ? opts.budgetUsd : null;
     this.maxToolIters = opts.maxToolIters ?? 64;
     this.hooks = opts.hooks ?? [];
     this.hookCwd = opts.hookCwd ?? process.cwd();
@@ -2159,6 +2173,16 @@ var CacheFirstLoop = class {
     }
     this.stream = this.branchEnabled ? false : this._streamPreference;
   }
+  /**
+   * Set / change / clear the soft USD budget. `null` (or any non-
+   * positive number) disables the cap entirely. Re-arms the 80%
+   * warning so a user who bumps the cap mid-session sees a fresh
+   * threshold message at the new boundary.
+   */
+  setBudget(usd) {
+    this.budgetUsd = typeof usd === "number" && usd > 0 ? usd : null;
+    this._budgetWarned = false;
+  }
   /**
    * Arm pro for the next turn (consumed at turn start). Called by
    * `/pro`. Idempotent — repeated calls stay armed, `disarmPro()`
@@ -2320,6 +2344,26 @@ var CacheFirstLoop = class {
     return userText;
   }
   async *step(userInput) {
+    if (this.budgetUsd !== null) {
+      const spent = this.stats.totalCost;
+      if (spent >= this.budgetUsd) {
+        yield {
+          turn: this._turn,
+          role: "error",
+          content: "",
+          error: `session budget exhausted \u2014 spent $${spent.toFixed(4)} \u2265 cap $${this.budgetUsd.toFixed(2)}. Bump the cap with /budget <usd>, clear it with /budget off, or end the session.`
+        };
+        return;
+      }
+      if (!this._budgetWarned && spent >= this.budgetUsd * 0.8) {
+        this._budgetWarned = true;
+        yield {
+          turn: this._turn,
+          role: "warning",
+          content: `\u25B2 budget 80% used \u2014 $${spent.toFixed(4)} of $${this.budgetUsd.toFixed(2)}. Next turn or two likely trips the cap.`
+        };
+      }
+    }
     this._turn++;
     this.scratch.reset();
     this.repair.resetStorm();