@subcortex-ai/sdk 0.3.8 → 0.3.9

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

@@ -2058,16 +2058,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 +2118,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);
 }