@smartmemory/sdk-js 1.4.67 → 1.4.86

package/dist/{core-y-uPkyF8.js → core-BUZV42uF.js}

@@ -2,14 +2,14 @@ var P = (a) => {
   throw TypeError(a);
 };
 var v = (a, e, t) => e.has(a) || P("Cannot " + t);
-var R = (a, e, t) => (v(a, e, "read from private field"), t ? t.call(a) : e.get(a)), A = (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), T = (a, e, t, n) => (v(a, e, "write to private field"), n ? n.call(a, t) : e.set(a, t), t), q = (a, e, t) => (v(a, e, "access private method"), t);
+var I = (a, e, t) => (v(a, e, "read from private field"), t ? t.call(a) : e.get(a)), A = (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), T = (a, e, t, n) => (v(a, e, "write to private field"), n ? n.call(a, t) : e.set(a, t), t), q = (a, e, t) => (v(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"
-}, w = {
+}, k = {
   access: ["access_token", "sm_token"],
   refresh: ["refresh_token", "sm_refresh_token"],
   user: ["sm_user"],
@@ -26,7 +26,7 @@ class x {
     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, w.access);
+    return this.storageType === "memory" ? this._memory.access : this._getFromStorage(this.keys.access, k.access);
   }
   setAccessToken(e) {
     if (this.storageType === "memory") {
@@ -36,7 +36,7 @@ class x {
     this._setInStorage(this.keys.access, e);
   }
   getRefreshToken() {
-    return this.storageType === "memory" ? this._memory.refresh : this._getFromStorage(this.keys.refresh, w.refresh);
+    return this.storageType === "memory" ? this._memory.refresh : this._getFromStorage(this.keys.refresh, k.refresh);
   }
   setRefreshToken(e) {
     if (this.storageType === "memory") {
@@ -47,7 +47,7 @@ class x {
   }
   getUser() {
     if (this.storageType === "memory") return this._memory.user;
-    const e = this._getFromStorage(this.keys.user, w.user);
+    const e = this._getFromStorage(this.keys.user, k.user);
     if (!e) return null;
     try {
       return JSON.parse(e);
@@ -63,7 +63,7 @@ class x {
     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, w.tenant));
+    return this.storageType === "memory" ? this._memory.tenant : this._normalizeId(this._getFromStorage(this.keys.tenant, k.tenant));
   }
   setTenantId(e) {
     const t = this._normalizeId(e);
@@ -74,7 +74,7 @@ class x {
     this._setInStorage(this.keys.tenant, t);
   }
   getTeamId() {
-    return this.storageType === "memory" ? this._memory.team : this._normalizeId(this._getFromStorage(this.keys.team, w.team));
+    return this.storageType === "memory" ? this._memory.team : this._normalizeId(this._getFromStorage(this.keys.team, k.team));
   }
   setTeamId(e) {
     const t = this._normalizeId(e);
@@ -94,7 +94,7 @@ class x {
         localStorage.removeItem(e), sessionStorage.removeItem(e);
       } catch {
       }
-    for (const e of Object.values(w))
+    for (const e of Object.values(k))
       for (const t of e)
         try {
           localStorage.removeItem(t), sessionStorage.removeItem(t);
@@ -148,7 +148,7 @@ class x {
     return n === "none" || n === "null" || n === "undefined" ? null : t;
   }
 }
-var f, U, E;
+var g, S, E;
 class z {
   /**
    * @param {Object} options
@@ -160,22 +160,22 @@ class z {
    * @param {function(): void} options.onRefreshFailed
    */
   constructor({ apiBaseUrl: e, refreshEndpoint: t, tokenManager: n, useCookieAuth: s = !1, onTokenRefreshed: r, onRefreshFailed: i }) {
-    A(this, U);
-    A(this, f, null);
+    A(this, S);
+    A(this, g, null);
     this.apiBaseUrl = e, this.refreshEndpoint = t, this.tokenManager = n, this.useCookieAuth = s, this.onTokenRefreshed = r, this.onRefreshFailed = i;
   }
   async refresh() {
-    if (R(this, f))
-      return R(this, f);
-    T(this, f, q(this, U, E).call(this));
+    if (I(this, g))
+      return I(this, g);
+    T(this, g, q(this, S, E).call(this));
     try {
-      return await R(this, f);
+      return await I(this, g);
     } finally {
-      T(this, f, null);
+      T(this, g, null);
     }
   }
 }
-f = new WeakMap(), U = new WeakSet(), E = async function() {
+g = new WeakMap(), S = new WeakSet(), E = async function() {
   const e = this.tokenManager.getRefreshToken();
   if (!e && !this.useCookieAuth)
     throw this.onRefreshFailed(), new Error("No refresh token");
@@ -367,7 +367,7 @@ class O {
     this.tokenManager.setTenantId(e), this.notifyListeners();
   }
 }
-class k extends Error {
+class $ extends Error {
   /**
    * @param {string} message - Error message
    * @param {number} [status=0] - HTTP status code (0 for network errors)
@@ -377,7 +377,7 @@ class k extends Error {
     super(e), this.name = "APIError", this.status = t, this.detail = n;
   }
 }
-function S(a) {
+function R(a) {
   return typeof FormData < "u" && a instanceof FormData;
 }
 function L(a) {
@@ -407,7 +407,7 @@ class j {
   async request(e, t = {}) {
     var i, c;
     const n = `${this.baseURL}${e}`, s = {
-      ...S(t.body) ? {} : { "Content-Type": "application/json" },
+      ...R(t.body) ? {} : { "Content-Type": "application/json" },
       ...this.auth.getAuthHeaders(t.headers)
     }, r = this.auth.getRequestOptions({ ...t, headers: s });
     try {
@@ -415,25 +415,25 @@ class j {
       if (o.status === 401 && !t.__isRetry)
         try {
           await this.auth.refreshToken();
-          const h = {
-            ...S(t.body) ? {} : { "Content-Type": "application/json" },
+          const m = {
+            ...R(t.body) ? {} : { "Content-Type": "application/json" },
             ...this.auth.getAuthHeaders(t.headers)
           };
           o = await this.fetchFn(
             n,
-            this.auth.getRequestOptions({ ...r, headers: h, __isRetry: !0 })
+            this.auth.getRequestOptions({ ...r, headers: m, __isRetry: !0 })
           );
         } catch {
         }
       if (o.status === 401)
-        throw (c = (i = this.auth).clearLocalAuth) == null || c.call(i), new k("Authentication required", 401, "auth_expired");
+        throw (c = (i = this.auth).clearLocalAuth) == null || c.call(i), new $("Authentication required", 401, "auth_expired");
       if (o.status === 204)
         return null;
       if (!o.ok)
         throw await this._handleError(o);
       return await o.json();
     } catch (o) {
-      throw o instanceof k || L(o) ? o : new k(o.message, 0, "network_error");
+      throw o instanceof $ || L(o) ? o : new $(o.message, 0, "network_error");
     }
   }
   async get(e, t = {}) {
@@ -449,7 +449,7 @@ class j {
   async requestBinary(e, t = {}) {
     var i, c;
     const n = `${this.baseURL}${e}`, s = {
-      ...S(t.body) ? {} : { "Content-Type": "application/json" },
+      ...R(t.body) ? {} : { "Content-Type": "application/json" },
       ...this.auth.getAuthHeaders(t.headers)
     }, r = this.auth.getRequestOptions({ ...t, headers: s });
     try {
@@ -457,23 +457,23 @@ class j {
       if (o.status === 401 && !t.__isRetry)
         try {
           await this.auth.refreshToken();
-          const h = {
-            ...S(t.body) ? {} : { "Content-Type": "application/json" },
+          const m = {
+            ...R(t.body) ? {} : { "Content-Type": "application/json" },
             ...this.auth.getAuthHeaders(t.headers)
           };
           o = await this.fetchFn(
             n,
-            this.auth.getRequestOptions({ ...r, headers: h, __isRetry: !0 })
+            this.auth.getRequestOptions({ ...r, headers: m, __isRetry: !0 })
           );
         } catch {
         }
       if (o.status === 401)
-        throw (c = (i = this.auth).clearLocalAuth) == null || c.call(i), new k("Authentication required", 401, "auth_expired");
+        throw (c = (i = this.auth).clearLocalAuth) == null || c.call(i), new $("Authentication required", 401, "auth_expired");
       if (!o.ok)
         throw await this._handleError(o);
       return await o.arrayBuffer();
     } catch (o) {
-      throw o instanceof k || L(o) ? o : new k(o.message, 0, "network_error");
+      throw o instanceof $ || L(o) ? o : new $(o.message, 0, "network_error");
     }
   }
   async postForm(e, t, n = {}) {
@@ -510,7 +510,7 @@ class j {
     } catch {
       t = { message: `HTTP ${e.status}` };
     }
-    return new k(
+    return new $(
       this._extractMessage(t, e.status),
       e.status,
       t
@@ -693,6 +693,14 @@ class B {
    *   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.includeArchived=false] - Keep archived items visible in
+   *   results (CORE-ARCHIVED-RECALL-1). Archived items are memories the decay/prune
+   *   evolvers retired, or the source an episodic-to-semantic promotion replaced.
+   *   Third sibling of the two above and not covered by either: an archived item has
+   *   no replacement and no version chain. Also inert when asOfDate is set. Note this
+   *   default CHANGED behaviour rather than preserving it — before
+   *   CORE-ARCHIVED-RECALL-1 the server read `archived` on no search path at all, so
+   *   archived items were returned ranked exactly like live ones.
    * @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".
@@ -709,9 +717,36 @@ class B {
    *   result marked `'unresolved'` is PRESENT-DAY content and must not be rendered
    *   as a historical belief.
    */
-  async search(e, { topK: t = 5, enableHybrid: n = !0, memoryType: s = 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: n };
-    return s && (l.memory_type = s), 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);
+  async search(e, { topK: t = 5, enableHybrid: n = !0, memoryType: s = null, expertise: r = !1, cite: i = !1, decompose: c = !1, multiHop: o = !1, maxHops: m = 3, budgetMs: h = 1500, semanticHops: y = !1, includeReference: p = !1, includeConsolidated: f = !1, consolidationFirst: _ = !1, asOfDate: d = null, asOfStrict: l = !1, includeSuperseded: w = !1, includeRetracted: b = !1, includeArchived: U = !1 } = {}) {
+    const u = { query: e, top_k: t, enable_hybrid: n };
+    return s && (u.memory_type = s), r && (u.expertise = !0), i && (u.cite = !0), c && (u.decompose = !0), o && (u.multi_hop = !0), o && m !== 3 && (u.max_hops = m), o && h !== 1500 && (u.budget_ms = h), o && y && (u.semantic_hops = !0), p && (u.include_reference = !0), f && (u.include_consolidated = !0), _ && (u.consolidation_first = !0), d && (u.as_of_date = d instanceof Date ? d.toISOString() : d), l && (u.as_of_strict = !0), w && (u.include_superseded = !0), b && (u.include_retracted = !0), U && (u.include_archived = !0), this.api.post("/memory/search", u);
+  }
+  /**
+   * Ask a question and get a written answer plus the evidence behind it (DIST-LITE-9).
+   *
+   * Where `search` hands back ranked memories for the caller to read, this returns a
+   * grounded answer together with the exact memories and graph relations it was built
+   * from, so a reader can check it rather than trust it. The evidence list is the
+   * retrieved set captured before the model ran, so a citation cannot be invented.
+   *
+   * The same request and response shape is served by the lite daemon on port 9014 and
+   * by the hosted API, which is what lets `AskPanel` from `@smartmemory/graph` point at
+   * either without changing.
+   *
+   * There is no fallback answer: a 502 comes back when the configured LLM errors or
+   * returns nothing, rather than a synthesized reply.
+   *
+   * @param {string} question - The natural-language question.
+   * @param {Object} [options]
+   * @param {number} [options.limit=5] - How many memories to retrieve as evidence (1-50).
+   * @param {boolean} [options.reasoning=true] - When false, `reasoning` comes back empty.
+   * @returns {Promise<{answer: string, reasoning: string, evidence: Array<{item_id: string, content: string}>, relations: Array<{source: string, type: string, target: string, source_id: string, target_id: string}>}>}
+   *   Relation rows carry both display labels and graph node ids; combine them as
+   *   `${source_id}->${target_id}:${type}` to address the edge in a graph view.
+   */
+  async ask(e, { limit: t = 5, reasoning: n = !0 } = {}) {
+    const s = { question: e, limit: t };
+    return n !== !0 && (s.reasoning = n), this.api.post("/memory/ask", s);
   }
   /**
    * Get the complete audit answer for one memory (PLAT-AUDITABLE-MEMORY-1).
@@ -959,10 +994,10 @@ class H {
     evidenceIds: i = null,
     domain: c = null,
     tags: o = null,
-    rejectedAlternatives: h = null,
-    rationale: y = null,
-    constraints: p = null,
-    agentId: d = null
+    rejectedAlternatives: m = null,
+    rationale: h = null,
+    constraints: y = null,
+    agentId: p = null
   }) {
     return this.api.post("/memory/decisions/create", {
       content: e,
@@ -973,10 +1008,10 @@ class H {
       evidence_ids: i,
       domain: c,
       tags: o,
-      rejected_alternatives: h,
-      rationale: y,
-      constraints: p,
-      agent_id: d
+      rejected_alternatives: m,
+      rationale: h,
+      constraints: y,
+      agent_id: p
     });
   }
   /**
@@ -2356,8 +2391,8 @@ class re {
   async listTypes({ tier: e, layer: t, packId: n, hasIri: s, kind: r, limit: i = 100, cursor: c } = {}) {
     const o = { limit: String(i) };
     e !== void 0 && (o.tier = e), t !== void 0 && (o.layer = t), n !== void 0 && (o.pack_id = n), s !== void 0 && (o.has_iri = String(s)), 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 : ""}`);
+    const m = new URLSearchParams(o).toString();
+    return this.api.get(`/memory/ontology/types${m ? "?" + m : ""}`);
   }
   /**
    * Declare an ontology class (CORE-MEMTYPE-DECLARE-1).
@@ -2396,16 +2431,16 @@ class re {
     storageSearchable: i,
     iri: c,
     wikidataQid: o,
-    displayName: h,
-    definition: y,
-    description: p,
-    aliases: d,
-    examples: _,
-    parentTypes: $,
-    tier: g = "confirmed"
+    displayName: m,
+    definition: h,
+    description: y,
+    aliases: p,
+    examples: f,
+    parentTypes: _,
+    tier: d = "confirmed"
   } = {}) {
-    const u = { name: e, kind: t, tier: g };
-    return n !== void 0 && (u.properties_schema = n), s !== void 0 && (u.required_properties = s), 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);
+    const l = { name: e, kind: t, tier: d };
+    return n !== void 0 && (l.properties_schema = n), s !== void 0 && (l.required_properties = s), r !== void 0 && (l.storage_strategy = r), i !== void 0 && (l.storage_searchable = i), c !== void 0 && (l.iri = c), o !== void 0 && (l.wikidata_qid = o), m !== void 0 && (l.display_name = m), h !== void 0 && (l.definition = h), y !== void 0 && (l.description = y), p !== void 0 && (l.aliases = p), f !== void 0 && (l.examples = f), _ !== void 0 && (l.parent_types = _), this.api.post("/memory/ontology/types", l);
   }
   /**
    * Declare an ontology relation (CORE-MEMTYPE-DECLARE-1; declare-only in P1).
@@ -2442,20 +2477,20 @@ class re {
     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"
+    symmetric: m,
+    reflexive: h,
+    parentRelations: y,
+    iri: p,
+    wikidataPid: f,
+    displayName: _,
+    definition: d,
+    description: l,
+    aliases: w,
+    examples: b,
+    tier: U = "confirmed"
   } = {}) {
-    const m = { name: e, tier: l };
-    return t !== void 0 && (m.domain = t), n !== void 0 && (m.range = n), s !== void 0 && (m.inverse_of = s), 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);
+    const u = { name: e, tier: U };
+    return t !== void 0 && (u.domain = t), n !== void 0 && (u.range = n), s !== void 0 && (u.inverse_of = s), r !== void 0 && (u.cardinality = r), i !== void 0 && (u.temporal = i), c !== void 0 && (u.properties_schema = c), o !== void 0 && (u.transitive = o), m !== void 0 && (u.symmetric = m), h !== void 0 && (u.reflexive = h), y !== void 0 && (u.parent_relations = y), p !== void 0 && (u.iri = p), f !== void 0 && (u.wikidata_pid = f), _ !== void 0 && (u.display_name = _), d !== void 0 && (u.definition = d), l !== void 0 && (u.description = l), w !== void 0 && (u.aliases = w), b !== void 0 && (u.examples = b), this.api.post("/memory/ontology/relations", u);
   }
   /**
    * List ontology relation types, keyset-paginated. Mirror of `listTypes`.
@@ -3424,7 +3459,7 @@ class $e {
   }
 }
 export {
-  k as A,
+  $ as A,
   j as B,
   H as D,
   te as E,

package/dist/core.js

@@ -1,4 +1,4 @@
-import { A as e, a as r, d as A, e as I, B as P, D as o, f as n, I as t, M as g, O as i, j as m, q as M, r as h, l as f, m as l, T as S, o as p, U as u } from "./core-y-uPkyF8.js";
+import { A as e, a as r, d as A, e as I, B as P, D as o, f as n, I as t, M as g, O as i, j as m, q as M, r as h, l as f, m as l, T as S, o as p, U as u } from "./core-BUZV42uF.js";
 export {
   e as APIError,
   r as AgentAPI,

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as f, a as u, b as A, c as P, d as b, e as h, D as I, E as g, G as x, f as p, I as w, L as m, M as k, O as v, g as T, P as B, h as y, i as C, j as S, R as E, k as R, S as F, l as L, m as M, T as O, n as G, o as U, p as $, U as D, V, Z } from "./core-y-uPkyF8.js";
+import { A as f, a as u, b as A, c as P, d as b, e as h, D as I, E as g, G as x, f as p, I as w, L as m, M as k, O as v, g as T, P as B, h as y, i as C, j as S, R as E, k as R, S as F, l as L, m as M, T as O, n as G, o as U, p as $, U as D, V, Z } from "./core-BUZV42uF.js";
 const i = {
   variables: {
     colorBackground: "transparent",

package/dist/react.js

@@ -1,5 +1,5 @@
 import h, { createContext as d, useRef as S, useState as p, useEffect as C, useCallback as c, useContext as g } from "react";
-import { l as y } from "./core-y-uPkyF8.js";
+import { l as y } from "./core-BUZV42uF.js";
 const m = d(null), f = d(null);
 function b({ children: e, ...r }) {
   const n = S(null);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smartmemory/sdk-js",
-  "version": "1.4.67",
+  "version": "1.4.86",
   "description": "Unified JavaScript SDK for SmartMemory API — auth + API client for all frontends",
   "type": "module",
   "main": "dist/index.js",