@smartmemory/sdk-js 1.4.59 → 1.4.61

package/dist/{core-BEScfRuq.js → core-GpqOJ8RQ.js}

@@ -1,32 +1,32 @@
-var S = (a) => {
+var P = (a) => {
   throw TypeError(a);
 };
-var w = (a, e, t) => e.has(a) || S("Cannot " + t);
-var d = (a, e, t) => (w(a, e, "read from private field"), t ? t.call(a) : e.get(a)), b = (a, e, t) => e.has(a) ? S("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(a) : e.set(a, t), I = (a, e, t, s) => (w(a, e, "write to private field"), s ? s.call(a, t) : e.set(a, t), t), v = (a, e, t) => (w(a, e, "access private method"), t);
-const P = {
+var T = (a, e, t) => e.has(a) || P("Cannot " + t);
+var R = (a, e, t) => (T(a, e, "read from private field"), t ? t.call(a) : e.get(a)), v = (a, e, t) => e.has(a) ? P("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(a) : e.set(a, t), A = (a, e, t, s) => (T(a, e, "write to private field"), s ? s.call(a, t) : e.set(a, t), t), q = (a, e, t) => (T(a, e, "access private method"), t);
+const M = {
   access: "smart_memory_auth_token",
   refresh: "smart_memory_refresh_token",
   user: "smart_memory_user",
   tenant: "smart_memory_tenant_id",
   team: "smart_memory_team_id"
-}, y = {
+}, w = {
   access: ["access_token", "sm_token"],
   refresh: ["refresh_token", "sm_refresh_token"],
   user: ["sm_user"],
   tenant: ["tenant_id", "workspace_id", "sm_workspace_id"],
   team: ["team_id", "sm_team_id"]
 };
-class L {
+class z {
   /**
    * @param {Object} options
    * @param {'localStorage' | 'sessionStorage' | 'memory'} [options.storage='localStorage']
    * @param {Object} [options.keys] - Custom storage key names
    */
   constructor({ storage: e = "localStorage", keys: t = {} } = {}) {
-    this.storageType = e, this.keys = { ...P, ...t }, this._memory = { access: null, refresh: null, user: null, tenant: null, team: null };
+    this.storageType = e, this.keys = { ...M, ...t }, this._memory = { access: null, refresh: null, user: null, tenant: null, team: null };
   }
   getAccessToken() {
-    return this.storageType === "memory" ? this._memory.access : this._getFromStorage(this.keys.access, y.access);
+    return this.storageType === "memory" ? this._memory.access : this._getFromStorage(this.keys.access, w.access);
   }
   setAccessToken(e) {
     if (this.storageType === "memory") {
@@ -36,7 +36,7 @@ class L {
     this._setInStorage(this.keys.access, e);
   }
   getRefreshToken() {
-    return this.storageType === "memory" ? this._memory.refresh : this._getFromStorage(this.keys.refresh, y.refresh);
+    return this.storageType === "memory" ? this._memory.refresh : this._getFromStorage(this.keys.refresh, w.refresh);
   }
   setRefreshToken(e) {
     if (this.storageType === "memory") {
@@ -47,7 +47,7 @@ class L {
   }
   getUser() {
     if (this.storageType === "memory") return this._memory.user;
-    const e = this._getFromStorage(this.keys.user, y.user);
+    const e = this._getFromStorage(this.keys.user, w.user);
     if (!e) return null;
     try {
       return JSON.parse(e);
@@ -63,7 +63,7 @@ class L {
     this._setInStorage(this.keys.user, e ? JSON.stringify(e) : null);
   }
   getTenantId() {
-    return this.storageType === "memory" ? this._memory.tenant : this._normalizeId(this._getFromStorage(this.keys.tenant, y.tenant));
+    return this.storageType === "memory" ? this._memory.tenant : this._normalizeId(this._getFromStorage(this.keys.tenant, w.tenant));
   }
   setTenantId(e) {
     const t = this._normalizeId(e);
@@ -74,7 +74,7 @@ class L {
     this._setInStorage(this.keys.tenant, t);
   }
   getTeamId() {
-    return this.storageType === "memory" ? this._memory.team : this._normalizeId(this._getFromStorage(this.keys.team, y.team));
+    return this.storageType === "memory" ? this._memory.team : this._normalizeId(this._getFromStorage(this.keys.team, w.team));
   }
   setTeamId(e) {
     const t = this._normalizeId(e);
@@ -94,7 +94,7 @@ class L {
         localStorage.removeItem(e), sessionStorage.removeItem(e);
       } catch {
       }
-    for (const e of Object.values(y))
+    for (const e of Object.values(w))
       for (const t of e)
         try {
           localStorage.removeItem(t), sessionStorage.removeItem(t);
@@ -112,17 +112,17 @@ class L {
   /** @private */
   _getFromStorage(e, t = []) {
     try {
-      const s = this.storageType === "localStorage" ? localStorage : sessionStorage, r = this.storageType === "localStorage" ? sessionStorage : localStorage, n = s.getItem(e) || r.getItem(e);
-      if (n != null) return n;
+      const s = this.storageType === "localStorage" ? localStorage : sessionStorage, n = this.storageType === "localStorage" ? sessionStorage : localStorage, r = s.getItem(e) || n.getItem(e);
+      if (r != null) return r;
       for (const i of t) {
-        const o = s.getItem(i) || r.getItem(i);
-        if (o != null) {
-          this._setInStorage(e, o);
+        const c = s.getItem(i) || n.getItem(i);
+        if (c != null) {
+          this._setInStorage(e, c);
           try {
-            s.removeItem(i), r.removeItem(i);
+            s.removeItem(i), n.removeItem(i);
           } catch {
           }
-          return o;
+          return c;
         }
       }
       return null;
@@ -133,8 +133,8 @@ class L {
   /** @private */
   _setInStorage(e, t) {
     try {
-      const s = this.storageType === "localStorage" ? localStorage : sessionStorage, r = this.storageType === "localStorage" ? sessionStorage : localStorage;
-      t != null ? (s.setItem(e, t), r.removeItem(e)) : (s.removeItem(e), r.removeItem(e));
+      const s = this.storageType === "localStorage" ? localStorage : sessionStorage, n = this.storageType === "localStorage" ? sessionStorage : localStorage;
+      t != null ? (s.setItem(e, t), n.removeItem(e)) : (s.removeItem(e), n.removeItem(e));
     } catch (s) {
       console.error("Failed to write to storage:", s);
     }
@@ -148,8 +148,8 @@ class L {
     return s === "none" || s === "null" || s === "undefined" ? null : t;
   }
 }
-var l, _, T;
-class q {
+var f, U, L;
+class E {
   /**
    * @param {Object} options
    * @param {string} options.apiBaseUrl
@@ -159,23 +159,23 @@ class q {
    * @param {function(string): void} options.onTokenRefreshed
    * @param {function(): void} options.onRefreshFailed
    */
-  constructor({ apiBaseUrl: e, refreshEndpoint: t, tokenManager: s, useCookieAuth: r = !1, onTokenRefreshed: n, onRefreshFailed: i }) {
-    b(this, _);
-    b(this, l, null);
-    this.apiBaseUrl = e, this.refreshEndpoint = t, this.tokenManager = s, this.useCookieAuth = r, this.onTokenRefreshed = n, this.onRefreshFailed = i;
+  constructor({ apiBaseUrl: e, refreshEndpoint: t, tokenManager: s, useCookieAuth: n = !1, onTokenRefreshed: r, onRefreshFailed: i }) {
+    v(this, U);
+    v(this, f, null);
+    this.apiBaseUrl = e, this.refreshEndpoint = t, this.tokenManager = s, this.useCookieAuth = n, this.onTokenRefreshed = r, this.onRefreshFailed = i;
   }
   async refresh() {
-    if (d(this, l))
-      return d(this, l);
-    I(this, l, v(this, _, T).call(this));
+    if (R(this, f))
+      return R(this, f);
+    A(this, f, q(this, U, L).call(this));
     try {
-      return await d(this, l);
+      return await R(this, f);
     } finally {
-      I(this, l, null);
+      A(this, f, null);
     }
   }
 }
-l = new WeakMap(), _ = new WeakSet(), T = async function() {
+f = new WeakMap(), U = new WeakSet(), L = async function() {
   const e = this.tokenManager.getRefreshToken();
   if (!e && !this.useCookieAuth)
     throw this.onRefreshFailed(), new Error("No refresh token");
@@ -187,11 +187,11 @@ l = new WeakMap(), _ = new WeakSet(), T = async function() {
   });
   if (!s.ok)
     throw this.onRefreshFailed(), new Error(`Refresh failed: ${s.status}`);
-  const r = await s.json();
-  return this.tokenManager.setAccessToken(r.access_token), r.refresh_token && this.tokenManager.setRefreshToken(r.refresh_token), this.onTokenRefreshed(r.access_token), r.access_token;
+  const n = await s.json();
+  return this.tokenManager.setAccessToken(n.access_token), n.refresh_token && this.tokenManager.setRefreshToken(n.refresh_token), this.onTokenRefreshed(n.access_token), n.access_token;
 };
-const R = "smart_memory_sso_redirect";
-class M {
+const C = "smart_memory_sso_redirect";
+class x {
   /**
    * @param {Object} options
    * @param {string} options.webAppUrl - Web app URL for login redirect
@@ -216,26 +216,26 @@ class M {
   }
   storeRedirect(e) {
     try {
-      sessionStorage.setItem(R, e);
+      sessionStorage.setItem(C, e);
     } catch (t) {
       console.warn("Failed to store redirect URL:", t);
     }
   }
   getAndClearRedirect() {
     try {
-      const e = sessionStorage.getItem(R);
-      return sessionStorage.removeItem(R), e;
+      const e = sessionStorage.getItem(C);
+      return sessionStorage.removeItem(C), e;
     } catch {
       return null;
     }
   }
 }
-class z {
+class F {
   constructor(e) {
-    this.mode = e.mode, this.apiBaseUrl = e.apiBaseUrl, this.endpoints = e.endpoints || {}, this.listeners = /* @__PURE__ */ new Set(), this.useCookieAuth = e.useCookieAuth ?? this.mode === "sso", this.apiKey = e.apiKey || null, this.apiKey && (this.mode = "apiKey"), this.tokenManager = new L({
+    this.mode = e.mode, this.apiBaseUrl = e.apiBaseUrl, this.endpoints = e.endpoints || {}, this.listeners = /* @__PURE__ */ new Set(), this.useCookieAuth = e.useCookieAuth ?? this.mode === "sso", this.apiKey = e.apiKey || null, this.apiKey && (this.mode = "apiKey"), this.tokenManager = new z({
       storage: e.storage || "localStorage",
       keys: e.tokenKeys
-    }), this.mode !== "apiKey" ? this.refreshManager = new q({
+    }), this.mode !== "apiKey" ? this.refreshManager = new E({
       apiBaseUrl: this.apiBaseUrl,
       refreshEndpoint: this.endpoints.refresh || "/auth/refresh",
       tokenManager: this.tokenManager,
@@ -247,7 +247,7 @@ class z {
       onRefreshFailed: () => {
         this.clearLocalAuth();
       }
-    }) : this.refreshManager = null, this.mode === "sso" && (this.ssoManager = new M({
+    }) : this.refreshManager = null, this.mode === "sso" && (this.ssoManager = new x({
       webAppUrl: e.webAppUrl,
       allowedHosts: e.allowedRedirectHosts || [],
       tokenManager: this.tokenManager
@@ -355,10 +355,10 @@ class z {
         } catch {
         }
       if (!t.ok) return !1;
-      const r = await t.json();
-      this.currentUser = r, this.tokenManager.setUser(r);
-      const n = (r == null ? void 0 : r.default_team_id) || this.tokenManager.getTeamId() || null;
-      return n && (this.tokenManager.setTeamId(n), this.tokenManager.setTenantId((r == null ? void 0 : r.tenant_id) || n)), s && (this.tokenManager.setAccessToken(null), this.currentToken = null, r != null && r.default_team_id && this.tokenManager.setTeamId(r.default_team_id)), this.notifyListeners(), !0;
+      const n = await t.json();
+      this.currentUser = n, this.tokenManager.setUser(n);
+      const r = (n == null ? void 0 : n.default_team_id) || this.tokenManager.getTeamId() || null;
+      return r && (this.tokenManager.setTeamId(r), this.tokenManager.setTenantId((n == null ? void 0 : n.tenant_id) || r)), s && (this.tokenManager.setAccessToken(null), this.currentToken = null, n != null && n.default_team_id && this.tokenManager.setTeamId(n.default_team_id)), this.notifyListeners(), !0;
     } catch {
       return !1;
     }
@@ -367,7 +367,7 @@ class z {
     this.tokenManager.setTenantId(e), this.notifyListeners();
   }
 }
-class h extends Error {
+class k extends Error {
   /**
    * @param {string} message - Error message
    * @param {number} [status=0] - HTTP status code (0 for network errors)
@@ -377,10 +377,10 @@ class h extends Error {
     super(e), this.name = "APIError", this.status = t, this.detail = s;
   }
 }
-function f(a) {
+function S(a) {
   return typeof FormData < "u" && a instanceof FormData;
 }
-class E {
+class O {
   /**
    * @param {import('../auth/AuthCore.js').AuthCore} authCore
    * @param {{ fetchFn?: typeof globalThis.fetch }} [options]
@@ -392,35 +392,35 @@ class E {
     return this._customFetchFn || globalThis.fetch.bind(globalThis);
   }
   async request(e, t = {}) {
-    var i, o;
-    const s = `${this.baseURL}${e}`, r = {
-      ...f(t.body) ? {} : { "Content-Type": "application/json" },
+    var i, c;
+    const s = `${this.baseURL}${e}`, n = {
+      ...S(t.body) ? {} : { "Content-Type": "application/json" },
       ...this.auth.getAuthHeaders(t.headers)
-    }, n = this.auth.getRequestOptions({ ...t, headers: r });
+    }, r = this.auth.getRequestOptions({ ...t, headers: n });
     try {
-      let c = await this.fetchFn(s, n);
-      if (c.status === 401 && !t.__isRetry)
+      let o = await this.fetchFn(s, r);
+      if (o.status === 401 && !t.__isRetry)
         try {
           await this.auth.refreshToken();
-          const m = {
-            ...f(t.body) ? {} : { "Content-Type": "application/json" },
+          const h = {
+            ...S(t.body) ? {} : { "Content-Type": "application/json" },
             ...this.auth.getAuthHeaders(t.headers)
           };
-          c = await this.fetchFn(
+          o = await this.fetchFn(
             s,
-            this.auth.getRequestOptions({ ...n, headers: m, __isRetry: !0 })
+            this.auth.getRequestOptions({ ...r, headers: h, __isRetry: !0 })
           );
         } catch {
         }
-      if (c.status === 401)
-        throw (o = (i = this.auth).clearLocalAuth) == null || o.call(i), new h("Authentication required", 401, "auth_expired");
-      if (c.status === 204)
+      if (o.status === 401)
+        throw (c = (i = this.auth).clearLocalAuth) == null || c.call(i), new k("Authentication required", 401, "auth_expired");
+      if (o.status === 204)
         return null;
-      if (!c.ok)
-        throw await this._handleError(c);
-      return await c.json();
-    } catch (c) {
-      throw c instanceof h ? c : new h(c.message, 0, "network_error");
+      if (!o.ok)
+        throw await this._handleError(o);
+      return await o.json();
+    } catch (o) {
+      throw o instanceof k ? o : new k(o.message, 0, "network_error");
     }
   }
   async get(e, t = {}) {
@@ -434,33 +434,33 @@ class E {
     });
   }
   async requestBinary(e, t = {}) {
-    var i, o;
-    const s = `${this.baseURL}${e}`, r = {
-      ...f(t.body) ? {} : { "Content-Type": "application/json" },
+    var i, c;
+    const s = `${this.baseURL}${e}`, n = {
+      ...S(t.body) ? {} : { "Content-Type": "application/json" },
       ...this.auth.getAuthHeaders(t.headers)
-    }, n = this.auth.getRequestOptions({ ...t, headers: r });
+    }, r = this.auth.getRequestOptions({ ...t, headers: n });
     try {
-      let c = await this.fetchFn(s, n);
-      if (c.status === 401 && !t.__isRetry)
+      let o = await this.fetchFn(s, r);
+      if (o.status === 401 && !t.__isRetry)
         try {
           await this.auth.refreshToken();
-          const m = {
-            ...f(t.body) ? {} : { "Content-Type": "application/json" },
+          const h = {
+            ...S(t.body) ? {} : { "Content-Type": "application/json" },
             ...this.auth.getAuthHeaders(t.headers)
           };
-          c = await this.fetchFn(
+          o = await this.fetchFn(
             s,
-            this.auth.getRequestOptions({ ...n, headers: m, __isRetry: !0 })
+            this.auth.getRequestOptions({ ...r, headers: h, __isRetry: !0 })
           );
         } catch {
         }
-      if (c.status === 401)
-        throw (o = (i = this.auth).clearLocalAuth) == null || o.call(i), new h("Authentication required", 401, "auth_expired");
-      if (!c.ok)
-        throw await this._handleError(c);
-      return await c.arrayBuffer();
-    } catch (c) {
-      throw c instanceof h ? c : new h(c.message, 0, "network_error");
+      if (o.status === 401)
+        throw (c = (i = this.auth).clearLocalAuth) == null || c.call(i), new k("Authentication required", 401, "auth_expired");
+      if (!o.ok)
+        throw await this._handleError(o);
+      return await o.arrayBuffer();
+    } catch (o) {
+      throw o instanceof k ? o : new k(o.message, 0, "network_error");
     }
   }
   async postForm(e, t, s = {}) {
@@ -489,15 +489,15 @@ class E {
   }
   /** @private */
   async _handleError(e) {
-    var r, n;
+    var n, r;
     let t;
-    const s = (n = (r = e.headers) == null ? void 0 : r.get) == null ? void 0 : n.call(r, "content-type");
+    const s = (r = (n = e.headers) == null ? void 0 : n.get) == null ? void 0 : r.call(n, "content-type");
     try {
       s != null && s.includes("application/json") ? t = await e.json() : t = { message: await e.text() };
     } catch {
       t = { message: `HTTP ${e.status}` };
     }
-    return new h(
+    return new k(
       this._extractMessage(t, e.status),
       e.status,
       t
@@ -516,18 +516,18 @@ class E {
    * @private
    */
   _extractMessage(e, t) {
-    var r;
+    var n;
     const s = e == null ? void 0 : e.detail;
     if (typeof s == "string") return s;
     if (s && typeof s == "object") {
       if (typeof s.message == "string") return s.message;
       if (typeof s.code == "string") return s.code;
-      if (Array.isArray(s) && typeof ((r = s[0]) == null ? void 0 : r.msg) == "string") return s[0].msg;
+      if (Array.isArray(s) && typeof ((n = s[0]) == null ? void 0 : n.msg) == "string") return s[0].msg;
     }
     return typeof (e == null ? void 0 : e.message) == "string" ? e.message : `HTTP ${t}`;
   }
 }
-class x {
+class j {
   constructor(e) {
     this.api = e;
   }
@@ -545,26 +545,32 @@ class x {
    * @param {boolean} [options.usePipeline=true] - Run the full extraction pipeline
    * @param {string} [options.profileName] - Pipeline profile, routed server-side
    * @param {Object} [options.conversationContext] - Conversation-aware extraction context
+   * @param {boolean} [options.embed] - SVC-EMBED-CONTROL-1 embedding override.
+   *   `true` forces an embedding, `false` suppresses one, omitted leaves existing
+   *   behaviour untouched. **Only valid with `usePipeline: false`** — the server
+   *   answers 400 for the combination rather than silently ignoring it, because
+   *   the ingestion pipeline has no per-item override.
    */
   async create({
     content: e,
     memoryType: t = "semantic",
     metadata: s = null,
-    usePipeline: r = !0,
-    profileName: n = null,
-    conversationContext: i = null
+    usePipeline: n = !0,
+    profileName: r = null,
+    conversationContext: i = null,
+    embed: c = null
   }) {
     const o = {
       content: e,
       memory_type: t,
       metadata: s,
-      use_pipeline: r,
-      profile_name: n
+      use_pipeline: n,
+      profile_name: r
     };
-    return i != null && (o.conversation_context = i), this.api.post("/memory/add", o);
+    return i != null && (o.conversation_context = i), c != null && (o.embed = c), this.api.post("/memory/add", o);
   }
   async get(e) {
-    const t = await this.api.get(`/memory/${e}`);
+    const t = await this.api.get(`/memory/${encodeURIComponent(e)}`);
     return { ...t, id: t.item_id || t.id };
   }
   /**
@@ -581,18 +587,40 @@ class x {
    *   (preserving memory_type and node_category).
    */
   async update(e, t) {
-    return this.api.patch(`/memory/${e}`, t);
+    return this.api.patch(`/memory/${encodeURIComponent(e)}`, t);
   }
-  async supersede(e, { content: t, memoryType: s, metadata: r = {}, reason: n }) {
-    return this.api.post(`/memory/${e}/supersede`, {
+  async supersede(e, { content: t, memoryType: s, metadata: n = {}, reason: r }) {
+    return this.api.post(`/memory/${encodeURIComponent(e)}/supersede`, {
       content: t,
       memory_type: s,
-      metadata: r,
-      reason: n
+      metadata: n,
+      reason: r
+    });
+  }
+  /**
+   * Link two ALREADY-STORED items as a supersession (SVC-SUPERSEDE-LINK-1).
+   *
+   * Use this when both records exist. Use {@link supersede} instead when the
+   * replacement still has to be created from content.
+   *
+   * The write stamps the OLD record with `superseded`, `superseded_by` and
+   * `superseded_at`. Detect supersession by reading those off a recalled record —
+   * the newer record carries no marker, so never scan for inbound links.
+   *
+   * @param {string} id - The OLD item (the one being superseded)
+   * @param {string} newItemId - The NEW item; must already exist and be in scope
+   * @param {string} [reason] - Optional human-readable reason
+   * @throws 400 if `newItemId` equals `id`; 404 if either item is missing *or*
+   *   out of scope (deliberately indistinguishable); 409 if the store declined.
+   */
+  async supersedeLink(e, t, s = null) {
+    return this.api.post(`/memory/${encodeURIComponent(e)}/supersede-link`, {
+      new_item_id: t,
+      reason: s
     });
   }
   async delete(e) {
-    return this.api.delete(`/memory/${e}`);
+    return this.api.delete(`/memory/${encodeURIComponent(e)}`);
   }
   /**
    * List memory items, optionally filtered by an exact metadata match.
@@ -614,11 +642,11 @@ class x {
     limit: e = 50,
     offset: t = 0,
     type: s = null,
-    metadataKey: r = null,
-    metadataValue: n = null
+    metadataKey: n = null,
+    metadataValue: r = null
   } = {}) {
     const i = new URLSearchParams({ limit: e, offset: t });
-    return s && i.append("memory_type", s), r != null && i.append("metadata_key", r), n != null && i.append("metadata_value", n), this.api.get(`/memory/list?${i}`);
+    return s && i.append("memory_type", s), n != null && i.append("metadata_key", n), r != null && i.append("metadata_value", r), this.api.get(`/memory/list?${i}`);
   }
   /**
    * Search for memory items.
@@ -640,8 +668,18 @@ class x {
    * @param {string|Date|null} [options.asOfDate=null] - Transaction-time travel
    *   (PLAT-AUDITABLE-MEMORY-1): return what the system believed at this
    *   ISO-8601 instant. Date objects serialize to ISO automatically.
+   * @param {boolean} [options.asOfStrict=false] - Only meaningful with asOfDate
+   *   (PLAT-AUDITABLE-MEMORY-1 gap #2). Default returns results that could not be
+   *   resolved, each carrying `as_of_resolution: 'unresolved'`, and summarises them
+   *   in the envelope's `as_of_diagnostics`. When true the request fails with 422
+   *   instead, for callers who would rather have no answer than a partial history.
    * @param {boolean} [options.includeSuperseded=false] - Keep superseded items
    *   visible in results (PLAT-AUDITABLE-MEMORY-1).
+   * @param {boolean} [options.includeRetracted=false] - Keep retracted items visible
+   *   in results (CORE-RETRACTED-RECALL-1). A retracted belief was withdrawn outright
+   *   with no replacement, so it is a separate lifecycle state from superseded and is
+   *   NOT covered by includeSuperseded. Both are inert when asOfDate is set, which
+   *   retains those rows regardless.
    * @param {boolean} [options.cite=false] - When true (RECALL-CITATIONS-1), the
    *   envelope gains a `citations` array of `{n, item_id, item_type, preview, score, footnote_marker}`.
    *   Empty `citations: []` when no results — distinguishes "no results" from "no citations requested".
@@ -652,11 +690,15 @@ class x {
    *   carries `GroupRootStub`s for any lineage root_id referenced by some
    *   result's `lineage_roots` but not itself in `results`; `citations` is
    *   present only under `cite: true`. Pre-LINEAGE-1 callers who indexed into a
-   *   bare array must read `response.results` instead.
+   *   bare array must read `response.results` instead. When `asOfDate` is set the
+   *   envelope also carries `as_of_diagnostics` ({as_of, policy, unresolved_count,
+   *   unresolved_item_ids, note}) and every result carries `as_of_resolution`. A
+   *   result marked `'unresolved'` is PRESENT-DAY content and must not be rendered
+   *   as a historical belief.
    */
-  async search(e, { topK: t = 5, enableHybrid: s = !0, memoryType: r = null, expertise: n = !1, cite: i = !1, decompose: o = !1, multiHop: c = !1, maxHops: m = 3, budgetMs: p = 1500, semanticHops: $ = !1, includeReference: k = !1, includeConsolidated: U = !1, consolidationFirst: A = !1, asOfDate: g = null, includeSuperseded: C = !1 } = {}) {
-    const u = { query: e, top_k: t, enable_hybrid: s };
-    return r && (u.memory_type = r), n && (u.expertise = !0), i && (u.cite = !0), o && (u.decompose = !0), c && (u.multi_hop = !0), c && m !== 3 && (u.max_hops = m), c && p !== 1500 && (u.budget_ms = p), c && $ && (u.semantic_hops = !0), k && (u.include_reference = !0), U && (u.include_consolidated = !0), A && (u.consolidation_first = !0), g && (u.as_of_date = g instanceof Date ? g.toISOString() : g), C && (u.include_superseded = !0), this.api.post("/memory/search", u);
+  async search(e, { topK: t = 5, enableHybrid: s = !0, memoryType: n = null, expertise: r = !1, cite: i = !1, decompose: c = !1, multiHop: o = !1, maxHops: h = 3, budgetMs: y = 1500, semanticHops: p = !1, includeReference: d = !1, includeConsolidated: _ = !1, consolidationFirst: $ = !1, asOfDate: g = null, asOfStrict: u = !1, includeSuperseded: b = !1, includeRetracted: I = !1 } = {}) {
+    const l = { query: e, top_k: t, enable_hybrid: s };
+    return n && (l.memory_type = n), r && (l.expertise = !0), i && (l.cite = !0), c && (l.decompose = !0), o && (l.multi_hop = !0), o && h !== 3 && (l.max_hops = h), o && y !== 1500 && (l.budget_ms = y), o && p && (l.semantic_hops = !0), d && (l.include_reference = !0), _ && (l.include_consolidated = !0), $ && (l.consolidation_first = !0), g && (l.as_of_date = g instanceof Date ? g.toISOString() : g), u && (l.as_of_strict = !0), b && (l.include_superseded = !0), I && (l.include_retracted = !0), this.api.post("/memory/search", l);
   }
   /**
    * Get the complete audit answer for one memory (PLAT-AUDITABLE-MEMORY-1).
@@ -674,35 +716,35 @@ class x {
   async explain(e) {
     return this.api.get(`/memory/${encodeURIComponent(e)}/explain`);
   }
-  async getWorkingContext(e, t, { k: s = 20, maxTokens: r = null, strategy: n = null } = {}) {
+  async getWorkingContext(e, t, { k: s = 20, maxTokens: n = null, strategy: r = null } = {}) {
     const i = {
       session_id: e,
       query: t,
       k: s
     };
-    return r != null && (i.max_tokens = r), n != null && (i.strategy = n), this.api.post("/memory/context", i);
+    return n != null && (i.max_tokens = n), r != null && (i.strategy = r), this.api.post("/memory/context", i);
   }
-  async searchAdvanced(e, { algorithm: t = "query_traversal", maxResults: s = 15, useSSG: r = !0 } = {}) {
+  async searchAdvanced(e, { algorithm: t = "query_traversal", maxResults: s = 15, useSSG: n = !0 } = {}) {
     return this.api.post("/memory/search/advanced", {
       query: e,
       algorithm: t,
       max_results: s,
-      use_ssg: r
+      use_ssg: n
     });
   }
-  async ingest(e, { profileName: t = null, extractorName: s = "llm", context: r = {} } = {}) {
+  async ingest(e, { profileName: t = null, extractorName: s = "llm", context: n = {} } = {}) {
     return this.api.post("/memory/ingest", {
       content: e,
       profile_name: t,
       extractor_name: s,
-      context: r
+      context: n
     });
   }
   async getLineage(e) {
-    return this.api.get(`/memory/${e}/lineage`);
+    return this.api.get(`/memory/${encodeURIComponent(e)}/lineage`);
   }
   async getLinks(e) {
-    return this.api.get(`/memory/${e}/links`);
+    return this.api.get(`/memory/${encodeURIComponent(e)}/links`);
   }
   /**
    * Find memory items by exact metadata match.
@@ -713,16 +755,16 @@ class x {
    *   endpoints return slightly different item shapes, so migrate deliberately rather
    *   than by find-and-replace.
    */
-  async searchByMetadata(e, t, { memoryType: s = null, limit: r = 25 } = {}) {
-    const n = new URLSearchParams({
+  async searchByMetadata(e, t, { memoryType: s = null, limit: n = 25 } = {}) {
+    const r = new URLSearchParams({
       metadata_key: e,
       metadata_value: t,
-      limit: r
+      limit: n
     });
-    return s && n.append("memory_type", s), this.api.get(`/memory/by-metadata?${n}`);
+    return s && r.append("memory_type", s), this.api.get(`/memory/by-metadata?${r}`);
   }
   async getNeighbors(e) {
-    return this.api.get(`/memory/${e}/neighbors`);
+    return this.api.get(`/memory/${encodeURIComponent(e)}/neighbors`);
   }
   async getSummary() {
     return this.api.get("/memory/summary");
@@ -730,24 +772,24 @@ class x {
   async ingestConversation(e, {
     sessionBoundaries: t = null,
     conversationId: s = null,
-    sessionDates: r = null,
-    turnsPerChunk: n = 15,
+    sessionDates: n = null,
+    turnsPerChunk: r = 15,
     maxChunkChars: i = 12e3,
-    maxConcurrent: o = 4
+    maxConcurrent: c = 4
   } = {}) {
-    const c = { turns: e, turns_per_chunk: n, max_chunk_chars: i, max_concurrent: o };
-    return t && (c.session_boundaries = t), s && (c.conversation_id = s), r && (c.session_dates = r), this.api.post("/memory/ingest/conversation", c);
+    const o = { turns: e, turns_per_chunk: r, max_chunk_chars: i, max_concurrent: c };
+    return t && (o.session_boundaries = t), s && (o.conversation_id = s), n && (o.session_dates = n), this.api.post("/memory/ingest/conversation", o);
   }
-  async ingestDocument(e, { title: t = null, source: s = null, chunkStrategy: r = null } = {}) {
-    const n = { content: e };
-    return t && (n.title = t), s && (n.source = s), r && (n.chunk_strategy = r), this.api.post("/memory/ingest/document", n);
+  async ingestDocument(e, { title: t = null, source: s = null, chunkStrategy: n = null } = {}) {
+    const r = { content: e };
+    return t && (r.title = t), s && (r.source = s), n && (r.chunk_strategy = n), this.api.post("/memory/ingest/document", r);
   }
   async codeIndex(e, { repo: t = null, commit: s = null } = {}) {
-    const r = { path: e };
-    return t && (r.repo = t), s && (r.commit = s), this.api.post("/memory/code/index", r);
+    const n = { path: e };
+    return t && (n.repo = t), s && (n.commit = s), this.api.post("/memory/code/index", n);
   }
-  async codeSearch(e, { entityType: t = null, repo: s = null, limit: r = 20, semantic: n = !1 } = {}) {
-    const i = new URLSearchParams({ query: e, limit: r, semantic: n });
+  async codeSearch(e, { entityType: t = null, repo: s = null, limit: n = 20, semantic: r = !1 } = {}) {
+    const i = new URLSearchParams({ query: e, limit: n, semantic: r });
     return t && i.append("entity_type", t), s && i.append("repo", s), this.api.get(`/memory/code/search?${i}`);
   }
   async codeContext(e, { repo: t = null } = {}) {
@@ -758,8 +800,8 @@ class x {
     return this.api.get(`/memory/code/dead-code?repo=${encodeURIComponent(e)}`);
   }
   async codeDependencies(e, { direction: t = "both", repo: s = null } = {}) {
-    const r = new URLSearchParams({ entity_name: e, direction: t });
-    return s && r.append("repo", s), this.api.get(`/memory/code/dependencies?${r}`);
+    const n = new URLSearchParams({ entity_name: e, direction: t });
+    return s && n.append("repo", s), this.api.get(`/memory/code/dependencies?${n}`);
   }
   async getPlan(e) {
     return this.api.get(`/memory/plans/${e}`);
@@ -781,7 +823,7 @@ class x {
     });
   }
   async enrich(e, t = []) {
-    return this.api.post(`/memory/${e}/enrich`, {
+    return this.api.post(`/memory/${encodeURIComponent(e)}/enrich`, {
       item_id: e,
       routines: t
     });
@@ -802,11 +844,11 @@ class x {
    * @returns {Promise<{updated: number, edges_strengthened: number, outcome: string}>}
    */
   async feedback(e, t, s = null) {
-    const r = { item_ids: e, outcome: t };
-    return s != null && (r.query = s), this.api.post("/memory/feedback", r);
+    const n = { item_ids: e, outcome: t };
+    return s != null && (n.query = s), this.api.post("/memory/feedback", n);
   }
   async ground(e, t, s = null) {
-    return this.api.post(`/memory/${e}/ground`, {
+    return this.api.post(`/memory/${encodeURIComponent(e)}/ground`, {
       item_id: e,
       source_url: t,
       validation: s
@@ -816,29 +858,29 @@ class x {
     return this.api.delete(`/memory/clear-all?nuclear=${e}`);
   }
   // --- Temporal ---
-  async getHistory(e, { startTime: t = null, endTime: s = null, limit: r = 100 } = {}) {
-    let n = `/memory/temporal/${e}/history?limit=${r}`;
-    return t && (n += `&start_time=${t}`), s && (n += `&end_time=${s}`), this.api.get(n);
+  async getHistory(e, { startTime: t = null, endTime: s = null, limit: n = 100 } = {}) {
+    let r = `/memory/temporal/${e}/history?limit=${n}`;
+    return t && (r += `&start_time=${t}`), s && (r += `&end_time=${s}`), this.api.get(r);
   }
   async timeTravel(e, { query: t = null, limit: s = 100 } = {}) {
-    let r = `/memory/temporal/at/${e}?limit=${s}`;
-    return t && (r += `&query=${encodeURIComponent(t)}`), this.api.get(r);
+    let n = `/memory/temporal/at/${e}?limit=${s}`;
+    return t && (n += `&query=${encodeURIComponent(t)}`), this.api.get(n);
   }
   async getItemAtTime(e, t) {
     return this.api.get(`/memory/temporal/${e}/at/${t}`);
   }
-  async getChanges(e, { since: t = null, until: s = null, changeType: r = null } = {}) {
-    let n = `/memory/temporal/${e}/changes`;
+  async getChanges(e, { since: t = null, until: s = null, changeType: n = null } = {}) {
+    let r = `/memory/temporal/${e}/changes`;
     const i = [];
-    return t && i.push(`since=${t}`), s && i.push(`until=${s}`), r && i.push(`change_type=${r}`), i.length && (n += `?${i.join("&")}`), this.api.get(n);
+    return t && i.push(`since=${t}`), s && i.push(`until=${s}`), n && i.push(`change_type=${n}`), i.length && (r += `?${i.join("&")}`), this.api.get(r);
   }
   async compareVersions(e, t, s) {
     return this.api.post(`/memory/temporal/${e}/compare?v1=${t}&v2=${s}`);
   }
   async rollback(e, { toVersion: t = null, toTime: s = null } = {}) {
-    let r = `/memory/temporal/${e}/rollback`;
-    const n = [];
-    return t !== null && n.push(`to_version=${t}`), s && n.push(`to_time=${s}`), n.length && (r += `?${n.join("&")}`), this.api.post(r);
+    let n = `/memory/temporal/${e}/rollback`;
+    const r = [];
+    return t !== null && r.push(`to_version=${t}`), s && r.push(`to_time=${s}`), r.length && (n += `?${r.join("&")}`), this.api.post(n);
   }
   // --- Clustering ---
   async runClustering(e = 0.1, t = !1) {
@@ -848,7 +890,7 @@ class x {
     return this.api.get("/memory/clustering/stats");
   }
 }
-class O {
+class H {
   constructor(e) {
     this.api = e;
   }
@@ -871,29 +913,29 @@ class O {
     content: e,
     decisionType: t = "inference",
     confidence: s = 0.8,
-    sourceTraceId: r = null,
-    sourceSessionId: n = null,
+    sourceTraceId: n = null,
+    sourceSessionId: r = null,
     evidenceIds: i = null,
-    domain: o = null,
-    tags: c = null,
-    rejectedAlternatives: m = null,
-    rationale: p = null,
-    constraints: $ = null,
-    agentId: k = null
+    domain: c = null,
+    tags: o = null,
+    rejectedAlternatives: h = null,
+    rationale: y = null,
+    constraints: p = null,
+    agentId: d = null
   }) {
     return this.api.post("/memory/decisions/create", {
       content: e,
       decision_type: t,
       confidence: s,
-      source_trace_id: r,
-      source_session_id: n,
+      source_trace_id: n,
+      source_session_id: r,
       evidence_ids: i,
-      domain: o,
-      tags: c,
-      rejected_alternatives: m,
-      rationale: p,
-      constraints: $,
-      agent_id: k
+      domain: c,
+      tags: o,
+      rejected_alternatives: h,
+      rationale: y,
+      constraints: p,
+      agent_id: d
     });
   }
   /**
@@ -939,13 +981,13 @@ class O {
    * @param {string[]} [params.tags]
    * @param {string} [params.agentId]
    */
-  async createPending({ content: e, requirements: t, domain: s = null, tags: r = null, agentId: n = null }) {
+  async createPending({ content: e, requirements: t, domain: s = null, tags: n = null, agentId: r = null }) {
     return this.api.post("/memory/decisions/pending/create", {
       content: e,
       requirements: t,
       domain: s,
-      tags: r,
-      agent_id: n
+      tags: n,
+      agent_id: r
     });
   }
   /**
@@ -1066,7 +1108,7 @@ class O {
     });
   }
 }
-class F {
+class B {
   constructor(e) {
     this.api = e;
   }
@@ -1088,19 +1130,19 @@ class F {
     return t.confidence !== void 0 && (s.confidence = t.confidence), t.subject !== void 0 && (s.subject = t.subject), t.subjectType !== void 0 && (s.subject_type = t.subjectType), t.disposition !== void 0 && (s.disposition = t.disposition), t.formedFrom !== void 0 && (s.formed_from = t.formedFrom), t.domain !== void 0 && (s.domain = t.domain), t.agentId !== void 0 && (s.agent_id = t.agentId), this.api.post("/memory/opinions/create", s);
   }
 }
-class j {
+class K {
   constructor(e) {
     this.api = e;
   }
   async getNeighbors(e) {
     return this.api.get(`/memory/${e}/neighbors`);
   }
-  async addEdge(e, t, s, r = {}) {
+  async addEdge(e, t, s, n = {}) {
     return this.api.post("/memory/edge", {
       source_id: e,
       target_id: t,
       relation_type: s,
-      properties: r
+      properties: n
     });
   }
   async getHealth() {
@@ -1146,8 +1188,8 @@ class j {
    * @param {string|null} [params.deletePrefix=null] - Scoped node-ID prefix to delete before writing.
    */
   async bulkUpsert({ nodes: e = [], edges: t = [], deletePrefix: s = null } = {}) {
-    const r = { nodes: e, edges: t };
-    return s !== null && (r.delete_prefix = s), this.api.post("/memory/graph/bulk", r);
+    const n = { nodes: e, edges: t };
+    return s !== null && (n.delete_prefix = s), this.api.post("/memory/graph/bulk", n);
   }
   /**
    * Get Wikipedia grounding status for an entity node.
@@ -1223,7 +1265,7 @@ class j {
     );
   }
 }
-class H {
+class G {
   constructor(e) {
     this.api = e;
   }
@@ -1231,14 +1273,14 @@ class H {
     const t = e ? "?include_system=true" : "";
     return this.api.get(`/memory/teams${t}`);
   }
-  async create({ name: e, description: t = null, dataClassification: s = "internal", costCenter: r = null, isSystem: n = !1 }) {
+  async create({ name: e, description: t = null, dataClassification: s = "internal", costCenter: n = null, isSystem: r = !1 }) {
     const i = {
       name: e,
       description: t,
       data_classification: s,
-      cost_center: r
+      cost_center: n
     };
-    return n && (i.is_system = !0), this.api.post("/memory/teams", i);
+    return r && (i.is_system = !0), this.api.post("/memory/teams", i);
   }
   async get(e) {
     return this.api.get(`/memory/teams/${e}`);
@@ -1265,7 +1307,7 @@ class H {
     return this.api.delete(`/memory/teams/${e}/members/${t}`);
   }
 }
-class B {
+class D {
   constructor(e) {
     this.api = e;
   }
@@ -1287,7 +1329,7 @@ class B {
     return this.api.patch("/auth/llm-keys", e);
   }
 }
-class K {
+class N {
   constructor(e) {
     this.api = e;
   }
@@ -1313,7 +1355,7 @@ class K {
     });
   }
 }
-class G {
+class J {
   constructor(e) {
     this.api = e;
   }
@@ -1334,19 +1376,19 @@ class G {
     return this.api.delete(`/memory/api-keys/${e}`);
   }
 }
-class N {
+class W {
   constructor(e) {
     this.api = e;
   }
   async list() {
     return this.api.get("/memory/agents");
   }
-  async create({ name: e, description: t = null, agentConfig: s = {}, roles: r = ["user"] }) {
+  async create({ name: e, description: t = null, agentConfig: s = {}, roles: n = ["user"] }) {
     return this.api.post("/memory/agents", {
       name: e,
       description: t,
       agent_config: s,
-      roles: r
+      roles: n
     });
   }
   async get(e) {
@@ -1373,8 +1415,8 @@ class N {
    * @returns {Promise<{evaluation: object|null}>}
    */
   async getEvaluation(e, t, s) {
-    const r = new URLSearchParams({ dimension: t, domain: s }).toString();
-    return this.api.get(`/memory/agents/${e}/evaluation${r ? "?" + r : ""}`);
+    const n = new URLSearchParams({ dimension: t, domain: s }).toString();
+    return this.api.get(`/memory/agents/${e}/evaluation${n ? "?" + n : ""}`);
   }
   /**
    * Get evaluation history for an agent on a given (dimension, domain) slot.
@@ -1388,12 +1430,12 @@ class N {
    * @param {number} [options.limit=20] - Maximum records to return.
    * @returns {Promise<{history: object[]}>}
    */
-  async listEvaluationHistory(e, t, s, { limit: r = 20 } = {}) {
-    const n = new URLSearchParams({ dimension: t, domain: s, limit: String(r) }).toString();
-    return this.api.get(`/memory/agents/${e}/evaluation/history${n ? "?" + n : ""}`);
+  async listEvaluationHistory(e, t, s, { limit: n = 20 } = {}) {
+    const r = new URLSearchParams({ dimension: t, domain: s, limit: String(n) }).toString();
+    return this.api.get(`/memory/agents/${e}/evaluation/history${r ? "?" + r : ""}`);
   }
 }
-class D {
+class V {
   constructor(e) {
     this.api = e;
   }
@@ -1407,7 +1449,7 @@ class D {
     return this.api.get("/usage/tiers");
   }
 }
-class J {
+class Y {
   constructor(e) {
     this.api = e;
   }
@@ -1424,7 +1466,7 @@ class J {
     return this.api.get("/memory/plugins");
   }
 }
-class W {
+class X {
   constructor(e) {
     this.api = e;
   }
@@ -1447,7 +1489,7 @@ class W {
     return this.api.get("/memory/token-usage/current");
   }
 }
-class V {
+class Z {
   constructor(e) {
     this.api = e;
   }
@@ -1460,9 +1502,9 @@ class V {
    * @param {string} [options.endTime] - ISO end time
    * @param {number} [options.limit=100]
    */
-  async getHistory(e, { startTime: t = null, endTime: s = null, limit: r = 100 } = {}) {
-    let n = `/memory/temporal/${e}/history?limit=${r}`;
-    return t && (n += `&start_time=${t}`), s && (n += `&end_time=${s}`), this.api.get(n);
+  async getHistory(e, { startTime: t = null, endTime: s = null, limit: n = 100 } = {}) {
+    let r = `/memory/temporal/${e}/history?limit=${n}`;
+    return t && (r += `&start_time=${t}`), s && (r += `&end_time=${s}`), this.api.get(r);
   }
   // === TIME-TRAVEL QUERIES ===
   /**
@@ -1473,8 +1515,8 @@ class V {
    * @param {number} [options.limit=100]
    */
   async timeTravel(e, { query: t = null, limit: s = 100 } = {}) {
-    let r = `/memory/temporal/at/${e}?limit=${s}`;
-    return t && (r += `&query=${encodeURIComponent(t)}`), this.api.get(r);
+    let n = `/memory/temporal/at/${e}?limit=${s}`;
+    return t && (n += `&query=${encodeURIComponent(t)}`), this.api.get(n);
   }
   /**
    * Get specific item as it existed at timestamp.
@@ -1493,10 +1535,10 @@ class V {
    * @param {string} [options.until]
    * @param {string} [options.changeType]
    */
-  async getChanges(e, { since: t = null, until: s = null, changeType: r = null } = {}) {
-    let n = `/memory/temporal/${e}/changes`;
+  async getChanges(e, { since: t = null, until: s = null, changeType: n = null } = {}) {
+    let r = `/memory/temporal/${e}/changes`;
     const i = [];
-    return t && i.push(`since=${t}`), s && i.push(`until=${s}`), r && i.push(`change_type=${r}`), i.length && (n += `?${i.join("&")}`), this.api.get(n);
+    return t && i.push(`since=${t}`), s && i.push(`until=${s}`), n && i.push(`change_type=${n}`), i.length && (r += `?${i.join("&")}`), this.api.get(r);
   }
   // === VERSION COMPARISON ===
   /**
@@ -1517,9 +1559,9 @@ class V {
    * @param {string} [options.toTime]
    */
   async rollback(e, { toVersion: t = null, toTime: s = null } = {}) {
-    let r = `/memory/temporal/${e}/rollback`;
-    const n = [];
-    return t !== null && n.push(`to_version=${t}`), s && n.push(`to_time=${s}`), n.length && (r += `?${n.join("&")}`), this.api.post(r);
+    let n = `/memory/temporal/${e}/rollback`;
+    const r = [];
+    return t !== null && r.push(`to_version=${t}`), s && r.push(`to_time=${s}`), r.length && (n += `?${r.join("&")}`), this.api.post(n);
   }
   // === AUDIT TRAIL ===
   /**
@@ -1531,10 +1573,10 @@ class V {
    * @param {string} [options.startTime]
    * @param {string} [options.endTime]
    */
-  async getAuditTrail(e, { changeType: t = null, userId: s = null, startTime: r = null, endTime: n = null } = {}) {
+  async getAuditTrail(e, { changeType: t = null, userId: s = null, startTime: n = null, endTime: r = null } = {}) {
     let i = `/memory/temporal/${e}/audit`;
-    const o = [];
-    return t && o.push(`change_type=${t}`), s && o.push(`user_id=${s}`), r && o.push(`start_time=${r}`), n && o.push(`end_time=${n}`), o.length && (i += `?${o.join("&")}`), this.api.get(i);
+    const c = [];
+    return t && c.push(`change_type=${t}`), s && c.push(`user_id=${s}`), n && c.push(`start_time=${n}`), r && c.push(`end_time=${r}`), c.length && (i += `?${c.join("&")}`), this.api.get(i);
   }
   // === TEMPORAL SEARCH ===
   /**
@@ -1544,14 +1586,14 @@ class V {
    * @param {string} endTime
    * @param {number} [limit=100]
    */
-  async searchDuringRange(e, t, s, r = 100) {
-    const n = new URLSearchParams({
+  async searchDuringRange(e, t, s, n = 100) {
+    const r = new URLSearchParams({
       query: e,
       start_time: t,
       end_time: s,
-      limit: String(r)
+      limit: String(n)
     }).toString();
-    return this.api.get(`/memory/temporal/search/during?${n}`);
+    return this.api.get(`/memory/temporal/search/during?${r}`);
   }
   // === COMPLIANCE REPORTING ===
   /**
@@ -1562,12 +1604,12 @@ class V {
    * @param {string} [options.reportType='HIPAA']
    * @param {string[]} [options.itemIds]
    */
-  async complianceReport(e, t, { reportType: s = "HIPAA", itemIds: r = null } = {}) {
-    let n = `/memory/temporal/compliance/report?start_date=${e}&end_date=${t}&report_type=${s}`;
-    if (r && r.length)
-      for (const i of r)
-        n += `&item_ids=${encodeURIComponent(i)}`;
-    return this.api.get(n);
+  async complianceReport(e, t, { reportType: s = "HIPAA", itemIds: n = null } = {}) {
+    let r = `/memory/temporal/compliance/report?start_date=${e}&end_date=${t}&report_type=${s}`;
+    if (n && n.length)
+      for (const i of n)
+        r += `&item_ids=${encodeURIComponent(i)}`;
+    return this.api.get(r);
   }
   // === TEMPORAL RELATIONSHIPS ===
   /**
@@ -1593,7 +1635,7 @@ class V {
     return this.api.get(`/memory/temporal/relationships/${e}/valid-periods`);
   }
 }
-class Y {
+class Q {
   constructor(e) {
     this.api = e;
   }
@@ -1620,8 +1662,8 @@ class Y {
   async listViolations({ severity: e = null, autoFixableOnly: t = !1 } = {}) {
     const s = [];
     e && s.push(`severity=${e}`), t && s.push("auto_fixable_only=true");
-    const r = s.length ? `?${s.join("&")}` : "";
-    return this.api.get(`/memory/governance/violations${r}`);
+    const n = s.length ? `?${s.join("&")}` : "";
+    return this.api.get(`/memory/governance/violations${n}`);
   }
   /**
    * Get a specific violation by ID.
@@ -1638,12 +1680,12 @@ class Y {
    * @param {string} [params.rationale='']
    * @param {string} [params.decidedBy='human']
    */
-  async applyDecision({ violationId: e, action: t = "approve", rationale: s = "", decidedBy: r = "human" }) {
+  async applyDecision({ violationId: e, action: t = "approve", rationale: s = "", decidedBy: n = "human" }) {
     return this.api.post("/memory/governance/apply-decision", {
       violation_id: e,
       action: t,
       rationale: s,
-      decided_by: r
+      decided_by: n
     });
   }
   /**
@@ -1662,7 +1704,7 @@ class Y {
     return this.api.get("/memory/governance/summary");
   }
 }
-class Z {
+class ee {
   constructor(e) {
     this.api = e;
   }
@@ -1703,7 +1745,7 @@ class Z {
     return this.api.post("/memory/evolution/reinforce/opinions");
   }
 }
-class Q {
+class te {
   constructor(e) {
     this.api = e;
   }
@@ -1732,13 +1774,13 @@ class Q {
    * @param {boolean} [params.useWikipedia=true]
    * @param {boolean} [params.useLlm=true]
    */
-  async resolve({ existingItemId: e, newFact: t, autoResolve: s = !0, strategy: r = null, useWikipedia: n = !0, useLlm: i = !0 }) {
+  async resolve({ existingItemId: e, newFact: t, autoResolve: s = !0, strategy: n = null, useWikipedia: r = !0, useLlm: i = !0 }) {
     return this.api.post("/memory/reasoning/resolve", {
       existing_item_id: e,
       new_fact: t,
       auto_resolve: s,
-      strategy: r,
-      use_wikipedia: n,
+      strategy: n,
+      use_wikipedia: r,
       use_llm: i
     });
   }
@@ -1801,7 +1843,7 @@ class Q {
     });
   }
 }
-class X {
+class se {
   constructor(e) {
     this.api = e;
   }
@@ -1813,12 +1855,12 @@ class X {
    * @param {number} [params.minQualityScore=0.4]
    * @param {boolean} [params.useLlmDetection=true]
    */
-  async extract({ content: e, minSteps: t = 2, minQualityScore: s = 0.4, useLlmDetection: r = !0 }) {
+  async extract({ content: e, minSteps: t = 2, minQualityScore: s = 0.4, useLlmDetection: n = !0 }) {
     return this.api.post("/memory/reasoning/traces/extract", {
       content: e,
       min_steps: t,
       min_quality_score: s,
-      use_llm_detection: r
+      use_llm_detection: n
     });
   }
   /**
@@ -1855,7 +1897,7 @@ class X {
     return this.api.get(`/memory/reasoning/traces/${e}`);
   }
 }
-class ee {
+class ne {
   constructor(e) {
     this.api = e;
   }
@@ -1870,7 +1912,7 @@ class ee {
   async runInference({ registryId: e = "default", rawChunks: t, params: s = {} }) {
     return this.api.post("/memory/ontology/inference/run", {
       registry_id: e,
-      raw_chunks: t.map((r) => ({ doc_id: r.docId, text: r.text })),
+      raw_chunks: t.map((n) => ({ doc_id: n.docId, text: n.text })),
       params: s
     });
   }
@@ -1912,11 +1954,11 @@ class ee {
    * @param {Object} params.changeset - OntologyIR changeset
    * @param {string} [params.message='']
    */
-  async applyChangeset(e, { baseVersion: t = "", changeset: s, message: r = "" }) {
+  async applyChangeset(e, { baseVersion: t = "", changeset: s, message: n = "" }) {
     return this.api.post(`/memory/ontology/registry/${e}/apply`, {
       base_version: t,
       changeset: s,
-      message: r
+      message: n
     });
   }
   /**
@@ -2065,12 +2107,12 @@ class ee {
    * @param {number} [params.confidence=0.9]
    * @param {boolean} [params.isGlobal=false]
    */
-  async createPattern({ name: e, entityType: t, confidence: s = 0.9, isGlobal: r = !1 }) {
+  async createPattern({ name: e, entityType: t, confidence: s = 0.9, isGlobal: n = !1 }) {
     return this.api.post("/memory/ontology/patterns", {
       name: e,
       entity_type: t,
       confidence: s,
-      is_global: r
+      is_global: n
     });
   }
   /**
@@ -2231,8 +2273,8 @@ class ee {
    * @param {number} [options.limit=50]
    */
   async listHitl({ status: e = "open", kind: t = null, limit: s = 50 } = {}) {
-    const r = new URLSearchParams({ status: e, limit: String(s) });
-    return t && r.set("kind", t), this.api.get(`/memory/ontology/hitl?${r.toString()}`);
+    const n = new URLSearchParams({ status: e, limit: String(s) });
+    return t && n.set("kind", t), this.api.get(`/memory/ontology/hitl?${n.toString()}`);
   }
   /**
    * Resolve one ontology HITL queue item (open -> resolved).
@@ -2252,14 +2294,113 @@ class ee {
    * @param {string} [options.layer] public|domain|private
    * @param {string} [options.packId] filter by originating pack id
    * @param {boolean} [options.hasIri] only types with (or without) an IRI
+   * @param {string} [options.kind] entity | record (CORE-MEMTYPE-DECLARE-1)
    * @param {number} [options.limit=100]
    * @param {string} [options.cursor] opaque keyset continuation token
    */
-  async listTypes({ tier: e, layer: t, packId: s, hasIri: r, limit: n = 100, cursor: i } = {}) {
-    const o = { limit: String(n) };
-    e !== void 0 && (o.tier = e), t !== void 0 && (o.layer = t), s !== void 0 && (o.pack_id = s), r !== void 0 && (o.has_iri = String(r)), i !== void 0 && (o.cursor = i);
-    const c = new URLSearchParams(o).toString();
-    return this.api.get(`/memory/ontology/types${c ? "?" + c : ""}`);
+  async listTypes({ tier: e, layer: t, packId: s, hasIri: n, kind: r, limit: i = 100, cursor: c } = {}) {
+    const o = { limit: String(i) };
+    e !== void 0 && (o.tier = e), t !== void 0 && (o.layer = t), s !== void 0 && (o.pack_id = s), n !== void 0 && (o.has_iri = String(n)), r !== void 0 && (o.kind = r), c !== void 0 && (o.cursor = c);
+    const h = new URLSearchParams(o).toString();
+    return this.api.get(`/memory/ontology/types${h ? "?" + h : ""}`);
+  }
+  /**
+   * Declare an ontology class (CORE-MEMTYPE-DECLARE-1).
+   *
+   * `kind: 'record'` declares a concrete record type: items may then be
+   * written with `memory_type=name` through the add and structured-ingest
+   * surfaces, schema-checked against `propertiesSchema` (STRICT by default —
+   * violations refuse with a structured 400; the server-side literal-"false"
+   * env kill-switch downgrades to WARNING).
+   * Field names/enums are pinned by `memory-type-contract.json`.
+   *
+   * @param {string} name class name — for kind='record' this IS the memory_type
+   * @param {Object} [options]
+   * @param {('entity'|'record')} [options.kind='entity']
+   * @param {Object} [options.propertiesSchema] field name -> {type, of?, default?, indexed?, append_only?}
+   * @param {string[]} [options.requiredProperties]
+   * @param {('full'|'indexed'|'append')} [options.storageStrategy] record classes only
+   * @param {boolean} [options.storageSearchable] record classes only
+   * @param {string} [options.iri]
+   * @param {string} [options.wikidataQid]
+   * @param {string} [options.displayName]
+   * @param {string} [options.definition]
+   * @param {string} [options.description]
+   * @param {string[]} [options.aliases]
+   * @param {string[]} [options.examples]
+   * @param {string[]} [options.parentTypes]
+   * @param {string} [options.tier='confirmed'] 'working' routes through review
+   * @returns {Promise<Object>} the created type projection (incl. kind + storage facet)
+   * @throws 400 invalid schema/tier/kind/strategy; 409 built-in shadowing or identity conflict
+   */
+  async declareType(e, {
+    kind: t = "entity",
+    propertiesSchema: s,
+    requiredProperties: n,
+    storageStrategy: r,
+    storageSearchable: i,
+    iri: c,
+    wikidataQid: o,
+    displayName: h,
+    definition: y,
+    description: p,
+    aliases: d,
+    examples: _,
+    parentTypes: $,
+    tier: g = "confirmed"
+  } = {}) {
+    const u = { name: e, kind: t, tier: g };
+    return s !== void 0 && (u.properties_schema = s), n !== void 0 && (u.required_properties = n), r !== void 0 && (u.storage_strategy = r), i !== void 0 && (u.storage_searchable = i), c !== void 0 && (u.iri = c), o !== void 0 && (u.wikidata_qid = o), h !== void 0 && (u.display_name = h), y !== void 0 && (u.definition = y), p !== void 0 && (u.description = p), d !== void 0 && (u.aliases = d), _ !== void 0 && (u.examples = _), $ !== void 0 && (u.parent_types = $), this.api.post("/memory/ontology/types", u);
+  }
+  /**
+   * Declare an ontology relation (CORE-MEMTYPE-DECLARE-1; declare-only in P1).
+   * Record links use record-class domain/range; edge validation is P3.
+   *
+   * @param {string} name
+   * @param {Object} [options]
+   * @param {string[]} [options.domain]
+   * @param {string[]} [options.range]
+   * @param {string} [options.inverseOf]
+   * @param {('1:1'|'1:N'|'N:N')} [options.cardinality]
+   * @param {boolean} [options.temporal]
+   * @param {Object} [options.propertiesSchema]
+   * @param {boolean} [options.transitive]
+   * @param {boolean} [options.symmetric]
+   * @param {boolean} [options.reflexive]
+   * @param {string[]} [options.parentRelations]
+   * @param {string} [options.iri]
+   * @param {string} [options.wikidataPid]
+   * @param {string} [options.displayName]
+   * @param {string} [options.definition]
+   * @param {string} [options.description]
+   * @param {string[]} [options.aliases]
+   * @param {string[]} [options.examples]
+   * @param {string} [options.tier='confirmed']
+   * @returns {Promise<Object>} the created relation projection
+   * @throws 400 invalid tier; 409 identity-slot conflict
+   */
+  async declareRelation(e, {
+    domain: t,
+    range: s,
+    inverseOf: n,
+    cardinality: r,
+    temporal: i,
+    propertiesSchema: c,
+    transitive: o,
+    symmetric: h,
+    reflexive: y,
+    parentRelations: p,
+    iri: d,
+    wikidataPid: _,
+    displayName: $,
+    definition: g,
+    description: u,
+    aliases: b,
+    examples: I,
+    tier: l = "confirmed"
+  } = {}) {
+    const m = { name: e, tier: l };
+    return t !== void 0 && (m.domain = t), s !== void 0 && (m.range = s), n !== void 0 && (m.inverse_of = n), r !== void 0 && (m.cardinality = r), i !== void 0 && (m.temporal = i), c !== void 0 && (m.properties_schema = c), o !== void 0 && (m.transitive = o), h !== void 0 && (m.symmetric = h), y !== void 0 && (m.reflexive = y), p !== void 0 && (m.parent_relations = p), d !== void 0 && (m.iri = d), _ !== void 0 && (m.wikidata_pid = _), $ !== void 0 && (m.display_name = $), g !== void 0 && (m.definition = g), u !== void 0 && (m.description = u), b !== void 0 && (m.aliases = b), I !== void 0 && (m.examples = I), this.api.post("/memory/ontology/relations", m);
   }
   /**
    * List ontology relation types, keyset-paginated. Mirror of `listTypes`.
@@ -2271,11 +2412,11 @@ class ee {
    * @param {number} [options.limit=100]
    * @param {string} [options.cursor] opaque keyset continuation token
    */
-  async listRelations({ tier: e, layer: t, packId: s, hasIri: r, limit: n = 100, cursor: i } = {}) {
-    const o = { limit: String(n) };
-    e !== void 0 && (o.tier = e), t !== void 0 && (o.layer = t), s !== void 0 && (o.pack_id = s), r !== void 0 && (o.has_iri = String(r)), i !== void 0 && (o.cursor = i);
-    const c = new URLSearchParams(o).toString();
-    return this.api.get(`/memory/ontology/relations${c ? "?" + c : ""}`);
+  async listRelations({ tier: e, layer: t, packId: s, hasIri: n, limit: r = 100, cursor: i } = {}) {
+    const c = { limit: String(r) };
+    e !== void 0 && (c.tier = e), t !== void 0 && (c.layer = t), s !== void 0 && (c.pack_id = s), n !== void 0 && (c.has_iri = String(n)), i !== void 0 && (c.cursor = i);
+    const o = new URLSearchParams(c).toString();
+    return this.api.get(`/memory/ontology/relations${o ? "?" + o : ""}`);
   }
   /**
    * Resolve a single ontology type by iri/qid/name.
@@ -2300,11 +2441,11 @@ class ee {
    * @param {string} [options.until] full ISO-8601 upper bound (inclusive)
    * @param {number} [options.limit=200]
    */
-  async listAudit({ actor: e, action: t, since: s, until: r, limit: n = 200 } = {}) {
-    const i = { limit: String(n) };
-    e !== void 0 && (i.actor = e), t !== void 0 && (i.action = t), s !== void 0 && (i.since = s), r !== void 0 && (i.until = r);
-    const o = new URLSearchParams(i).toString();
-    return this.api.get(`/memory/ontology/audit${o ? "?" + o : ""}`);
+  async listAudit({ actor: e, action: t, since: s, until: n, limit: r = 200 } = {}) {
+    const i = { limit: String(r) };
+    e !== void 0 && (i.actor = e), t !== void 0 && (i.action = t), s !== void 0 && (i.since = s), n !== void 0 && (i.until = n);
+    const c = new URLSearchParams(i).toString();
+    return this.api.get(`/memory/ontology/audit${c ? "?" + c : ""}`);
   }
   /**
    * Full append-only audit trail for one ontology type (oldest-first).
@@ -2329,8 +2470,8 @@ class ee {
   async getPackAudit(e, { packVersion: t = null } = {}) {
     const s = {};
     t !== null && (s.pack_version = t);
-    const r = new URLSearchParams(s).toString();
-    return this.api.get(`/memory/ontology/packs/${encodeURIComponent(e)}/audit${r ? "?" + r : ""}`);
+    const n = new URLSearchParams(s).toString();
+    return this.api.get(`/memory/ontology/packs/${encodeURIComponent(e)}/audit${n ? "?" + n : ""}`);
   }
   /**
    * Reclassify every instance of `fromId` onto `toId`. Both types stay live.
@@ -2339,13 +2480,34 @@ class ee {
    * @param {Object} params
    * @param {string} params.reason why the migration is being performed (audit evidence)
    * @param {number} [params.batchSize=500] instance edges rewritten per chunk
-   */
-  async migrateTypeInstances(e, t, { reason: s, batchSize: r = 500 }) {
-    return this.api.post(
+   * @param {('refuse'|'skip')} [params.onViolation='refuse'] record migrations:
+   * strict preflight or migrate valid items and report skipped ids. Ignored for entities.
+   * @returns {Promise<Object>} Always includes moved_item_ids, skipped_items,
+   * vector_metadata_updated, vector_metadata_missing, vector_metadata_failed and
+   * searchable_mismatch_count alongside the original fields. They are additive with
+   * defaults, so an entity migration returns them empty/zero rather than omitting
+   * them — callers never branch on kind to read a response.
+   */
+  async migrateTypeInstances(e, t, { reason: s, batchSize: n = 500, onViolation: r = "refuse" }) {
+    const i = { reason: s, batch_size: n };
+    return r !== "refuse" && (i.on_violation = r), this.api.post(
       `/memory/ontology/types/${encodeURIComponent(e)}/migrate-to/${encodeURIComponent(t)}`,
-      { reason: s, batch_size: r }
+      i
     );
   }
+  /**
+   * Retire this workspace's own confirmed record class.
+   * Deliberately narrow: the server refuses (400) unless the type resolves to the
+   * workspace's PRIVATE layer AND is kind 'record'. Public and pack classes are
+   * shared vocabulary — retiring `decision` would disable a built-in memory type
+   * for the whole workspace. Entity classes use the curation queue instead.
+   * @param {string} typeId ontology type identifier
+   * @param {string} reason audit evidence for the retirement
+   * @returns {Promise<{ok: boolean}>}
+   */
+  async retireType(e, t) {
+    return this.api.post(`/memory/ontology/types/${encodeURIComponent(e)}/retire`, { reason: t });
+  }
   // --- ONTO-HITL-CURATE-1 curation queue surface ---------------------------
   /**
    * List ontology review queue items, keyset-paginated.
@@ -2356,11 +2518,11 @@ class ee {
    * @param {number} [options.limit=100]
    * @param {string} [options.cursor] opaque keyset continuation token
    */
-  async listReviewQueue({ tier: e, assignee: t, source: s, limit: r = 100, cursor: n } = {}) {
-    const i = { limit: String(r) };
-    e !== void 0 && (i.tier = e), t !== void 0 && (i.assignee = t), s !== void 0 && (i.source = s), n !== void 0 && (i.cursor = n);
-    const o = new URLSearchParams(i).toString();
-    return this.api.get(`/memory/ontology/queue${o ? "?" + o : ""}`);
+  async listReviewQueue({ tier: e, assignee: t, source: s, limit: n = 100, cursor: r } = {}) {
+    const i = { limit: String(n) };
+    e !== void 0 && (i.tier = e), t !== void 0 && (i.assignee = t), s !== void 0 && (i.source = s), r !== void 0 && (i.cursor = r);
+    const c = new URLSearchParams(i).toString();
+    return this.api.get(`/memory/ontology/queue${c ? "?" + c : ""}`);
   }
   /**
    * Approve one ontology review type.
@@ -2390,8 +2552,8 @@ class ee {
    * @param {string} [options.expectedTier] optional optimistic tier precondition
    */
   async mergeReviewType(e, t, { expectedTier: s } = {}) {
-    const r = { into_id: t };
-    return s !== void 0 && (r.expected_tier = s), this.api.post(`/memory/ontology/queue/${encodeURIComponent(e)}/merge`, r);
+    const n = { into_id: t };
+    return s !== void 0 && (n.expected_tier = s), this.api.post(`/memory/ontology/queue/${encodeURIComponent(e)}/merge`, n);
   }
   /**
    * Edit and promote one ontology review type.
@@ -2401,8 +2563,8 @@ class ee {
    * @param {string} [options.expectedTier] optional optimistic tier precondition
    */
   async editPromoteReviewType(e, t, { expectedTier: s } = {}) {
-    const r = { edits: t };
-    return s !== void 0 && (r.expected_tier = s), this.api.post(`/memory/ontology/queue/${encodeURIComponent(e)}/edit-promote`, r);
+    const n = { edits: t };
+    return s !== void 0 && (n.expected_tier = s), this.api.post(`/memory/ontology/queue/${encodeURIComponent(e)}/edit-promote`, n);
   }
   /**
    * Assign or clear the reviewer for one ontology review type.
@@ -2420,12 +2582,12 @@ class ee {
    * @param {Object} [options.params] action-specific params
    * @param {string} [options.expectedTier] optional optimistic tier precondition
    */
-  async bulkReviewAction(e, t, { params: s, expectedTier: r } = {}) {
-    const n = { action: e, ids: t, params: s === void 0 ? {} : s };
-    return r !== void 0 && (n.expected_tier = r), this.api.post("/memory/ontology/queue/bulk", n);
+  async bulkReviewAction(e, t, { params: s, expectedTier: n } = {}) {
+    const r = { action: e, ids: t, params: s === void 0 ? {} : s };
+    return n !== void 0 && (r.expected_tier = n), this.api.post("/memory/ontology/queue/bulk", r);
   }
 }
-class te {
+class re {
   constructor(e) {
     this.api = e;
   }
@@ -2450,11 +2612,11 @@ class te {
    * @param {boolean} [options.topicAnalysis]
    */
   async detectBias({ protectedAttributes: e = null, sentimentAnalysis: t = null, topicAnalysis: s = null } = {}) {
-    const r = {};
-    return e !== null && (r.protected_attributes = e), t !== null && (r.sentiment_analysis = t), s !== null && (r.topic_analysis = s), this.api.post("/memory/analytics/bias", r);
+    const n = {};
+    return e !== null && (n.protected_attributes = e), t !== null && (n.sentiment_analysis = t), s !== null && (n.topic_analysis = s), this.api.post("/memory/analytics/bias", n);
   }
 }
-class se {
+class ie {
   constructor(e) {
     this.api = e;
   }
@@ -2490,7 +2652,7 @@ class se {
     return this.api.get("/memory/inference/rules");
   }
 }
-class re {
+class ae {
   constructor(e) {
     this.api = e;
   }
@@ -2591,11 +2753,11 @@ class re {
    * @param {string} [params.description='']
    * @param {Object} [params.config={}]
    */
-  async updateConfig(e, { name: t = "", description: s = "", config: r = {} }) {
+  async updateConfig(e, { name: t = "", description: s = "", config: n = {} }) {
     return this.api.patch(`/memory/pipeline/configs/${e}`, {
       name: t,
       description: s,
-      config: r
+      config: n
     });
   }
   /**
@@ -2606,7 +2768,7 @@ class re {
     return this.api.delete(`/memory/pipeline/configs/${e}`);
   }
 }
-class ne {
+class oe {
   constructor(e) {
     this.api = e;
   }
@@ -2632,7 +2794,7 @@ class ne {
     return this.api.get(`/memory/archive/${e}`);
   }
 }
-class ie {
+class ce {
   constructor(e) {
     this.api = e;
   }
@@ -2791,7 +2953,7 @@ class ie {
     return this.api.get(`/memory/zettel/by-relation/${e}/${t}?limit=${s}`);
   }
 }
-class ae {
+class ue {
   constructor(e) {
     this.api = e;
   }
@@ -2806,7 +2968,7 @@ class ae {
    */
   async list(e = {}) {
     const t = Object.fromEntries(
-      Object.entries(e).filter(([, r]) => r != null)
+      Object.entries(e).filter(([, n]) => n != null)
     ), s = new URLSearchParams(t).toString();
     return this.api.get(`/memory/procedures/matches${s ? "?" + s : ""}`);
   }
@@ -2817,8 +2979,8 @@ class ae {
    * @param {string} [note] - Optional explanation
    */
   async submitFeedback(e, t, s = null) {
-    const r = { feedback: t };
-    return s && (r.note = s), this.api.post(`/memory/procedures/matches/${e}/feedback`, r);
+    const n = { feedback: t };
+    return s && (n.note = s), this.api.post(`/memory/procedures/matches/${e}/feedback`, n);
   }
   /**
    * Get aggregated procedure match statistics.
@@ -2827,7 +2989,7 @@ class ae {
     return this.api.get("/memory/procedures/matches/stats");
   }
 }
-class oe {
+class le {
   constructor(e) {
     this.api = e;
   }
@@ -2842,7 +3004,7 @@ class oe {
    */
   async list(e = {}) {
     const t = Object.fromEntries(
-      Object.entries(e).filter(([, r]) => r != null)
+      Object.entries(e).filter(([, n]) => n != null)
     ), s = new URLSearchParams(t).toString();
     return this.api.get(`/memory/procedures/candidates${s ? "?" + s : ""}`);
   }
@@ -2876,7 +3038,7 @@ class oe {
     return this.api.delete(`/memory/procedures/candidates/${e}/dismiss`);
   }
 }
-class ce {
+class me {
   constructor(e) {
     this.api = e;
   }
@@ -2893,7 +3055,7 @@ class ce {
    */
   async list(e = {}) {
     const t = Object.fromEntries(
-      Object.entries(e).filter(([, r]) => r != null)
+      Object.entries(e).filter(([, n]) => n != null)
     ), s = new URLSearchParams(t).toString();
     return this.api.get(`/memory/procedures/drift${s ? "?" + s : ""}`);
   }
@@ -2931,7 +3093,7 @@ class ce {
     return this.api.get(`/memory/procedures/schemas/${e}`);
   }
 }
-class ue {
+class he {
   constructor(e) {
     this.api = e;
   }
@@ -2983,8 +3145,8 @@ class ue {
    * @param {string} [params.before] ISO 8601 datetime
    */
   async list({ isHeartbeat: e = null, limit: t = 20, before: s = null } = {}) {
-    const r = { limit: t };
-    return e !== null && (r.is_heartbeat = e), s !== null && (r.before = s), this.api.get("/memory/summary/list", r);
+    const n = { limit: t };
+    return e !== null && (n.is_heartbeat = e), s !== null && (n.before = s), this.api.get("/memory/summary/list", n);
   }
   /** SnapshotDelta between two snapshots. Returns null on 404. */
   async delta({ from: e, to: t }) {
@@ -3003,11 +3165,119 @@ class ue {
     return this.api.delete(`/memory/summary/${e}`);
   }
 }
-class le {
+class ye {
+  constructor(e) {
+    this.api = e;
+  }
+  /**
+   * Acquire a lease, or return null when a live holder definitively owns it.
+   * @param {string} key
+   * @param {Object} [params]
+   * @param {number} [params.ttlSeconds]
+   * @returns {Promise<{key: string, token: string, expires_at: string, ttl_remaining_ms: number}|null>}
+   */
+  async acquire(e, { ttlSeconds: t } = {}) {
+    var n, r;
+    const s = {};
+    t !== void 0 && (s.ttl_seconds = t);
+    try {
+      return await this.api.post(`/memory/locks/${e}`, s);
+    } catch (i) {
+      if ((i == null ? void 0 : i.status) === 409 && ((r = (n = i.detail) == null ? void 0 : n.detail) == null ? void 0 : r.reason) === "lock_held")
+        return null;
+      throw i;
+    }
+  }
+  /**
+   * Renew a lease, or return null when this token definitively no longer owns it.
+   * @param {string} key
+   * @param {string} token
+   * @param {Object} [params]
+   * @param {number} [params.ttlSeconds]
+   * @returns {Promise<{key: string, token: string, expires_at: string, ttl_remaining_ms: number}|null>}
+   */
+  async renew(e, t, { ttlSeconds: s } = {}) {
+    var r, i;
+    const n = {};
+    s !== void 0 && (n.ttl_seconds = s);
+    try {
+      return await this.api.post(`/memory/locks/${e}/renew`, n, {
+        headers: { "X-Lease-Token": t }
+      });
+    } catch (c) {
+      if ((c == null ? void 0 : c.status) === 409 && ((i = (r = c.detail) == null ? void 0 : r.detail) == null ? void 0 : i.reason) === "not_owner")
+        return null;
+      throw c;
+    }
+  }
+  /**
+   * Release a lease. Returns false when this token definitively no longer owns it.
+   * @param {string} key
+   * @param {string} token
+   * @returns {Promise<boolean>}
+   */
+  async release(e, t) {
+    var s, n;
+    try {
+      return await this.api.delete(`/memory/locks/${e}`, {
+        headers: { "X-Lease-Token": t }
+      }), !0;
+    } catch (r) {
+      if ((r == null ? void 0 : r.status) === 409 && ((n = (s = r.detail) == null ? void 0 : s.detail) == null ? void 0 : n.reason) === "not_owner")
+        return !1;
+      throw r;
+    }
+  }
+}
+class pe {
+  constructor(e) {
+    this.api = e;
+  }
+  /**
+   * Consume the next numbers. The caller owns the inclusive range [first, value].
+   *
+   * Every non-2xx throws. Unlike the lease there is no benign failure to
+   * swallow — returning null on a 503 would let a caller mistake coordinator
+   * failure for an allocation, which is the one thing this primitive prevents.
+   *
+   * Numbers you do not use are LOST. There is no release and no reclaim; gaps
+   * are guaranteed, so never treat `value` as a record count.
+   *
+   * @param {string} name
+   * @param {Object} [params]
+   * @param {number} [params.floor] High-water mark. Applied with `$max`, so it
+   *   can only ever raise the counter — safe and idempotent to send every call.
+   * @param {number} [params.count] How many to allocate (1..100, default 1).
+   * @returns {Promise<{name: string, value: number, first: number, count: number}>}
+   */
+  async allocate(e, { floor: t, count: s } = {}) {
+    const n = {};
+    return t !== void 0 && (n.floor = t), s !== void 0 && (n.count = s), this.api.post(`/memory/sequences/${e}/next`, n);
+  }
+  /**
+   * Read the counter without consuming a number, or null if never allocated.
+   *
+   * Only a 404 becomes null. A 503 throws — a down coordinator is not the same
+   * answer as "this sequence does not exist".
+   *
+   * @param {string} name
+   * @returns {Promise<number|null>}
+   */
+  async peek(e) {
+    try {
+      const t = await this.api.get(`/memory/sequences/${e}`);
+      return (t == null ? void 0 : t.value) ?? null;
+    } catch (t) {
+      if ((t == null ? void 0 : t.status) === 404) return null;
+      throw t;
+    }
+  }
+}
+class ge {
   constructor(e) {
-    this.auth = new z(e);
-    const t = new E(this.auth, { fetchFn: e.fetchFn });
-    this._api = t, this.memories = new x(t), this.decisions = new O(t), this.opinions = new F(t), this.graph = new j(t), this.teams = new H(t), this.profiles = new B(t), this.subscriptions = new K(t), this.authAPI = new G(t), this.agents = new N(t), this.usage = new D(t), this.insights = new J(t), this.tokenUsage = new W(t), this.temporal = new V(t), this.governance = new Y(t), this.evolution = new Z(t), this.reasoning = new Q(t), this.reasoningTraces = new X(t), this.ontology = new ee(t), this.analytics = new te(t), this.validation = new se(t), this.pipeline = new re(t), this.archive = new ne(t), this.zettelkasten = new ie(t), this.procedureMatches = new ae(t), this.procedureCandidates = new oe(t), this.procedureDrift = new ce(t), this.summaries = new ue(t);
+    this.auth = new F(e);
+    const t = new O(this.auth, { fetchFn: e.fetchFn });
+    this._api = t, this.memories = new j(t), this.decisions = new H(t), this.opinions = new B(t), this.graph = new K(t), this.teams = new G(t), this.profiles = new D(t), this.subscriptions = new N(t), this.authAPI = new J(t), this.agents = new W(t), this.usage = new V(t), this.insights = new Y(t), this.tokenUsage = new X(t), this.temporal = new Z(t), this.governance = new Q(t), this.evolution = new ee(t), this.reasoning = new te(t), this.reasoningTraces = new se(t), this.ontology = new ne(t), this.analytics = new re(t), this.validation = new ie(t), this.pipeline = new ae(t), this.archive = new oe(t), this.zettelkasten = new ce(t), this.procedureMatches = new ue(t), this.procedureCandidates = new le(t), this.procedureDrift = new me(t), this.summaries = new he(t), this.locks = new ye(t), this.sequences = new pe(t);
   }
   setTeamId(e) {
     this.auth.tokenManager.setTeamId(e), this.auth.notifyListeners();
@@ -3033,36 +3303,38 @@ class le {
   }
 }
 export {
-  h as A,
-  E as B,
-  O as D,
-  Z as E,
-  Y as G,
-  J as I,
-  x as M,
-  ee as O,
-  re as P,
-  Q as R,
-  le as S,
-  H as T,
-  D as U,
-  se as V,
-  ie as Z,
-  N as a,
-  te as b,
-  ne as c,
-  G as d,
-  z as e,
-  j as f,
-  F as g,
-  oe as h,
-  ae as i,
-  B as j,
-  X as k,
-  K as l,
-  V as m,
-  L as n,
-  W as o,
-  q as p,
-  M as q
+  k as A,
+  O as B,
+  H as D,
+  ee as E,
+  Q as G,
+  Y as I,
+  ye as L,
+  j as M,
+  ne as O,
+  ae as P,
+  te as R,
+  pe as S,
+  G as T,
+  V as U,
+  ie as V,
+  ce as Z,
+  W as a,
+  re as b,
+  oe as c,
+  J as d,
+  F as e,
+  K as f,
+  B as g,
+  le as h,
+  ue as i,
+  D as j,
+  se as k,
+  ge as l,
+  N as m,
+  Z as n,
+  z as o,
+  X as p,
+  E as q,
+  x as r
 };