@smartmemory/sdk-js 0.6.0 → 0.6.4

package/README.md

@@ -1,5 +1,7 @@
 # @smartmemory/sdk-js
 
+**Version:** 0.6.0
+
 Unified JavaScript SDK for [SmartMemory](https://smartmemory.ai) — consolidates authentication and API client logic across all SmartMemory frontend applications.
 
 ## Features
@@ -117,6 +119,27 @@ const client = new SmartMemoryClient({
 
 ## Domain APIs
 
+### Expertise Layer
+
+SmartMemory's [expertise layer](https://docs.smartmemory.ai/smartmemory/concepts/expertise-vs-knowledge) — `decision`, `constraint`, `learned`, `opinion`, `reasoning`, `observation` — surfaces in this SDK via `client.decisions.create()` (with structured `rejectedAlternatives` / `rationale` / `constraints`) for capture and via `client.memories.search(query, { expertise: true })` for partitioned recall.
+
+```javascript
+// Capture
+await client.decisions.create({
+  title: 'Adopt FalkorDB',
+  rejectedAlternatives: ['Neo4j', 'Memgraph'],
+  rationale: 'Smallest ops surface; vector-native; permissive license.',
+  constraints: ['Must support Cypher subset'],
+});
+
+// Recall — typed-dict, partitioned by expertise type
+const results = await client.memories.search('graph db choice', { expertise: true });
+// { decision: [...], constraint: [...], learned: [...],
+//   opinion: [...], reasoning: [...], observation: [...] }
+```
+
+Default `client.memories.search(query)` returns the flat list — no breaking change. The `{ expertise: true }` option switches the response shape; the SDK passes it through verbatim.
+
 ### Memories
 
 ```javascript
@@ -264,3 +287,7 @@ npm run build         # production build
 ## License
 
 MIT
+
+## Documentation
+
+Full SmartMemory documentation: https://docs.smartmemory.ai

package/dist/{core-CC81ya-7.js → core-BIdNSA4o.js}

@@ -1,32 +1,32 @@
-var _ = (i) => {
+var I = (i) => {
   throw TypeError(i);
 };
-var p = (i, e, t) => e.has(i) || _("Cannot " + t);
-var u = (i, e, t) => (p(i, e, "read from private field"), t ? t.call(i) : e.get(i)), g = (i, e, t) => e.has(i) ? _("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(i) : e.set(i, t), d = (i, e, t, r) => (p(i, e, "write to private field"), r ? r.call(i, t) : e.set(i, t), t), $ = (i, e, t) => (p(i, e, "access private method"), t);
-const b = {
+var $ = (i, e, t) => e.has(i) || I("Cannot " + t);
+var p = (i, e, t) => ($(i, e, "read from private field"), t ? t.call(i) : e.get(i)), k = (i, e, t) => e.has(i) ? I("Cannot add the same private member more than once") : e instanceof WeakSet ? e.add(i) : e.set(i, t), w = (i, e, t, r) => ($(i, e, "write to private field"), r ? r.call(i, t) : e.set(i, t), t), S = (i, e, t) => ($(i, e, "access private method"), t);
+const v = {
   access: "smart_memory_auth_token",
   refresh: "smart_memory_refresh_token",
   user: "smart_memory_user",
   tenant: "smart_memory_tenant_id",
   team: "smart_memory_team_id"
-}, m = {
+}, h = {
   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 I {
+class A {
   /**
    * @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 = { ...b, ...t }, this._memory = { access: null, refresh: null, user: null, tenant: null, team: null };
+    this.storageType = e, this.keys = { ...v, ...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, m.access);
+    return this.storageType === "memory" ? this._memory.access : this._getFromStorage(this.keys.access, h.access);
   }
   setAccessToken(e) {
     if (this.storageType === "memory") {
@@ -36,7 +36,7 @@ class I {
     this._setInStorage(this.keys.access, e);
   }
   getRefreshToken() {
-    return this.storageType === "memory" ? this._memory.refresh : this._getFromStorage(this.keys.refresh, m.refresh);
+    return this.storageType === "memory" ? this._memory.refresh : this._getFromStorage(this.keys.refresh, h.refresh);
   }
   setRefreshToken(e) {
     if (this.storageType === "memory") {
@@ -47,7 +47,7 @@ class I {
   }
   getUser() {
     if (this.storageType === "memory") return this._memory.user;
-    const e = this._getFromStorage(this.keys.user, m.user);
+    const e = this._getFromStorage(this.keys.user, h.user);
     if (!e) return null;
     try {
       return JSON.parse(e);
@@ -63,7 +63,7 @@ class I {
     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, m.tenant));
+    return this.storageType === "memory" ? this._memory.tenant : this._normalizeId(this._getFromStorage(this.keys.tenant, h.tenant));
   }
   setTenantId(e) {
     const t = this._normalizeId(e);
@@ -74,7 +74,7 @@ class I {
     this._setInStorage(this.keys.tenant, t);
   }
   getTeamId() {
-    return this.storageType === "memory" ? this._memory.team : this._normalizeId(this._getFromStorage(this.keys.team, m.team));
+    return this.storageType === "memory" ? this._memory.team : this._normalizeId(this._getFromStorage(this.keys.team, h.team));
   }
   setTeamId(e) {
     const t = this._normalizeId(e);
@@ -94,27 +94,35 @@ class I {
         localStorage.removeItem(e), sessionStorage.removeItem(e);
       } catch {
       }
-    for (const e of Object.values(m))
+    for (const e of Object.values(h))
       for (const t of e)
         try {
           localStorage.removeItem(t), sessionStorage.removeItem(t);
         } catch {
         }
   }
+  getImpersonationState() {
+    if (this.storageType === "memory") return null;
+    const e = sessionStorage.getItem("sm_impersonate_email");
+    return e ? { email: e } : null;
+  }
+  clearImpersonation() {
+    this.storageType !== "memory" && (sessionStorage.removeItem("sm_impersonate_token"), sessionStorage.removeItem("sm_impersonate_team"), sessionStorage.removeItem("sm_impersonate_tenant"), sessionStorage.removeItem("sm_impersonate_email"));
+  }
   /** @private */
   _getFromStorage(e, t = []) {
     try {
       const r = this.storageType === "localStorage" ? localStorage : sessionStorage, s = this.storageType === "localStorage" ? sessionStorage : localStorage, n = r.getItem(e) || s.getItem(e);
       if (n != null) return n;
       for (const a of t) {
-        const o = r.getItem(a) || s.getItem(a);
-        if (o != null) {
-          this._setInStorage(e, o);
+        const c = r.getItem(a) || s.getItem(a);
+        if (c != null) {
+          this._setInStorage(e, c);
           try {
             r.removeItem(a), s.removeItem(a);
           } catch {
           }
-          return o;
+          return c;
         }
       }
       return null;
@@ -140,8 +148,8 @@ class I {
     return r === "none" || r === "null" || r === "undefined" ? null : t;
   }
 }
-var l, y, k;
-class T {
+var m, d, T;
+class R {
   /**
    * @param {Object} options
    * @param {string} options.apiBaseUrl
@@ -152,22 +160,22 @@ class T {
    * @param {function(): void} options.onRefreshFailed
    */
   constructor({ apiBaseUrl: e, refreshEndpoint: t, tokenManager: r, useCookieAuth: s = !1, onTokenRefreshed: n, onRefreshFailed: a }) {
-    g(this, y);
-    g(this, l, null);
+    k(this, d);
+    k(this, m, null);
     this.apiBaseUrl = e, this.refreshEndpoint = t, this.tokenManager = r, this.useCookieAuth = s, this.onTokenRefreshed = n, this.onRefreshFailed = a;
   }
   async refresh() {
-    if (u(this, l))
-      return u(this, l);
-    d(this, l, $(this, y, k).call(this));
+    if (p(this, m))
+      return p(this, m);
+    w(this, m, S(this, d, T).call(this));
     try {
-      return await u(this, l);
+      return await p(this, m);
     } finally {
-      d(this, l, null);
+      w(this, m, null);
     }
   }
 }
-l = new WeakMap(), y = new WeakSet(), k = async function() {
+m = new WeakMap(), d = new WeakSet(), T = async function() {
   const e = this.tokenManager.getRefreshToken();
   if (!e && !this.useCookieAuth)
     throw this.onRefreshFailed(), new Error("No refresh token");
@@ -182,8 +190,8 @@ l = new WeakMap(), y = new WeakSet(), k = async function() {
   const s = await r.json();
   return this.tokenManager.setAccessToken(s.access_token), s.refresh_token && this.tokenManager.setRefreshToken(s.refresh_token), this.onTokenRefreshed(s.access_token), s.access_token;
 };
-const f = "smart_memory_sso_redirect";
-class S {
+const b = "smart_memory_sso_redirect";
+class U {
   /**
    * @param {Object} options
    * @param {string} options.webAppUrl - Web app URL for login redirect
@@ -208,26 +216,26 @@ class S {
   }
   storeRedirect(e) {
     try {
-      sessionStorage.setItem(f, e);
+      sessionStorage.setItem(b, e);
     } catch (t) {
       console.warn("Failed to store redirect URL:", t);
     }
   }
   getAndClearRedirect() {
     try {
-      const e = sessionStorage.getItem(f);
-      return sessionStorage.removeItem(f), e;
+      const e = sessionStorage.getItem(b);
+      return sessionStorage.removeItem(b), e;
     } catch {
       return null;
     }
   }
 }
-class A {
+class P {
   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 I({
+    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 A({
       storage: e.storage || "localStorage",
       keys: e.tokenKeys
-    }), this.mode !== "apiKey" ? this.refreshManager = new T({
+    }), this.mode !== "apiKey" ? this.refreshManager = new R({
       apiBaseUrl: this.apiBaseUrl,
       refreshEndpoint: this.endpoints.refresh || "/auth/refresh",
       tokenManager: this.tokenManager,
@@ -239,7 +247,7 @@ class A {
       onRefreshFailed: () => {
         this.clearLocalAuth();
       }
-    }) : this.refreshManager = null, this.mode === "sso" && (this.ssoManager = new S({
+    }) : this.refreshManager = null, this.mode === "sso" && (this.ssoManager = new U({
       webAppUrl: e.webAppUrl,
       allowedHosts: e.allowedRedirectHosts || [],
       tokenManager: this.tokenManager
@@ -358,7 +366,7 @@ class A {
     this.tokenManager.setTenantId(e), this.notifyListeners();
   }
 }
-class h extends Error {
+class g extends Error {
   /**
    * @param {string} message - Error message
    * @param {number} [status=0] - HTTP status code (0 for network errors)
@@ -368,7 +376,7 @@ class h extends Error {
     super(e), this.name = "APIError", this.status = t, this.detail = r;
   }
 }
-class v {
+class C {
   /**
    * @param {import('../auth/AuthCore.js').AuthCore} authCore
    * @param {{ fetchFn?: typeof globalThis.fetch }} [options]
@@ -377,38 +385,38 @@ class v {
     this.auth = e, this.baseURL = e.apiBaseUrl, this._customFetchFn = t || null;
   }
   get fetchFn() {
-    return this._customFetchFn || globalThis.fetch;
+    return this._customFetchFn || globalThis.fetch.bind(globalThis);
   }
   async request(e, t = {}) {
-    var a, o;
+    var a, c;
     const r = `${this.baseURL}${e}`, s = {
       "Content-Type": "application/json",
       ...this.auth.getAuthHeaders(t.headers)
     }, n = this.auth.getRequestOptions({ ...t, headers: s });
     try {
-      let c = await this.fetchFn(r, n);
-      if (c.status === 401 && !t.__isRetry)
+      let o = await this.fetchFn(r, n);
+      if (o.status === 401 && !t.__isRetry)
         try {
           await this.auth.refreshToken();
-          const w = {
+          const u = {
             "Content-Type": "application/json",
             ...this.auth.getAuthHeaders(t.headers)
           };
-          c = await this.fetchFn(
+          o = await this.fetchFn(
             r,
-            this.auth.getRequestOptions({ ...n, headers: w, __isRetry: !0 })
+            this.auth.getRequestOptions({ ...n, headers: u, __isRetry: !0 })
           );
         } catch {
         }
-      if (c.status === 401)
-        throw (o = (a = this.auth).clearLocalAuth) == null || o.call(a), new h("Authentication required", 401, "auth_expired");
-      if (c.status === 204)
+      if (o.status === 401)
+        throw (c = (a = this.auth).clearLocalAuth) == null || c.call(a), new g("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 g ? o : new g(o.message, 0, "network_error");
     }
   }
   async get(e, t = {}) {
@@ -448,14 +456,14 @@ class v {
     } catch {
       t = { message: `HTTP ${e.status}` };
     }
-    return new h(
+    return new g(
       t.detail || t.message || `HTTP ${e.status}`,
       e.status,
       t
     );
   }
 }
-class R {
+class L {
   constructor(e) {
     this.api = e;
   }
@@ -467,14 +475,14 @@ class R {
     profileName: n = null,
     conversationContext: a = null
   }) {
-    const o = {
+    const c = {
       content: e,
       memory_type: t,
       metadata: r,
       use_pipeline: s,
       profile_name: n
     };
-    return a != null && (o.conversation_context = a), this.api.post("/memory/add", o);
+    return a != null && (c.conversation_context = a), this.api.post("/memory/add", c);
   }
   async get(e) {
     const t = await this.api.get(`/memory/${e}`);
@@ -503,9 +511,33 @@ class R {
     let s = `/memory/list?limit=${e}&offset=${t}`;
     return r && (s += `&memory_type=${r}`), this.api.get(s);
   }
-  async search(e, { topK: t = 5, enableHybrid: r = !0, memoryType: s = null } = {}) {
-    const n = { query: e, top_k: t, enable_hybrid: r };
-    return s && (n.memory_type = s), this.api.post("/memory/search", n);
+  /**
+   * Search for memory items.
+   *
+   * @param {string} query - Search query string.
+   * @param {object} [options]
+   * @param {number} [options.topK=5]
+   * @param {boolean} [options.enableHybrid=true]
+   * @param {string|null} [options.memoryType=null]
+   * @param {boolean} [options.expertise=false] - When true (CORE-EXPERTISE-1 Phase 4a),
+   *   the response shape changes from a flat list to `{results: {<expertise_type>: [items]}}`
+   *   keyed by expertise type (decision, constraint, learned, opinion, reasoning, observation).
+   *   Each bucket holds up to topK items.
+   * @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".
+   * @returns {Promise<{results: Array|Object, group_roots: Object, citations?: Array}>}
+   *   CORE-RECALL-LINEAGE-1: the response is ALWAYS a `SearchResponse` envelope —
+   *   `results` is a flat array by default and a `{bucket: [...]}` map under
+   *   `expertise: true`; `group_roots` is always present (possibly `{}`) and
+   *   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.
+   */
+  async search(e, { topK: t = 5, enableHybrid: r = !0, memoryType: s = null, expertise: n = !1, cite: a = !1, decompose: c = !1, multiHop: o = !1, maxHops: u = 3, budgetMs: y = 1500, semanticHops: f = !1, includeReference: _ = !1 } = {}) {
+    const l = { query: e, top_k: t, enable_hybrid: r };
+    return s && (l.memory_type = s), n && (l.expertise = !0), a && (l.cite = !0), c && (l.decompose = !0), o && (l.multi_hop = !0), o && u !== 3 && (l.max_hops = u), o && y !== 1500 && (l.budget_ms = y), o && f && (l.semantic_hops = !0), _ && (l.include_reference = !0), this.api.post("/memory/search", l);
   }
   async getWorkingContext(e, t, { k: r = 20, maxTokens: s = null, strategy: n = null } = {}) {
     const a = {
@@ -553,10 +585,10 @@ class R {
     sessionDates: s = null,
     turnsPerChunk: n = 15,
     maxChunkChars: a = 12e3,
-    maxConcurrent: o = 4
+    maxConcurrent: c = 4
   } = {}) {
-    const c = { turns: e, turns_per_chunk: n, max_chunk_chars: a, max_concurrent: o };
-    return t && (c.session_boundaries = t), r && (c.conversation_id = r), s && (c.session_dates = s), this.api.post("/memory/ingest/conversation", c);
+    const o = { turns: e, turns_per_chunk: n, max_chunk_chars: a, max_concurrent: c };
+    return t && (o.session_boundaries = t), r && (o.conversation_id = r), s && (o.session_dates = s), this.api.post("/memory/ingest/conversation", o);
   }
   async ingestDocument(e, { title: t = null, source: r = null, chunkStrategy: s = null } = {}) {
     const n = { content: e };
@@ -668,7 +700,7 @@ class R {
     return this.api.get("/memory/clustering/stats");
   }
 }
-class U {
+class M {
   constructor(e) {
     this.api = e;
   }
@@ -683,6 +715,9 @@ class U {
    * @param {string[]} [params.evidenceIds]
    * @param {string} [params.domain]
    * @param {string[]} [params.tags]
+   * @param {string} [params.agentId] - Producing agent id (CORE-AGENT-ATTRIBUTION-1).
+   *   When omitted, the backend auto-populates from scope.resolve_agent_id() —
+   *   non-null only when the caller's user_type=='agent'.
    */
   async create({
     content: e,
@@ -691,8 +726,12 @@ class U {
     sourceTraceId: s = null,
     sourceSessionId: n = null,
     evidenceIds: a = null,
-    domain: o = null,
-    tags: c = null
+    domain: c = null,
+    tags: o = null,
+    rejectedAlternatives: u = null,
+    rationale: y = null,
+    constraints: f = null,
+    agentId: _ = null
   }) {
     return this.api.post("/memory/decisions/create", {
       content: e,
@@ -701,13 +740,28 @@ class U {
       source_trace_id: s,
       source_session_id: n,
       evidence_ids: a,
-      domain: o,
-      tags: c
+      domain: c,
+      tags: o,
+      rejected_alternatives: u,
+      rationale: y,
+      constraints: f,
+      agent_id: _
     });
   }
   /**
    * List active decisions with optional filters.
-   * @param {Object} [params] - Query parameters (domain, decision_type, min_confidence, limit)
+   * @param {Object} [params] - Query parameters
+   * @param {string} [params.domain] - Filter by domain
+   * @param {string} [params.decision_type] - Filter by decision type
+   * @param {number} [params.min_confidence=0.0] - Minimum confidence (0..1)
+   * @param {number} [params.limit=50] - Maximum results
+   * @param {string} [params.agent_id] - Filter by producing agent id
+   *   (CORE-AGENT-ATTRIBUTION-1). NULL-valued rows are excluded when set.
+   * @param {string} [params.provenance_memory_id] - Inverse-provenance filter
+   *   (CORE-DECISION-PROVENANCE-LOOKUP-1). When set, returns only decisions whose
+   *   provenance subgraph contains this memory id. Filters compose in-query so
+   *   the response never silently truncates below `limit` when more matches exist.
+   *   Unknown or out-of-scope memory ids return an empty list (never 404).
    */
   async list(e = {}) {
     const t = new URLSearchParams(e).toString();
@@ -823,7 +877,29 @@ class U {
     });
   }
 }
-class P {
+class z {
+  constructor(e) {
+    this.api = e;
+  }
+  /**
+   * Create a new opinion with optional agent attribution.
+   * @param {string} content - Opinion content (required).
+   * @param {Object} [opts]
+   * @param {number} [opts.confidence] - Initial confidence (0..1).
+   * @param {string} [opts.subject] - What the opinion is about.
+   * @param {string} [opts.subjectType] - Type tag for the subject.
+   * @param {Object} [opts.disposition] - Disposition payload.
+   * @param {string[]} [opts.formedFrom] - Source memory ids that formed it.
+   * @param {string} [opts.domain] - Domain tag for filtered retrieval.
+   * @param {string} [opts.agentId] - Producing agent id; omit to let the
+   *   server auto-populate from scope.resolve_agent_id().
+   */
+  async createOpinion(e, t = {}) {
+    const r = { content: e };
+    return t.confidence !== void 0 && (r.confidence = t.confidence), t.subject !== void 0 && (r.subject = t.subject), t.subjectType !== void 0 && (r.subject_type = t.subjectType), t.disposition !== void 0 && (r.disposition = t.disposition), t.formedFrom !== void 0 && (r.formed_from = t.formedFrom), t.domain !== void 0 && (r.domain = t.domain), t.agentId !== void 0 && (r.agent_id = t.agentId), this.api.post("/memory/opinions/create", r);
+  }
+}
+class E {
   constructor(e) {
     this.api = e;
   }
@@ -909,7 +985,7 @@ class P {
     return this.api.get(`/memory/${encodeURIComponent(e)}/links`);
   }
 }
-class C {
+class O {
   constructor(e) {
     this.api = e;
   }
@@ -949,7 +1025,7 @@ class C {
     return this.api.delete(`/memory/teams/${e}/members/${t}`);
   }
 }
-class M {
+class x {
   constructor(e) {
     this.api = e;
   }
@@ -966,7 +1042,7 @@ class M {
     return this.api.patch("/auth/llm-keys", e);
   }
 }
-class L {
+class q {
   constructor(e) {
     this.api = e;
   }
@@ -992,7 +1068,7 @@ class L {
     });
   }
 }
-class z {
+class j {
   constructor(e) {
     this.api = e;
   }
@@ -1013,7 +1089,7 @@ class z {
     return this.api.delete(`/memory/api-keys/${e}`);
   }
 }
-class E {
+class F {
   constructor(e) {
     this.api = e;
   }
@@ -1040,8 +1116,39 @@ class E {
   async setRecallProfile(e, t) {
     return this.api.put(`/memory/agents/${e}/recall-profile`, { recall_profile: t });
   }
+  /**
+   * Get the current evaluation for an agent on a given (dimension, domain) slot.
+   *
+   * CORE-AGENT-2 S03-T11. Returns { evaluation: object | null }.
+   * null means no evaluation has been written yet (cold-start) — not an error.
+   *
+   * @param {string} agentId - Agent identifier.
+   * @param {string} dimension - Performance dimension (e.g. "decision_volume").
+   * @param {string} domain - Domain string (e.g. "python").
+   * @returns {Promise<{evaluation: object|null}>}
+   */
+  async getEvaluation(e, t, r) {
+    const s = new URLSearchParams({ dimension: t, domain: r }).toString();
+    return this.api.get(`/memory/agents/${e}/evaluation${s ? "?" + s : ""}`);
+  }
+  /**
+   * Get evaluation history for an agent on a given (dimension, domain) slot.
+   *
+   * CORE-AGENT-2 S03-T11. Returns { history: object[] } sorted most-recent-first.
+   *
+   * @param {string} agentId - Agent identifier.
+   * @param {string} dimension - Performance dimension.
+   * @param {string} domain - Domain string.
+   * @param {object} [options]
+   * @param {number} [options.limit=20] - Maximum records to return.
+   * @returns {Promise<{history: object[]}>}
+   */
+  async listEvaluationHistory(e, t, r, { limit: s = 20 } = {}) {
+    const n = new URLSearchParams({ dimension: t, domain: r, limit: String(s) }).toString();
+    return this.api.get(`/memory/agents/${e}/evaluation/history${n ? "?" + n : ""}`);
+  }
 }
-class x {
+class K {
   constructor(e) {
     this.api = e;
   }
@@ -1055,7 +1162,7 @@ class x {
     return this.api.get("/usage/tiers");
   }
 }
-class O {
+class H {
   constructor(e) {
     this.api = e;
   }
@@ -1072,7 +1179,7 @@ class O {
     return this.api.get("/memory/plugins");
   }
 }
-class q {
+class B {
   constructor(e) {
     this.api = e;
   }
@@ -1095,7 +1202,7 @@ class q {
     return this.api.get("/memory/token-usage/current");
   }
 }
-class F {
+class D {
   constructor(e) {
     this.api = e;
   }
@@ -1181,8 +1288,8 @@ class F {
    */
   async getAuditTrail(e, { changeType: t = null, userId: r = null, startTime: s = null, endTime: n = null } = {}) {
     let a = `/memory/temporal/${e}/audit`;
-    const o = [];
-    return t && o.push(`change_type=${t}`), r && o.push(`user_id=${r}`), s && o.push(`start_time=${s}`), n && o.push(`end_time=${n}`), o.length && (a += `?${o.join("&")}`), this.api.get(a);
+    const c = [];
+    return t && c.push(`change_type=${t}`), r && c.push(`user_id=${r}`), s && c.push(`start_time=${s}`), n && c.push(`end_time=${n}`), c.length && (a += `?${c.join("&")}`), this.api.get(a);
   }
   // === TEMPORAL SEARCH ===
   /**
@@ -1241,7 +1348,7 @@ class F {
     return this.api.get(`/memory/temporal/relationships/${e}/valid-periods`);
   }
 }
-class H {
+class G {
   constructor(e) {
     this.api = e;
   }
@@ -1310,7 +1417,7 @@ class H {
     return this.api.get("/memory/governance/summary");
   }
 }
-class j {
+class N {
   constructor(e) {
     this.api = e;
   }
@@ -1351,7 +1458,7 @@ class j {
     return this.api.post("/memory/evolution/reinforce/opinions");
   }
 }
-class K {
+class V {
   constructor(e) {
     this.api = e;
   }
@@ -1449,7 +1556,7 @@ class K {
     });
   }
 }
-class B {
+class J {
   constructor(e) {
     this.api = e;
   }
@@ -1503,7 +1610,7 @@ class B {
     return this.api.get(`/memory/reasoning/traces/${e}`);
   }
 }
-class D {
+class W {
   constructor(e) {
     this.api = e;
   }
@@ -1871,7 +1978,7 @@ class D {
     return this.api.get(`/memory/ontology/updates/stats?history=${e}`);
   }
 }
-class G {
+class Y {
   constructor(e) {
     this.api = e;
   }
@@ -1900,7 +2007,7 @@ class G {
     return e !== null && (s.protected_attributes = e), t !== null && (s.sentiment_analysis = t), r !== null && (s.topic_analysis = r), this.api.post("/memory/analytics/bias", s);
   }
 }
-class N {
+class Z {
   constructor(e) {
     this.api = e;
   }
@@ -1936,7 +2043,7 @@ class N {
     return this.api.get("/memory/validation/inference/rules");
   }
 }
-class V {
+class X {
   constructor(e) {
     this.api = e;
   }
@@ -2052,7 +2159,7 @@ class V {
     return this.api.delete(`/memory/pipeline/configs/${e}`);
   }
 }
-class J {
+class Q {
   constructor(e) {
     this.api = e;
   }
@@ -2078,7 +2185,7 @@ class J {
     return this.api.get(`/memory/archive/${e}`);
   }
 }
-class W {
+class ee {
   constructor(e) {
     this.api = e;
   }
@@ -2237,7 +2344,7 @@ class W {
     return this.api.get(`/memory/zettel/by-relation/${e}/${t}?limit=${r}`);
   }
 }
-class Y {
+class te {
   constructor(e) {
     this.api = e;
   }
@@ -2273,7 +2380,7 @@ class Y {
     return this.api.get("/memory/procedures/matches/stats");
   }
 }
-class Z {
+class re {
   constructor(e) {
     this.api = e;
   }
@@ -2322,7 +2429,7 @@ class Z {
     return this.api.delete(`/memory/procedures/candidates/${e}/dismiss`);
   }
 }
-class X {
+class se {
   constructor(e) {
     this.api = e;
   }
@@ -2377,7 +2484,7 @@ class X {
     return this.api.get(`/memory/procedures/schemas/${e}`);
   }
 }
-class Q {
+class ne {
   constructor(e) {
     this.api = e;
   }
@@ -2449,11 +2556,11 @@ class Q {
     return this.api.delete(`/memory/summary/${e}`);
   }
 }
-class te {
+class ae {
   constructor(e) {
-    this.auth = new A(e);
-    const t = new v(this.auth, { fetchFn: e.fetchFn });
-    this.memories = new R(t), this.decisions = new U(t), this.graph = new P(t), this.teams = new C(t), this.profiles = new M(t), this.subscriptions = new L(t), this.authAPI = new z(t), this.agents = new E(t), this.usage = new x(t), this.insights = new O(t), this.tokenUsage = new q(t), this.temporal = new F(t), this.governance = new H(t), this.evolution = new j(t), this.reasoning = new K(t), this.reasoningTraces = new B(t), this.ontology = new D(t), this.analytics = new G(t), this.validation = new N(t), this.pipeline = new V(t), this.archive = new J(t), this.zettelkasten = new W(t), this.procedureMatches = new Y(t), this.procedureCandidates = new Z(t), this.procedureDrift = new X(t), this.summaries = new Q(t);
+    this.auth = new P(e);
+    const t = new C(this.auth, { fetchFn: e.fetchFn });
+    this.memories = new L(t), this.decisions = new M(t), this.opinions = new z(t), this.graph = new E(t), this.teams = new O(t), this.profiles = new x(t), this.subscriptions = new q(t), this.authAPI = new j(t), this.agents = new F(t), this.usage = new K(t), this.insights = new H(t), this.tokenUsage = new B(t), this.temporal = new D(t), this.governance = new G(t), this.evolution = new N(t), this.reasoning = new V(t), this.reasoningTraces = new J(t), this.ontology = new W(t), this.analytics = new Y(t), this.validation = new Z(t), this.pipeline = new X(t), this.archive = new Q(t), this.zettelkasten = new ee(t), this.procedureMatches = new te(t), this.procedureCandidates = new re(t), this.procedureDrift = new se(t), this.summaries = new ne(t);
   }
   setTeamId(e) {
     this.auth.tokenManager.setTeamId(e), this.auth.notifyListeners();
@@ -2463,35 +2570,36 @@ class te {
   }
 }
 export {
-  h as A,
-  v as B,
-  U as D,
-  j as E,
-  H as G,
-  O as I,
-  R as M,
-  D as O,
-  V as P,
-  K as R,
-  te as S,
-  C as T,
-  x as U,
-  N as V,
-  W as Z,
-  E as a,
-  G as b,
-  J as c,
-  z as d,
-  A as e,
-  P as f,
-  Z as g,
-  Y as h,
-  M as i,
-  B as j,
-  L as k,
-  F as l,
-  I as m,
+  g as A,
+  C as B,
+  M as D,
+  N as E,
+  G,
+  H as I,
+  L as M,
+  W as O,
+  X as P,
+  V as R,
+  U as S,
+  O as T,
+  K as U,
+  Z as V,
+  ee as Z,
+  F as a,
+  Y as b,
+  Q as c,
+  j as d,
+  P as e,
+  E as f,
+  z as g,
+  re as h,
+  te as i,
+  x as j,
+  J as k,
+  R as l,
+  ae as m,
   q as n,
-  T as o,
-  S as p
+  D as o,
+  A as p,
+  B as q
 };

package/dist/core.js

@@ -1,14 +1,14 @@
-import { A as e, a as r, d as A, e as I, B as P, D as o, f as n, I as i, M as t, i as g, o as m, p as M, S as h, k as S, T as f, m as p, U as u } from "./core-CC81ya-7.js";
+import { A as e, a as r, d as A, e as I, B as P, D as n, f as o, I as t, M as i, j as g, l as m, S as M, m as h, n as S, T as f, p, U as l } from "./core-BIdNSA4o.js";
 export {
   e as APIError,
   r as AgentAPI,
   A as AuthAPI,
   I as AuthCore,
   P as BaseAPI,
-  o as DecisionAPI,
-  n as GraphAPI,
-  i as InsightsAPI,
-  t as MemoryAPI,
+  n as DecisionAPI,
+  o as GraphAPI,
+  t as InsightsAPI,
+  i as MemoryAPI,
   g as ProfileAPI,
   m as RefreshManager,
   M as SSOManager,
@@ -16,5 +16,5 @@ export {
   S as SubscriptionAPI,
   f as TeamAPI,
   p as TokenManager,
-  u as UsageAPI
+  l as UsageAPI
 };

package/dist/fetch.js

@@ -1,11 +1,11 @@
-function d(e) {
-  return async function(c, t = {}) {
-    var r;
-    const n = {
+function l(e) {
+  return async function(s, t = {}) {
+    var c;
+    const i = {
       "Content-Type": "application/json",
       ...e.getAuthHeaders(t.headers)
-    }, s = await fetch(c, e.getRequestOptions({ ...t, headers: n }));
-    if (s.status === 401 && !t.__isRetry)
+    }, n = await fetch(s, e.getRequestOptions({ ...t, headers: i }));
+    if (n.status === 401 && !t.__isRetry)
       try {
         await e.refreshToken();
         const a = {
@@ -13,31 +13,31 @@ function d(e) {
           ...e.getAuthHeaders(t.headers)
         };
         return fetch(
-          c,
+          s,
           e.getRequestOptions({ ...t, headers: a, __isRetry: !0 })
         );
       } catch {
-        throw (r = e.clearLocalAuth) == null || r.call(e), new Error("Authentication required");
+        throw (c = e.clearLocalAuth) == null || c.call(e), new Error("Authentication required");
       }
-    return s;
+    return n;
   };
 }
-function f(e, { urlPatterns: i = [] } = {}) {
-  const c = globalThis.fetch;
-  return globalThis.fetch = async function(n, s = {}) {
-    const r = typeof n == "string" ? n : n.toString();
-    if (!(i.length === 0 || i.some((o) => r.includes(o))))
-      return c(n, s);
+function f(e, { urlPatterns: r = [] } = {}) {
+  const s = globalThis.fetch, t = s.bind(globalThis);
+  return globalThis.fetch = async function(n, c = {}) {
+    const a = typeof n == "string" ? n : n.toString();
+    if (!(r.length === 0 || r.some((o) => a.includes(o))))
+      return t(n, c);
     const h = {
-      ...s.headers,
+      ...c.headers,
       ...e.getAuthHeaders()
     };
-    return c(n, { ...s, headers: h });
+    return t(n, { ...c, headers: h });
   }, function() {
-    globalThis.fetch = c;
+    globalThis.fetch = s;
   };
 }
 export {
-  d as createAuthFetch,
+  l as createAuthFetch,
   f as installInterceptor
 };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as f, a as u, b, c as A, d as P, e as h, D as I, E as x, G as g, f as w, I as m, M as p, O as k, P as v, g as T, h as B, i as y, R as C, j as E, S as R, k as S, T as F, l as M, m as L, n as G, U as O, V as U, Z as $ } from "./core-CC81ya-7.js";
+import { A as f, a as u, b as A, c as b, d as P, e as h, D as I, E as g, G as x, f as p, I as w, M as m, O as k, g as v, P as T, h as B, i as y, j as C, R as E, k as R, m as S, n as F, T as M, o as L, p as O, q as G, U, V as $, Z as D } from "./core-BIdNSA4o.js";
 const i = {
   variables: {
     colorBackground: "transparent",
@@ -27,34 +27,41 @@ const i = {
     formFieldErrorText: "text-red-300",
     formButtonPrimary: "bg-blue-600 hover:bg-blue-500 text-white",
     footerActionLink: "text-blue-400 hover:text-blue-300",
-    footer: "!bg-transparent",
+    // Clerk paints the footer with TWO stacked background-image layers, the
+    // second an opaque black linear-gradient — !bg-transparent only overrides
+    // background-COLOR, so !bg-none is required to kill the background-IMAGE
+    // and let the card show through. Verified against live DOM 2026-05-28.
+    footer: "!bg-transparent !bg-none",
     footerAction: "!bg-transparent",
-    badge: "hidden"
+    badge: "hidden",
+    // The "Last used" pill is cl-lastAuthenticationStrategyBadge, NOT cl-badge —
+    // the badge:'hidden' above never caught it. It also clips past the card edge.
+    lastAuthenticationStrategyBadge: "hidden"
   }
 };
-async function n(r, o = 8, a = 300) {
-  for (let e = 0; e < o; e += 1) {
+async function n(o, a = 8, r = 300) {
+  for (let e = 0; e < a; e += 1) {
     let t = null;
     try {
-      t = await r({ skipCache: !0 });
+      t = await o({ skipCache: !0 });
     } catch {
-      t = await r();
+      t = await o();
     }
     if (t) return t;
-    e < o - 1 && await new Promise((s) => setTimeout(s, a));
+    e < a - 1 && await new Promise((s) => setTimeout(s, r));
   }
   return null;
 }
 async function l({
-  apiBaseUrl: r,
-  getToken: o
+  apiBaseUrl: o,
+  getToken: a
 }) {
-  const a = await n(o);
-  if (!a)
+  const r = await n(a);
+  if (!r)
     throw new Error("Missing Clerk token after retries");
-  const e = await fetch(`${r}/auth/clerk/session`, {
+  const e = await fetch(`${o}/auth/clerk/session`, {
     method: "POST",
-    headers: { Authorization: `Bearer ${a}` },
+    headers: { Authorization: `Bearer ${r}` },
     credentials: "include"
   });
   if (!e.ok) {
@@ -70,33 +77,34 @@ async function l({
 export {
   f as APIError,
   u as AgentAPI,
-  b as AnalyticsAPI,
-  A as ArchiveAPI,
+  A as AnalyticsAPI,
+  b as ArchiveAPI,
   P as AuthAPI,
   h as AuthCore,
   i as CLERK_APPEARANCE,
   I as DecisionAPI,
-  x as EvolutionAPI,
-  g as GovernanceAPI,
-  w as GraphAPI,
-  m as InsightsAPI,
-  p as MemoryAPI,
+  g as EvolutionAPI,
+  x as GovernanceAPI,
+  p as GraphAPI,
+  w as InsightsAPI,
+  m as MemoryAPI,
   k as OntologyAPI,
-  v as PipelineAPI,
-  T as ProcedureCandidateAPI,
-  B as ProcedureMatchAPI,
-  y as ProfileAPI,
-  C as ReasoningAPI,
-  E as ReasoningTracesAPI,
-  R as SmartMemoryClient,
-  S as SubscriptionAPI,
-  F as TeamAPI,
-  M as TemporalAPI,
-  L as TokenManager,
+  v as OpinionAPI,
+  T as PipelineAPI,
+  B as ProcedureCandidateAPI,
+  y as ProcedureMatchAPI,
+  C as ProfileAPI,
+  E as ReasoningAPI,
+  R as ReasoningTracesAPI,
+  S as SmartMemoryClient,
+  F as SubscriptionAPI,
+  M as TeamAPI,
+  L as TemporalAPI,
+  O as TokenManager,
   G as TokenUsageAPI,
-  O as UsageAPI,
-  U as ValidationAPI,
-  $ as ZettelkastenAPI,
+  U as UsageAPI,
+  $ as ValidationAPI,
+  D as ZettelkastenAPI,
   l as exchangeClerkSession,
   n as getClerkTokenWithRetry
 };

package/dist/react.js

@@ -1,6 +1,6 @@
-import h, { createContext as d, useRef as y, useState as v, useEffect as b, useCallback as c, useContext as f } from "react";
-import { S as x } from "./core-CC81ya-7.js";
-const m = d(null), g = d(null);
+import h, { createContext as d, useRef as y, useState as v, useEffect as b, useCallback as c, useContext as m } from "react";
+import { m as x } from "./core-BIdNSA4o.js";
+const f = d(null), g = d(null);
 function U({ children: e, ...r }) {
   const n = y(null);
   n.current || (n.current = new x(r));
@@ -23,16 +23,16 @@ function U({ children: e, ...r }) {
   }), [t]);
   const s = c(async () => {
     await t.auth.logout();
-  }, [t]), A = c((i) => t.auth.hasRole(i), [t]), S = c((i) => t.auth.getLoginUrl(i), [t]), w = {
+  }, [t]), A = c((i) => t.auth.hasRole(i), [t]), w = c((i) => t.auth.getLoginUrl(i), [t]), S = {
     ...u,
     logout: s,
     hasRole: A,
-    getLoginUrl: S
+    getLoginUrl: w
   };
-  return /* @__PURE__ */ h.createElement(m.Provider, { value: w }, /* @__PURE__ */ h.createElement(g.Provider, { value: t }, e));
+  return /* @__PURE__ */ h.createElement(f.Provider, { value: S }, /* @__PURE__ */ h.createElement(g.Provider, { value: t }, e));
 }
 function l() {
-  const e = f(m);
+  const e = m(f);
   if (!e)
     throw new Error("useAuth must be used within a SmartMemoryProvider");
   return e;
@@ -46,7 +46,7 @@ function p() {
   return { login: e, logout: r, hasRole: n, getLoginUrl: t };
 }
 function E() {
-  const e = f(g);
+  const e = m(g);
   if (!e)
     throw new Error("useSmartMemory must be used within a SmartMemoryProvider");
   return e;
@@ -66,7 +66,7 @@ function I({ children: e, fallback: r = null, redirectToLogin: n = !1 }) {
   return e;
 }
 export {
-  m as AuthContext,
+  f as AuthContext,
   I as AuthWrapper,
   g as ClientContext,
   U as SmartMemoryProvider,

package/package.json

@@ -1,16 +1,31 @@
 {
   "name": "@smartmemory/sdk-js",
-  "version": "0.6.0",
+  "version": "0.6.4",
   "description": "Unified JavaScript SDK for SmartMemory API — auth + API client for all frontends",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
   "exports": {
-    ".": "./dist/index.js",
-    "./core": "./dist/core.js",
-    "./react": "./dist/react.js",
-    "./fetch": "./dist/fetch.js",
-    "./progress": "./dist/progress.js"
+    ".": {
+      "development": "./src/index.js",
+      "default": "./dist/index.js"
+    },
+    "./core": {
+      "development": "./src/core.js",
+      "default": "./dist/core.js"
+    },
+    "./react": {
+      "development": "./src/react/index.js",
+      "default": "./dist/react.js"
+    },
+    "./fetch": {
+      "development": "./src/fetch/index.js",
+      "default": "./dist/fetch.js"
+    },
+    "./progress": {
+      "development": "./src/progress.ts",
+      "default": "./dist/progress.js"
+    }
   },
   "files": [
     "dist"