@band-ai/band-sdk-core 2.3.0 → 2.5.0

package/README.md

@@ -146,7 +146,27 @@ enum on this boundary, matching how `EventType` stays a plain string in
 native `Error` with the same `.issues`/`.traceContext` contract as
 `validateEventPayload` — an unrecognized `system` and an unrecognized
 `type` are independent issues, both reported when both strings are
-invalid.
+invalid. See "Enumerating memory-taxonomy values" below for listing each
+enum's members without introducing one.
+
+### Enumerating memory-taxonomy values
+
+`memorySystems()`, `memoryTypes()`, `memorySegments()`, `memoryStoreScopes()`,
+`memoryListScopes()`, and `memoryStatuses()` each return that enum's wire
+names as a `string[]`, in declaration order — runtime enumeration without
+introducing a class, matching `MemorySegment`/`MemoryStoreScope`/
+`MemoryListScope`/`MemoryStatus` as string-literal types in `index.d.ts`.
+
+```ts
+import { memorySystems, memoryStatuses } from "@band-ai/band-sdk-core";
+
+if (!memorySystems().includes("sensory")) {
+  throw new Error("memorySystems() missing sensory");
+}
+if (!memoryStatuses().includes("active")) {
+  throw new Error("memoryStatuses() missing active");
+}
+```
 
 ### One-shot delivery lifecycle
 

package/band_sdk_core.js

@@ -1081,11 +1081,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 +1093,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]);
         }
@@ -1407,6 +1407,78 @@ function isSelfEcho(senderId, senderType, agentId) {
 }
 exports.isSelfEcho = isSelfEcho;
 
+/**
+ * r" Every [`MemoryListScope`] wire name, in declaration order.
+ * @returns {string[]}
+ */
+function memoryListScopes() {
+    const ret = wasm.memoryListScopes();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+}
+exports.memoryListScopes = memoryListScopes;
+
+/**
+ * r" Every [`MemorySegment`] wire name, in declaration order.
+ * @returns {string[]}
+ */
+function memorySegments() {
+    const ret = wasm.memorySegments();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+}
+exports.memorySegments = memorySegments;
+
+/**
+ * r" Every [`MemoryStatus`] wire name, in declaration order.
+ * @returns {string[]}
+ */
+function memoryStatuses() {
+    const ret = wasm.memoryStatuses();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+}
+exports.memoryStatuses = memoryStatuses;
+
+/**
+ * r" Every [`MemoryStoreScope`] wire name, in declaration order.
+ * @returns {string[]}
+ */
+function memoryStoreScopes() {
+    const ret = wasm.memoryStoreScopes();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+}
+exports.memoryStoreScopes = memoryStoreScopes;
+
+/**
+ * r" Every [`MemorySystem`] wire name, in declaration order.
+ * @returns {string[]}
+ */
+function memorySystems() {
+    const ret = wasm.memorySystems();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+}
+exports.memorySystems = memorySystems;
+
+/**
+ * r" Every [`MemoryType`] wire name, in declaration order.
+ * @returns {string[]}
+ */
+function memoryTypes() {
+    const ret = wasm.memoryTypes();
+    var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]);
+    wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
+    return v1;
+}
+exports.memoryTypes = memoryTypes;
+
 /**
  * This platform's Phoenix Channels topic for a room's `room_participants`
  * channel.
@@ -1476,7 +1548,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;
         },
@@ -1487,68 +1559,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);
@@ -1556,34 +1628,34 @@ 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_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;
         },
@@ -1591,7 +1663,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;
@@ -1601,7 +1673,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;
@@ -1611,7 +1683,7 @@ function __wbg_get_imports() {
             const ret = result;
             return ret;
         },
-        __wbg_instanceof_Uint8Array_f935dbb0aa7cdeed: function(arg0) {
+        __wbg_instanceof_Uint8Array_598adc0fef426aa8: function(arg0) {
             let result;
             try {
                 result = arg0 instanceof Uint8Array;
@@ -1621,99 +1693,99 @@ 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);
-            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;

package/index.d.ts

@@ -85,6 +85,36 @@ export function validateMemoryTypeForSystem(
   traceContext?: string | null,
 ): void;
 
+/** Logical subject category for a stored memory -- not a store/list scope. */
+export type MemorySegment = "user" | "agent" | "tool" | "guideline";
+
+/** Visibility scope for storing a memory. */
+export type MemoryStoreScope = "subject" | "organization";
+
+/** Scope filter for listing memories. */
+export type MemoryListScope = "subject" | "organization" | "all";
+
+/** Lifecycle state; list filter and set by supersede/archive operations. */
+export type MemoryStatus = "active" | "superseded" | "archived" | "all";
+
+/** Every {@link MemorySystem} wire name, in declaration order. */
+export function memorySystems(): MemorySystem[];
+
+/** Every {@link MemoryType} wire name, in declaration order. */
+export function memoryTypes(): MemoryType[];
+
+/** Every {@link MemorySegment} wire name, in declaration order. */
+export function memorySegments(): MemorySegment[];
+
+/** Every {@link MemoryStoreScope} wire name, in declaration order. */
+export function memoryStoreScopes(): MemoryStoreScope[];
+
+/** Every {@link MemoryListScope} wire name, in declaration order. */
+export function memoryListScopes(): MemoryListScope[];
+
+/** Every {@link MemoryStatus} wire name, in declaration order. */
+export function memoryStatuses(): MemoryStatus[];
+
 /** A roster entry read by `ParticipantRoster`; every other key is ignored. */
 export interface ParticipantFields {
   id: string;

package/package.json

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