floe-guard 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -142,6 +142,22 @@ interface BudgetAdvisory {
     spentUsd: number;
     /** Hosted reports the tightest cap across all scopes; local is always "local". */
     scope: "local";
+    /**
+     * The guard's own next-call estimate (the costlier of the last LLM and last
+     * tool call — the same value the default reservation uses). 0 until the first
+     * call is recorded, so a planner can't divide by a cold estimate.
+     *
+     * Optional so adding it stays a non-breaking, additive change for any code
+     * that constructs a `BudgetAdvisory` literal; `advisory()` always sets it.
+     */
+    expectedCost?: number;
+    /**
+     * How many more calls the remaining budget buys at expectedCost:
+     * floor(remainingUsd / expectedCost). null when expectedCost is 0 (no call
+     * recorded yet) — unknown, not zero. Optional for the same additive reason as
+     * expectedCost; `advisory()` always sets it.
+     */
+    estCallsRemaining?: number | null;
 }
 declare class BudgetGuard {
     readonly limitUsd: number;

package/dist/index.d.ts

@@ -142,6 +142,22 @@ interface BudgetAdvisory {
     spentUsd: number;
     /** Hosted reports the tightest cap across all scopes; local is always "local". */
     scope: "local";
+    /**
+     * The guard's own next-call estimate (the costlier of the last LLM and last
+     * tool call — the same value the default reservation uses). 0 until the first
+     * call is recorded, so a planner can't divide by a cold estimate.
+     *
+     * Optional so adding it stays a non-breaking, additive change for any code
+     * that constructs a `BudgetAdvisory` literal; `advisory()` always sets it.
+     */
+    expectedCost?: number;
+    /**
+     * How many more calls the remaining budget buys at expectedCost:
+     * floor(remainingUsd / expectedCost). null when expectedCost is 0 (no call
+     * recorded yet) — unknown, not zero. Optional for the same additive reason as
+     * expectedCost; `advisory()` always sets it.
+     */
+    estCallsRemaining?: number | null;
 }
 declare class BudgetGuard {
     readonly limitUsd: number;

package/dist/index.js

@@ -1451,6 +1451,9 @@ var BudgetGuard = class {
    */
   advisory() {
     const usedBps = this.limitUsd <= 0 ? 1e4 : Math.max(0, Math.min(1e4, Math.floor(this.spentUsd / this.limitUsd * 1e4 + 1e-9)));
+    const remainingUsd = Math.max(0, this.limitUsd - this.spentUsd);
+    const expectedCost = Math.max(this.lastLlmCost, this.lastToolCost);
+    const estCallsRemaining = expectedCost > 0 ? Math.floor(remainingUsd / expectedCost + 1e-9) : null;
     return {
       nearLimit: usedBps >= this.nearLimitBps,
       usedBps,
@@ -1458,10 +1461,12 @@ var BudgetGuard = class {
       // in-flight reservations. Unlike the remainingUsd getter (which subtracts
       // `reserved`), the advisory is a soft utilization signal about money already
       // spent, while the getter reports what a new call can still claim.
-      remainingUsd: Math.max(0, this.limitUsd - this.spentUsd),
+      remainingUsd,
       limitUsd: this.limitUsd,
       spentUsd: this.spentUsd,
-      scope: "local"
+      scope: "local",
+      expectedCost,
+      estCallsRemaining
     };
   }
 };