@subcortex-ai/sdk 0.3.8 → 0.3.10

package/README.md

@@ -242,6 +242,27 @@ const subcortex = new SubCortexClient({
 })
 ```
 
+## Framework Integration
+
+### Next.js (App Router)
+
+Next.js patches `globalThis.fetch` with aggressive caching. GET requests — including assertion queries, user identification, and signal snapshots — will return stale data unless you bypass the cache. **This is critical for cognitive data that changes between sessions.**
+
+```typescript
+// app/api/my-agent/route.ts
+const noCacheFetch: typeof fetch = (input, init) =>
+  fetch(input, { ...init, cache: 'no-store' })
+
+const subcortex = new SubCortexClient({
+  endpoint: process.env.SUBCORTEX_ENDPOINT!,
+  tenantId: process.env.SUBCORTEX_TENANT_ID!,
+  apiKey: process.env.SUBCORTEX_API_KEY,
+  fetch: noCacheFetch, // ← Required in Next.js
+})
+```
+
+Without this, `users.identify()`, `assertions.query()`, and `signals.query()` may return cached results — meaning new assertions added between sessions (by other agents, users, or the SubCortex console) will be invisible until a hard page refresh.
+
 ## What is SubCortex?
 
 SubCortex is a purpose-built cognitive engine for AI agents — persistent memory, identity, emotional signals, and knowledge graph in one system.

package/dist/index.cjs

@@ -485,6 +485,7 @@ var OrgRelationship = /* @__PURE__ */ ((OrgRelationship2) => {
   OrgRelationship2["HAS_MEMBER"] = "has_member";
   OrgRelationship2["HOLDS_ROLE"] = "holds_role";
   OrgRelationship2["CANDIDATE_FOR"] = "candidate_for";
+  OrgRelationship2["CONSIDERING"] = "considering";
   OrgRelationship2["COLLABORATES_WITH"] = "collaborates_with";
   OrgRelationship2["MENTORS"] = "mentors";
   OrgRelationship2["MENTORED_BY"] = "mentored_by";
@@ -554,7 +555,8 @@ var REVERSE_RELATIONSHIPS = {
   ["mentors" /* MENTORS */]: "mentored_by" /* MENTORED_BY */,
   ["mentored_by" /* MENTORED_BY */]: "mentors" /* MENTORS */,
   ["collaborates_with" /* COLLABORATES_WITH */]: "collaborates_with" /* COLLABORATES_WITH */,
-  ["candidate_for" /* CANDIDATE_FOR */]: "candidate_for" /* CANDIDATE_FOR */,
+  ["candidate_for" /* CANDIDATE_FOR */]: "considering" /* CONSIDERING */,
+  ["considering" /* CONSIDERING */]: "candidate_for" /* CANDIDATE_FOR */,
   ["stakeholder_in" /* STAKEHOLDER_IN */]: "stakeholder_in" /* STAKEHOLDER_IN */,
   // Agent-facing predicate names → proper relationship types
   // The model sends 'direct_report' as predicate, SDK maps to proper relationships
@@ -856,13 +858,15 @@ var UsersNamespace = class {
     const nameAssertion = active.find((a) => a.predicate === "name" || a.predicate === "full_name");
     const name = nameAssertion?.value || input.displayName || null;
     const reminders = active.filter((a) => a.predicate === "reminder").map((a) => ({ id: a.id, predicate: a.predicate, value: a.value, confidence: a.confidence, createdAt: a.validFrom }));
-    for (const reminder of reminders) {
-      try {
-        await this.http.post(
-          `/api/v1/assertions/retract/${enc2(this.tenantId)}/${enc2(reminder.id)}`,
-          {}
-        );
-      } catch {
+    if (input.dismissReminders !== false) {
+      for (const reminder of reminders) {
+        try {
+          await this.http.post(
+            `/api/v1/assertions/retract/${enc2(this.tenantId)}/${enc2(reminder.id)}`,
+            {}
+          );
+        } catch {
+        }
       }
     }
     const contexts = active.filter((a) => a.predicate === "context" || a.predicate === "context:task").map((a) => ({ id: a.id, predicate: a.predicate, value: a.value, confidence: a.confidence, createdAt: a.validFrom }));
@@ -1053,7 +1057,7 @@ ${connectedPeople.map((p) => {
     const FORWARD_MAP = {
       "direct_report": "manages" /* MANAGES */,
       "team_member": "has_member" /* HAS_MEMBER */,
-      "candidate": "manages" /* MANAGES */,
+      "candidate": "considering" /* CONSIDERING */,
       "manager": "reports_to" /* REPORTS_TO */,
       "stakeholder": "stakeholder_in" /* STAKEHOLDER_IN */,
       "collaborator": "collaborates_with" /* COLLABORATES_WITH */,
@@ -1845,7 +1849,7 @@ var EntitiesNamespace = class {
       `/api/v1/assertions/query/${enc4(tenantId)}/${enc4(subject2)}`
     );
     const relationships = await this.http.get(
-      `/api/v1/relationships/query/${enc4(tenantId)}/${enc4(subject2)}`
+      `/api/v1/relationships/${enc4(tenantId)}/${enc4(subject2)}`
     );
     const typeAssertion = assertions.find((a) => a.predicate === "type" && !a.isSuperseded);
     const descAssertion = assertions.find((a) => a.predicate === "description" && !a.isSuperseded);
@@ -2058,16 +2062,25 @@ function toContextXml(user, options = {}) {
     if (knowledge.length > 0) {
       lines.push(`  <knowledge count="${knowledge.length}">`);
       for (const mem of knowledge) {
+        if (mem.predicate.startsWith("signal:")) {
+          const sigType = mem.predicate.slice(7);
+          const val = mem.value;
+          const content = typeof val === "object" && val?.content ? String(val.content) : formatValue(mem.value);
+          const intensity = typeof val === "object" && val?.intensity ? Number(val.intensity) : mem.confidence;
+          const about = typeof val === "object" && val?.aboutSubject ? ` about="${esc(String(val.aboutSubject))}"` : "";
+          lines.push(`    <signal type="${esc(sigType)}" intensity="${fmtConf(intensity)}"${about}>${esc(content)}</signal>`);
+          continue;
+        }
         const memSignals = findSignalsForFact(mem, signalsByAbout);
         if (memSignals.length > 0) {
           lines.push(`    <fact predicate="${esc(mem.predicate)}" confidence="${fmtConf(mem.confidence)}">`);
-          lines.push(`      ${esc(String(mem.value))}`);
+          lines.push(`      ${esc(formatValue(mem.value))}`);
           for (const sig of memSignals) {
             lines.push(`      ${renderSignal(sig)}`);
           }
           lines.push(`    </fact>`);
         } else {
-          lines.push(`    <fact predicate="${esc(mem.predicate)}" confidence="${fmtConf(mem.confidence)}">${esc(String(mem.value))}</fact>`);
+          lines.push(`    <fact predicate="${esc(mem.predicate)}" confidence="${fmtConf(mem.confidence)}">${esc(formatValue(mem.value))}</fact>`);
         }
       }
       lines.push(`  </knowledge>`);
@@ -2109,6 +2122,12 @@ function findSignalsForFact(fact, signalsByAbout) {
   }
   return results;
 }
+function formatValue(v) {
+  if (v === null || v === void 0) return "";
+  if (typeof v === "string") return v;
+  if (typeof v === "object" && "content" in v) return String(v.content);
+  return JSON.stringify(v);
+}
 function fmtConf(n) {
   return n.toFixed(2);
 }