@band-ai/band-sdk-core 2.3.0 → 2.4.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

@@ -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.

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.4.0",
   "description": "Shared Band event-payload validation",
   "license": "MIT",
   "repository": {