@band-ai/band-sdk-core 2.4.0 → 2.6.0

package/README.md

@@ -107,6 +107,31 @@ switch (tracker.recordRoomParticipantsJoinFailed("room-1", ticket, false)) {
 }
 ```
 
+### `DecisionRegistry` lifecycle
+
+`DecisionRegistry` tracks chat-mediated asks: whoever claims one first owns
+its outcome. Every registration returns `[token, ticket]`, with `ticket` a
+`bigint`, and later calls name that exact registration, so a stale holder
+gets `"stale"` instead of acting on a newer ask that reused the token.
+`maxPending` must be an integer of at least `1`, or omitted/`null` for
+unbounded; `seed` is an optional `bigint`. `cancelAll`/`cancelRoom` return a
+plain `{ unclaimed, claimed }` object. `isAuthorizedSender` takes an array,
+a `Set`, or `null`.
+
+```ts
+import { DecisionRegistry, isAuthorizedSender } from "@band-ai/band-sdk-core";
+
+const registry = new DecisionRegistry(10);
+const registration = registry.registerMinted("room-1");
+if (registration === undefined) throw new Error("tickets exhausted");
+const [token, ticket] = registration;
+
+if (registry.tryClaim(token, ticket) !== "claimed") throw new Error("not claimed");
+if (registry.tryClaim(token, ticket) !== "already_claimed") throw new Error("claimed twice");
+if (registry.cancelRoom("room-1").claimed[0] !== token) throw new Error("claim not reported");
+if (!isAuthorizedSender(new Set(["alice"]), "alice")) throw new Error("alice refused");
+```
+
 ### `Session` — WebSocket reconnect state machine
 
 `Session`/`SessionPolicy` are a sans-io session state machine plus

package/band_sdk_core.js

@@ -270,6 +270,182 @@ class ClaimRegistry {
 if (Symbol.dispose) ClaimRegistry.prototype[Symbol.dispose] = ClaimRegistry.prototype.free;
 exports.ClaimRegistry = ClaimRegistry;
 
+/**
+ * Pending chat-mediated asks by token, oldest first. Every registration
+ * returns `[token, ticket]`; later calls name that exact registration, so a
+ * stale holder never acts on a newer ask that reused the token.
+ */
+class DecisionRegistry {
+    __destroy_into_raw() {
+        const ptr = this.__wbg_ptr;
+        this.__wbg_ptr = 0;
+        DecisionRegistryFinalization.unregister(this);
+        return ptr;
+    }
+    free() {
+        const ptr = this.__destroy_into_raw();
+        wasm.__wbg_decisionregistry_free(ptr, 0);
+    }
+    /**
+     * Returns a plain `{ unclaimed, claimed }` object of token arrays.
+     * @returns {any}
+     */
+    cancelAll() {
+        const ret = wasm.decisionregistry_cancelAll(this.__wbg_ptr);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * Returns a plain `{ unclaimed, claimed }` object of token arrays.
+     * @param {any} roomId
+     * @returns {any}
+     */
+    cancelRoom(roomId) {
+        const ret = wasm.decisionregistry_cancelRoom(this.__wbg_ptr, roomId);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * @returns {string | undefined}
+     */
+    evictOldest() {
+        const ret = wasm.decisionregistry_evictOldest(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]);
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
+    /**
+     * @param {any} token
+     * @param {bigint} ticket
+     * @returns {boolean}
+     */
+    forget(token, ticket) {
+        const ret = wasm.decisionregistry_forget(this.__wbg_ptr, token, ticket);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+    /**
+     * @returns {number | undefined}
+     */
+    get maxPending() {
+        const ret = wasm.decisionregistry_maxPending(this.__wbg_ptr);
+        return ret === Number.MAX_SAFE_INTEGER ? undefined : ret;
+    }
+    /**
+     * `maxPending` omitted or `null` never evicts. `seed` fixes the
+     * minted-token sequence; omitted, each registry draws its own.
+     * @param {number | null} [maxPending]
+     * @param {bigint | null} [seed]
+     */
+    constructor(maxPending, seed) {
+        const ret = wasm.decisionregistry_new(!isLikeNone(maxPending), isLikeNone(maxPending) ? 0 : maxPending, !isLikeNone(seed), isLikeNone(seed) ? BigInt(0) : seed);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        this.__wbg_ptr = ret[0];
+        DecisionRegistryFinalization.register(this, this.__wbg_ptr, this);
+        return this;
+    }
+    /**
+     * @returns {string | undefined}
+     */
+    oldestUnclaimed() {
+        const ret = wasm.decisionregistry_oldestUnclaimed(this.__wbg_ptr);
+        let v1;
+        if (ret[0] !== 0) {
+            v1 = getStringFromWasm0(ret[0], ret[1]);
+            wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        }
+        return v1;
+    }
+    /**
+     * @param {any} key
+     * @returns {Array<any> | undefined}
+     */
+    registerKeyed(key) {
+        const ret = wasm.decisionregistry_registerKeyed(this.__wbg_ptr, key);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * @param {any} roomId
+     * @returns {Array<any> | undefined}
+     */
+    registerMinted(roomId) {
+        const ret = wasm.decisionregistry_registerMinted(this.__wbg_ptr, roomId);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return takeFromExternrefTable0(ret[0]);
+    }
+    /**
+     * @param {any} token
+     * @param {bigint} ticket
+     * @returns {string}
+     */
+    tryClaim(token, ticket) {
+        const ret = wasm.decisionregistry_tryClaim(this.__wbg_ptr, token, ticket);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        return getStringFromWasm0(ret[0], ret[1]);
+    }
+    /**
+     * @returns {number}
+     */
+    unclaimedCount() {
+        const ret = wasm.decisionregistry_unclaimedCount(this.__wbg_ptr);
+        return ret >>> 0;
+    }
+    /**
+     * @param {any} roomId
+     * @returns {string[]}
+     */
+    unclaimedInRoom(roomId) {
+        const ret = wasm.decisionregistry_unclaimedInRoom(this.__wbg_ptr, roomId);
+        if (ret[3]) {
+            throw takeFromExternrefTable0(ret[2]);
+        }
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @returns {string[]}
+     */
+    unclaimed() {
+        const ret = wasm.decisionregistry_unclaimed(this.__wbg_ptr);
+        var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+        wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+        return v1;
+    }
+    /**
+     * @param {any} token
+     * @param {bigint} ticket
+     * @returns {boolean}
+     */
+    withdraw(token, ticket) {
+        const ret = wasm.decisionregistry_withdraw(this.__wbg_ptr, token, ticket);
+        if (ret[2]) {
+            throw takeFromExternrefTable0(ret[1]);
+        }
+        return ret[0] !== 0;
+    }
+}
+if (Symbol.dispose) DecisionRegistry.prototype[Symbol.dispose] = DecisionRegistry.prototype.free;
+exports.DecisionRegistry = DecisionRegistry;
+
 /**
  * The always-injected passive participant roster. A participant is any
  * plain object; `add`/`setAll` read `id`, `name`, `type`, `handle`,
@@ -1081,11 +1257,10 @@ class SubscriptionTracker {
     /**
      * @param {any} topic
      * @param {bigint} ticket
-     * @param {boolean} joined
      * @returns {boolean}
      */
-    recordAgentTopicJoin(topic, ticket, joined) {
-        const ret = wasm.subscriptiontracker_recordAgentTopicJoin(this.__wbg_ptr, topic, ticket, joined);
+    recordAgentTopicJoinAmbiguous(topic, ticket) {
+        const ret = wasm.subscriptiontracker_recordAgentTopicJoinAmbiguous(this.__wbg_ptr, topic, ticket);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -1094,10 +1269,11 @@ class SubscriptionTracker {
     /**
      * @param {any} topic
      * @param {bigint} ticket
+     * @param {boolean} joined
      * @returns {boolean}
      */
-    recordAgentTopicJoinAmbiguous(topic, ticket) {
-        const ret = wasm.subscriptiontracker_recordAgentTopicJoinAmbiguous(this.__wbg_ptr, topic, ticket);
+    recordAgentTopicJoin(topic, ticket, joined) {
+        const ret = wasm.subscriptiontracker_recordAgentTopicJoin(this.__wbg_ptr, topic, ticket, joined);
         if (ret[2]) {
             throw takeFromExternrefTable0(ret[1]);
         }
@@ -1387,6 +1563,24 @@ function evaluateNextMessage(triggeringMessageId, nextMessageId) {
 }
 exports.evaluateNextMessage = evaluateNextMessage;
 
+/**
+ * Whether `senderId` may answer an ask: `null` admits anyone; any array or
+ * `Set` -- empty included -- admits only its members. Throws a plain
+ * `Error` if `authorizedSenders` is not an array or `Set` of strings (or
+ * `null`), or `senderId` is not a string (or `null`).
+ * @param {any} authorizedSenders
+ * @param {any} senderId
+ * @returns {boolean}
+ */
+function isAuthorizedSender(authorizedSenders, senderId) {
+    const ret = wasm.isAuthorizedSender(authorizedSenders, senderId);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return ret[0] !== 0;
+}
+exports.isAuthorizedSender = isAuthorizedSender;
+
 /**
  * The one definition of "self echo" (`senderType === "Agent" &&
  * senderId === agentId`), shared by `evaluateDeliveryEvent` and
@@ -1548,7 +1742,7 @@ exports.validateMemoryTypeForSystem = validateMemoryTypeForSystem;
 function __wbg_get_imports() {
     const import0 = {
         __proto__: null,
-        __wbg_Error_408e67f47ca7b58b: function(arg0, arg1) {
+        __wbg_Error_67e7344beaa85059: function(arg0, arg1) {
             const ret = Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
@@ -1559,68 +1753,68 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_bigint_get_as_i64_c4ecf48528083721: function(arg0, arg1) {
+        __wbg___wbindgen_bigint_get_as_i64_b482365c149396c8: function(arg0, arg1) {
             const v = arg1;
             const ret = typeof(v) === 'bigint' ? v : undefined;
             getDataViewMemory0().setBigInt64(arg0 + 8 * 1, isLikeNone(ret) ? BigInt(0) : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_boolean_get_c9c83ebd41b34df3: function(arg0) {
+        __wbg___wbindgen_boolean_get_7a12af2b3f899c5a: function(arg0) {
             const v = arg0;
             const ret = typeof(v) === 'boolean' ? v : undefined;
             return isLikeNone(ret) ? 0xFFFFFF : ret ? 1 : 0;
         },
-        __wbg___wbindgen_debug_string_a57024b9c6e4a48b: function(arg0, arg1) {
+        __wbg___wbindgen_debug_string_0e68cf47c9cbd9b0: function(arg0, arg1) {
             const ret = debugString(arg1);
             const ptr1 = passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
             const len1 = WASM_VECTOR_LEN;
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_in_ac983077f137f2e6: function(arg0, arg1) {
+        __wbg___wbindgen_in_50072d4d6e45c193: function(arg0, arg1) {
             const ret = arg0 in arg1;
             return ret;
         },
-        __wbg___wbindgen_is_bigint_8ffbbef442139384: function(arg0) {
+        __wbg___wbindgen_is_bigint_60fc0336cb14f5d7: function(arg0) {
             const ret = typeof(arg0) === 'bigint';
             return ret;
         },
-        __wbg___wbindgen_is_function_5e4570eb24ffa122: function(arg0) {
+        __wbg___wbindgen_is_function_fcda5e3902d732fe: function(arg0) {
             const ret = typeof(arg0) === 'function';
             return ret;
         },
-        __wbg___wbindgen_is_null_7d13f41e1a2d5140: function(arg0) {
+        __wbg___wbindgen_is_null_5160b3e381865372: function(arg0) {
             const ret = arg0 === null;
             return ret;
         },
-        __wbg___wbindgen_is_object_a2790eb24c211ea0: function(arg0) {
+        __wbg___wbindgen_is_object_edb6b15aa3afe12e: function(arg0) {
             const val = arg0;
             const ret = typeof(val) === 'object' && val !== null;
             return ret;
         },
-        __wbg___wbindgen_is_string_e6f02f0ea5f20a32: function(arg0) {
+        __wbg___wbindgen_is_string_c4f7cb494a2a21f1: function(arg0) {
             const ret = typeof(arg0) === 'string';
             return ret;
         },
-        __wbg___wbindgen_is_undefined_6cff064c44e0d823: function(arg0) {
+        __wbg___wbindgen_is_undefined_8c687d0b90d5b524: function(arg0) {
             const ret = arg0 === undefined;
             return ret;
         },
-        __wbg___wbindgen_jsval_eq_0a18949a61670320: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_eq_9fdcd3c0a860dd3b: function(arg0, arg1) {
             const ret = arg0 === arg1;
             return ret;
         },
-        __wbg___wbindgen_jsval_loose_eq_acf2776254a8d832: function(arg0, arg1) {
+        __wbg___wbindgen_jsval_loose_eq_3c30021c243b64cd: function(arg0, arg1) {
             const ret = arg0 == arg1;
             return ret;
         },
-        __wbg___wbindgen_number_get_136b9679cab35cfb: function(arg0, arg1) {
+        __wbg___wbindgen_number_get_1dc732b810cb937c: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'number' ? obj : undefined;
             getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
         },
-        __wbg___wbindgen_string_get_d154f1e671052120: function(arg0, arg1) {
+        __wbg___wbindgen_string_get_92ab86bb19cbc12f: function(arg0, arg1) {
             const obj = arg1;
             const ret = typeof(obj) === 'string' ? obj : undefined;
             var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
@@ -1628,34 +1822,38 @@ function __wbg_get_imports() {
             getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
             getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
         },
-        __wbg___wbindgen_throw_bb96b2010945f0bc: function(arg0, arg1) {
+        __wbg___wbindgen_throw_5d9e815e6fdf150f: function(arg0, arg1) {
             throw new Error(getStringFromWasm0(arg0, arg1));
         },
-        __wbg_call_1c5886ab9c57d1c7: function() { return handleError(function (arg0, arg1) {
+        __wbg_call_269c5566fbede3eb: function() { return handleError(function (arg0, arg1) {
             const ret = arg0.call(arg1);
             return ret;
         }, arguments); },
-        __wbg_done_669171204c3dcae2: function(arg0) {
+        __wbg_done_cffed884d87aa22e: function(arg0) {
             const ret = arg0.done;
             return ret;
         },
-        __wbg_entries_7774d489e1da5f4f: function(arg0) {
+        __wbg_entries_972a87586902cf87: function(arg0) {
             const ret = Object.entries(arg0);
             return ret;
         },
-        __wbg_get_971a0c45d172643f: function() { return handleError(function (arg0, arg1) {
+        __wbg_from_a39669ce566077da: function(arg0) {
+            const ret = Array.from(arg0);
+            return ret;
+        },
+        __wbg_get_6cf5a4d4d8ad3c5a: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(arg0, arg1);
             return ret;
         }, arguments); },
-        __wbg_get_c0c8f8d7da0c03dd: function(arg0, arg1) {
-            const ret = arg0[arg1 >>> 0];
-            return ret;
-        },
-        __wbg_get_d173c0308df22d37: function() { return handleError(function (arg0, arg1) {
+        __wbg_get_989d0a1309644f2b: function() { return handleError(function (arg0, arg1) {
             const ret = Reflect.get(arg0, arg1);
             return ret;
         }, arguments); },
-        __wbg_get_unchecked_e20b893aeafc3fca: function(arg0, arg1) {
+        __wbg_get_b1f0ab13c737f856: function(arg0, arg1) {
+            const ret = arg0[arg1 >>> 0];
+            return ret;
+        },
+        __wbg_get_unchecked_363572bdd397d473: function(arg0, arg1) {
             const ret = arg0[arg1 >>> 0];
             return ret;
         },
@@ -1663,7 +1861,7 @@ function __wbg_get_imports() {
             const ret = arg0[arg1];
             return ret;
         },
-        __wbg_instanceof_ArrayBuffer_993d02d2d254cad1: function(arg0) {
+        __wbg_instanceof_ArrayBuffer_d4ff01f8247925ae: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof ArrayBuffer;
@@ -1673,7 +1871,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Map_9a4d6ead180ae3a9: function(arg0) {
+        __wbg_instanceof_Map_1ff6a2b54c899f0d: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Map;
@@ -1683,7 +1881,17 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_f935dbb0aa7cdeed: function(arg0) {
+        __wbg_instanceof_Set_daa5e1ad3c6acaeb: function(arg0) {
+            let result;
+            try {
+                result = arg0 instanceof Set;
+            } catch (_) {
+                result = false;
+            }
+            const ret = result;
+            return ret;
+        },
+        __wbg_instanceof_Uint8Array_598adc0fef426aa8: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -1693,99 +1901,103 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_isArray_6339f732981044bf: function(arg0) {
+        __wbg_isArray_5674713bb7b79043: function(arg0) {
             const ret = Array.isArray(arg0);
             return ret;
         },
-        __wbg_isSafeInteger_f3d6cd19ccfe4512: function(arg0) {
+        __wbg_isSafeInteger_8f51c743827d1ec5: function(arg0) {
             const ret = Number.isSafeInteger(arg0);
             return ret;
         },
-        __wbg_iterator_5cebbb86e33c6dd6: function() {
+        __wbg_iterator_22ddeb808cf55a6f: function() {
             const ret = Symbol.iterator;
             return ret;
         },
-        __wbg_length_36bd29c6848c2144: function(arg0) {
+        __wbg_length_31bdaf014f5fbde2: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_length_ecfa2c63d3d0d82c: function(arg0) {
+        __wbg_length_4e1adc0d42e23620: function(arg0) {
             const ret = arg0.length;
             return ret;
         },
-        __wbg_new_116be93542d39019: function() {
-            const ret = new Array();
+        __wbg_new_1da3429bc3c4541c: function(arg0) {
+            const ret = new Uint8Array(arg0);
+            return ret;
+        },
+        __wbg_new_8d36e20aa758e411: function() {
+            const ret = new Map();
             return ret;
         },
-        __wbg_new_358857d90afd5a2d: function(arg0, arg1) {
+        __wbg_new_a32a1ab6c6655abe: function(arg0, arg1) {
             const ret = new Error(getStringFromWasm0(arg0, arg1));
             return ret;
         },
-        __wbg_new_77cc4f4f472aeb81: function(arg0) {
-            const ret = new Uint8Array(arg0);
+        __wbg_new_bebc3f4757acf305: function() {
+            const ret = new Object();
             return ret;
         },
-        __wbg_new_cdf041679ded4c5f: function() {
-            const ret = new Map();
+        __wbg_new_ffa92086ea89f79c: function() {
+            const ret = new Array();
             return ret;
         },
-        __wbg_new_ebe3e0f6837f0879: function() {
-            const ret = new Object();
+        __wbg_next_95053e306b1c3aed: function(arg0) {
+            const ret = arg0.next;
             return ret;
         },
-        __wbg_next_42cf16ee0dafc9e2: function() { return handleError(function (arg0) {
+        __wbg_next_f31ecb8646d2c605: function() { return handleError(function (arg0) {
             const ret = arg0.next();
             return ret;
         }, arguments); },
-        __wbg_next_8f26b64fa5e9f64b: function(arg0) {
-            const ret = arg0.next;
-            return ret;
-        },
-        __wbg_of_598c0ff0cd48a890: function(arg0, arg1) {
+        __wbg_of_1c173c2ad96e2f7e: function(arg0, arg1) {
             const ret = Array.of(arg0, arg1);
             return ret;
         },
-        __wbg_prototypesetcall_de8e0d9553586985: function(arg0, arg1, arg2) {
+        __wbg_prototypesetcall_ae9f5e7459250748: function(arg0, arg1, arg2) {
             Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
         },
-        __wbg_push_adb0107829f02d75: function(arg0, arg1) {
+        __wbg_push_bfdf956ba476f65b: function(arg0, arg1) {
             const ret = arg0.push(arg1);
             return ret;
         },
-        __wbg_set_014226dfeca53178: function(arg0, arg1, arg2) {
-            const ret = arg0.set(arg1, arg2);
+        __wbg_random_7bce4e9e78e2e0d0: function() {
+            const ret = Math.random();
             return ret;
         },
+        __wbg_set_13d25b81ab403f5e: function(arg0, arg1, arg2) {
+            arg0[arg1 >>> 0] = arg2;
+        },
         __wbg_set_6be42768c690e380: function(arg0, arg1, arg2) {
             arg0[arg1] = arg2;
         },
-        __wbg_set_8155bb79a948541b: function() { return handleError(function (arg0, arg1, arg2) {
+        __wbg_set_a377297433dfea63: function() { return handleError(function (arg0, arg1, arg2) {
             const ret = Reflect.set(arg0, arg1, arg2);
             return ret;
         }, arguments); },
-        __wbg_set_a80955eb93b145c6: function(arg0, arg1, arg2) {
-            arg0[arg1 >>> 0] = arg2;
+        __wbg_set_bf6dde4923b9b059: function(arg0, arg1, arg2) {
+            const ret = arg0.set(arg1, arg2);
+            return ret;
         },
-        __wbg_value_1e2369fab29b420e: function(arg0) {
+        __wbg_value_c227f843d21da141: function(arg0) {
             const ret = arg0.value;
             return ret;
         },
-        __wbindgen_cast_0000000000000001: function(arg0) {
+        __wbindgen_generic_0000000000000001: function(arg0) {
             // Cast intrinsic for `F64 -> Externref`.
             const ret = arg0;
             return ret;
         },
-        __wbindgen_cast_0000000000000002: function(arg0) {
+        __wbindgen_generic_0000000000000002: function(arg0) {
             // Cast intrinsic for `I64 -> Externref`.
             const ret = arg0;
             return ret;
         },
-        __wbindgen_cast_0000000000000003: function(arg0, arg1) {
+        __wbindgen_generic_0000000000000003: function(arg0, arg1) {
             // Cast intrinsic for `Ref(String) -> Externref`.
             const ret = getStringFromWasm0(arg0, arg1);
             return ret;
         },
-        __wbindgen_cast_0000000000000004: function(arg0) {
+        __wbindgen_generic_0000000000000004: function(arg0) {
             // Cast intrinsic for `U64 -> Externref`.
             const ret = BigInt.asUintN(64, arg0);
             return ret;
@@ -1812,6 +2024,9 @@ const AgentFailureFinalization = (typeof FinalizationRegistry === 'undefined')
 const ClaimRegistryFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_claimregistry_free(ptr, 1));
+const DecisionRegistryFinalization = (typeof FinalizationRegistry === 'undefined')
+    ? { register: () => {}, unregister: () => {} }
+    : new FinalizationRegistry(ptr => wasm.__wbg_decisionregistry_free(ptr, 1));
 const ParticipantRosterFinalization = (typeof FinalizationRegistry === 'undefined')
     ? { register: () => {}, unregister: () => {} }
     : new FinalizationRegistry(ptr => wasm.__wbg_participantroster_free(ptr, 1));

package/index.d.ts

@@ -419,6 +419,56 @@ export class RoomRoster {
   clear(): string[];
 }
 
+export type ClaimOutcome = "claimed" | "already_claimed" | "stale";
+
+/** What a cancellation removed, oldest first. */
+export interface CancelledDecisions {
+  /** Asks nobody claimed -- the caller resolves these. */
+  unclaimed: string[];
+  /** Asks whose claimant still resolves them. */
+  claimed: string[];
+}
+
+/**
+ * Pending chat-mediated asks by token, oldest first. Every registration
+ * returns `[token, ticket]`; later calls name that exact registration, so a
+ * stale holder never acts on a newer ask that reused the token.
+ *
+ * Throws if `maxPending` is not an integer in `1..=4294967295` -- a zero
+ * capacity would evict every ask the moment it arrives -- or if `seed` is
+ * not a `bigint`. Omitted or `null`, `maxPending` never evicts; omitted,
+ * `seed` is drawn fresh. Every `token`/`key`/`roomId` argument below throws
+ * a plain `Error` if it is not a string, and every `ticket` if it is not a
+ * `bigint`.
+ */
+export class DecisionRegistry {
+  constructor(maxPending?: number | null, seed?: bigint);
+  readonly maxPending: number | undefined;
+  registerMinted(roomId?: string | null): [token: string, ticket: bigint] | undefined;
+  registerKeyed(key: string): [token: string, ticket: bigint] | undefined;
+  tryClaim(token: string, ticket: bigint): ClaimOutcome;
+  withdraw(token: string, ticket: bigint): boolean;
+  forget(token: string, ticket: bigint): boolean;
+  unclaimed(): string[];
+  unclaimedInRoom(roomId: string): string[];
+  unclaimedCount(): number;
+  oldestUnclaimed(): string | undefined;
+  evictOldest(): string | undefined;
+  cancelAll(): CancelledDecisions;
+  cancelRoom(roomId: string): CancelledDecisions;
+}
+
+/**
+ * Whether `senderId` may answer an ask: `null` admits anyone; any array or
+ * `Set` -- empty included -- admits only its members. Throws a plain `Error`
+ * if `authorizedSenders` is not an array or `Set` of strings (a bare string
+ * included) or `null`, or if `senderId` is not a string or `null`.
+ */
+export function isAuthorizedSender(
+  authorizedSenders: readonly string[] | ReadonlySet<string> | null,
+  senderId: string | null,
+): boolean;
+
 // The one-shot delivery lifecycle decisions: evaluateDeliveryEvent,
 // evaluateNextMessage, evaluateDrainCandidate, evaluateAdapterResult.
 // Each returns a plain tagged object -- these functions carry no

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@band-ai/band-sdk-core",
-  "version": "2.4.0",
+  "version": "2.6.0",
   "description": "Shared Band event-payload validation",
   "license": "MIT",
   "repository": {