@engramx/idl 0.16.0-rc.6 → 0.16.0-rc.8

package/dist/engram.did

@@ -615,6 +615,7 @@ type RailHealth =
    freezeReservation: nat;
    memoryBytes: nat;
    paidVouchersConsumed: nat;
+   refundOwed: opt nat;
    sendHeadroom: nat;
    sessionsClosed: nat;
    sessionsClosing: nat;
@@ -3395,7 +3396,10 @@ type Engram =
    /// The metrics reader the registry designated reads this engram's paid-rail health, in one call:
    /// the balance and the line it must stay above, the memory that line is computed from, the sessions
    /// by state, the escrow open sessions hold, the vouchers spent and the refused ones
-   /// (`RailHealth.RailHealth` says what each is, and what is never in it).
+   /// (`RailHealth.RailHealth` says what each is, and what is never in it). ⟨2026-10-08, ic402 2.18.0⟩
+   /// And `refundOwed`: the closed sessions whose refund failed and whose payer has not yet recovered
+   /// it — counted from the close, never read from the ledger; `opt` from birth, and null (an engram
+   /// that does not count) is never 0.
    /// 
    /// CALLER: the metrics reader the spawning registry named on this engram (`metricsReaderId`), and
    /// nobody else — the owner reads its balance through `getOwnerConsole`. Answered only while the

package/dist/engram.idl.d.ts

@@ -2821,7 +2821,10 @@ export interface Engram {
    * / The metrics reader the registry designated reads this engram's paid-rail health, in one call:
    * / the balance and the line it must stay above, the memory that line is computed from, the sessions
    * / by state, the escrow open sessions hold, the vouchers spent and the refused ones
-   * / (`RailHealth.RailHealth` says what each is, and what is never in it).
+   * / (`RailHealth.RailHealth` says what each is, and what is never in it). ⟨2026-10-08, ic402 2.18.0⟩
+   * / And `refundOwed`: the closed sessions whose refund failed and whose payer has not yet recovered
+   * / it — counted from the close, never read from the ledger; `opt` from birth, and null (an engram
+   * / that does not count) is never 0.
    * /
    * / CALLER: the metrics reader the spawning registry named on this engram (`metricsReaderId`), and
    * / nobody else — the owner reads its balance through `getOwnerConsole`. Answered only while the
@@ -3574,6 +3577,7 @@ export interface RailHealth {
   paidVouchersConsumed: bigint;
   escrowOpen: [] | [bigint];
   sessionsOpen: bigint;
+  refundOwed: [] | [bigint];
   sessionsClosing: bigint;
   cycles: bigint;
   sendHeadroom: bigint;

package/dist/engram.idl.js

@@ -1061,6 +1061,7 @@ export const idlFactory = ({ IDL }) => {
     paidVouchersConsumed: IDL.Nat,
     escrowOpen: IDL.Opt(IDL.Nat),
     sessionsOpen: IDL.Nat,
+    refundOwed: IDL.Opt(IDL.Nat),
     sessionsClosing: IDL.Nat,
     cycles: IDL.Nat,
     sendHeadroom: IDL.Nat,

package/dist/market.did

@@ -81,6 +81,7 @@ type SessionCounts =
    closing: nat;
    expired: nat;
    open: nat;
+   refundOwed: opt nat;
    total: nat;
  };
 type SessionConfig = 

package/dist/market.idl.d.ts

@@ -329,6 +329,7 @@ export interface SessionCounts {
   total: bigint;
   expired: bigint;
   open: bigint;
+  refundOwed: [] | [bigint];
   closing: bigint;
 }
 export interface SessionIntent {

package/dist/market.idl.js

@@ -231,6 +231,7 @@ export const idlFactory = ({ IDL }) => {
     total: IDL.Nat,
     expired: IDL.Nat,
     open: IDL.Nat,
+    refundOwed: IDL.Opt(IDL.Nat),
     closing: IDL.Nat,
   });
   const HttpRequest = IDL.Record({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@engramx/idl",
-  "version": "0.16.0-rc.6",
+  "version": "0.16.0-rc.8",
   "description": "The Candid interfaces of the EngramX canisters (engram, registry, market) — the .did files and the JS/TS IDL factories generated from them, published with every release so code that calls them pins the interface by version.",
   "license": "Apache-2.0",
   "author": "EngramX <developer@engramx.ai>",