@memorilabs/memori 0.0.5 → 0.0.7

package/README.md

@@ -166,7 +166,13 @@ export MEMORI_API_KEY=[api_key]
 
 ## Managing Your Quota
 
-You can check your quota and manage your account by logging in at [https://memorilabs.ai/](https://memorilabs.ai/). If you have reached your IP address quota, sign up and get an API key for increased limits.
+Any any time, you can check your quota using the Memori CLI:
+
+```bash
+memori quota
+```
+
+Or by checking your account by logging in at [https://memorilabs.ai/](https://memorilabs.ai/). If you have reached your IP address quota, sign up and get an API key for increased limits.
 
 If your API key exceeds its quota limits we will email you and let you know.
 

package/dist/engines/augmentation.d.ts

@@ -2,12 +2,15 @@ import { CallContext, LLMRequest, LLMResponse } from '@memorilabs/axon';
 import { Api } from '../core/network.js';
 import { Config } from '../core/config.js';
 import { SessionManager } from '../core/session.js';
+import { Trace } from '../types/integrations.js';
 export declare class AugmentationEngine {
     private readonly api;
     private readonly config;
     private readonly session;
     constructor(api: Api, config: Config, session: SessionManager);
+    private prepareAugmentationData;
     handleAugmentation(req: LLMRequest, res: LLMResponse, ctx: CallContext): Promise<LLMResponse>;
+    handleAgentAugmentation(req: LLMRequest, res: LLMResponse, ctx: CallContext, trace?: Trace | null, summary?: string | null): Promise<LLMResponse>;
     private buildMeta;
 }
 //# sourceMappingURL=augmentation.d.ts.map

package/dist/engines/augmentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"augmentation.d.ts","sourceRoot":"","sources":["../../src/engines/augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc;IAGnC,kBAAkB,CACvB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,WAAW,CAAC;IA0BvB,OAAO,CAAC,SAAS;CAuBlB"}
+{"version":3,"file":"augmentation.d.ts","sourceRoot":"","sources":["../../src/engines/augmentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc;IAG1C,OAAO,CAAC,uBAAuB;IAmBxB,kBAAkB,CACvB,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,WAAW,CAAC;IAkBhB,uBAAuB,CAC5B,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,WAAW,EAChB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,EACpB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,OAAO,CAAC,WAAW,CAAC;IAoBvB,OAAO,CAAC,SAAS;CAuBlB"}

package/dist/engines/augmentation.js

@@ -9,21 +9,31 @@ export class AugmentationEngine {
         this.config = config;
         this.session = session;
     }
-    handleAugmentation(req, res, ctx) {
+    prepareAugmentationData(req, res, ctx) {
         const sessionId = this.session.id;
         if (!sessionId)
-            return Promise.resolve(res);
+            return null;
         const lastUserMessage = extractLastUserMessage(req.messages);
         if (!lastUserMessage)
-            return Promise.resolve(res);
+            return null;
         const messages = [
             { role: 'user', content: lastUserMessage },
             { role: 'assistant', content: res.content },
         ];
-        const payload = {
-            conversation: { messages, summary: null },
+        return {
+            sessionId,
+            messages,
             meta: this.buildMeta(req, ctx),
-            session: { id: sessionId },
+        };
+    }
+    handleAugmentation(req, res, ctx) {
+        const data = this.prepareAugmentationData(req, res, ctx);
+        if (!data)
+            return Promise.resolve(res);
+        const payload = {
+            conversation: { messages: data.messages, summary: null },
+            meta: data.meta,
+            session: { id: data.sessionId },
         };
         // Fire-and-forget
         this.api.post('cloud/augmentation', payload).catch((e) => {
@@ -32,6 +42,24 @@ export class AugmentationEngine {
         });
         return Promise.resolve(res);
     }
+    handleAgentAugmentation(req, res, ctx, trace, summary) {
+        const data = this.prepareAugmentationData(req, res, ctx);
+        if (!data)
+            return Promise.resolve(res);
+        const payload = {
+            conversation: data.messages,
+            summary: summary || null,
+            trace: trace || null,
+            meta: data.meta,
+            session: { id: data.sessionId },
+        };
+        // Fire-and-forget to the dedicated agent endpoint
+        this.api.post('agent/augmentation', payload).catch((e) => {
+            if (this.config.testMode)
+                console.warn('Agent Augmentation failed:', e);
+        });
+        return Promise.resolve(res);
+    }
     buildMeta(req, ctx) {
         return {
             attribution: {

package/dist/engines/augmentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"augmentation.js","sourceRoot":"","sources":["../../src/engines/augmentation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,OAAO,kBAAkB;IAEV;IACA;IACA;IAHnB,YACmB,GAAQ,EACR,MAAc,EACd,OAAuB;QAFvB,QAAG,GAAH,GAAG,CAAK;QACR,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAgB;IACvC,CAAC;IAEG,kBAAkB,CACvB,GAAe,EACf,GAAgB,EAChB,GAAgB;QAEhB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE5C,MAAM,eAAe,GAAG,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,eAAe;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAElD,MAAM,QAAQ,GAAG;YACf,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE;YAC1C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;SAC5C,CAAC;QAEF,MAAM,OAAO,GAAG;YACd,YAAY,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACzC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;YAC9B,OAAO,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;SAC3B,CAAC;QAEF,kBAAkB;QAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;YAChE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEO,SAAS,CAAC,GAAe,EAAE,GAAgB;QACjD,OAAO;YACL,WAAW,EAAE;gBACX,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;gBACpC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;aACvC;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,qBAAqB,IAAI,WAAW,EAAE;YACvF,SAAS,EAAE,IAAI;YACf,GAAG,EAAE;gBACH,KAAK,EAAE;oBACL,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI;oBACvC,GAAG,EAAE;wBACH,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;qBACzC;oBACD,OAAO,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;iBAC3B;aACF;YACD,QAAQ,EAAE;gBACR,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI;aACxC;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"augmentation.js","sourceRoot":"","sources":["../../src/engines/augmentation.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,OAAO,kBAAkB;IAEV;IACA;IACA;IAHnB,YACmB,GAAQ,EACR,MAAc,EACd,OAAuB;QAFvB,QAAG,GAAH,GAAG,CAAK;QACR,WAAM,GAAN,MAAM,CAAQ;QACd,YAAO,GAAP,OAAO,CAAgB;IACvC,CAAC;IAEI,uBAAuB,CAAC,GAAe,EAAE,GAAgB,EAAE,GAAgB;QACjF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC;QAE5B,MAAM,eAAe,GAAG,sBAAsB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAElC,MAAM,QAAQ,GAAG;YACf,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE;YAC1C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE;SAC5C,CAAC;QAEF,OAAO;YACL,SAAS;YACT,QAAQ;YACR,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;SAC/B,CAAC;IACJ,CAAC;IAEM,kBAAkB,CACvB,GAAe,EACf,GAAgB,EAChB,GAAgB;QAEhB,MAAM,IAAI,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG;YACd,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;YACxD,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE;SAChC,CAAC;QAEF,kBAAkB;QAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;YAChE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEM,uBAAuB,CAC5B,GAAe,EACf,GAAgB,EAChB,GAAgB,EAChB,KAAoB,EACpB,OAAuB;QAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG;YACd,YAAY,EAAE,IAAI,CAAC,QAAQ;YAC3B,OAAO,EAAE,OAAO,IAAI,IAAI;YACxB,KAAK,EAAE,KAAK,IAAI,IAAI;YACpB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE;SAChC,CAAC;QAEF,kDAAkD;QAClD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAU,EAAE,EAAE;YAChE,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAAE,OAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAEO,SAAS,CAAC,GAAe,EAAE,GAAgB;QACjD,OAAO;YACL,WAAW,EAAE;gBACX,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;gBACpC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;aACvC;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,qBAAqB,IAAI,WAAW,EAAE;YACvF,SAAS,EAAE,IAAI;YACf,GAAG,EAAE;gBACH,KAAK,EAAE;oBACL,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI;oBACvC,GAAG,EAAE;wBACH,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,IAAI;qBACzC;oBACD,OAAO,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI;iBAC3B;aACF;YACD,QAAQ,EAAE;gBACR,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI;aACxC;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;CACF"}

package/dist/engines/recall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/engines/recall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAuB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlE,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc;IAG7B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmB5C,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAmEnF"}
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/engines/recall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQpD,OAAO,EAAuB,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElE,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc;IAG7B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmB5C,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA0EnF"}

package/dist/engines/recall.js

@@ -1,5 +1,4 @@
-import { extractFacts, extractHistory, stringifyContent } from '../utils/utils.js';
-import { extractLastUserMessage } from '../utils/utils.js';
+import { extractFacts, extractHistory, extractLastUserMessage, formatSummariesFromFacts, stringifyContent, } from '../utils/utils.js';
 export class RecallEngine {
     api;
     config;
@@ -65,13 +64,17 @@ export class RecallEngine {
             const dateSuffix = f.dateCreated ? `. Stated at ${f.dateCreated}` : '';
             return `- ${f.content}${dateSuffix}`;
         });
+        const relevantSummaries = formatSummariesFromFacts(facts.filter((f) => f.score >= this.config.recallRelevanceThreshold));
         let messages = [...req.messages];
         if (historyMessages.length > 0) {
             messages = [...historyMessages, ...messages];
         }
         if (relevantFacts.length > 0) {
-            const factList = relevantFacts.join('\n');
-            const recallContext = `\n\n<memori_context>\nOnly use the relevant context if it is relevant to the user's query. Relevant context about the user:\n${factList}\n</memori_context>`;
+            let contextBody = `Relevant context about the user:\n${relevantFacts.join('\n')}`;
+            if (relevantSummaries.length > 0) {
+                contextBody += `\n\n## Summaries\n\n${relevantSummaries.join('\n\n')}`;
+            }
+            const recallContext = `\n\n<memori_context>\nOnly use the relevant context if it is relevant to the user's query. ${contextBody}\n</memori_context>`;
             const systemIdx = messages.findIndex((m) => m.role === 'system');
             if (systemIdx >= 0) {
                 messages[systemIdx] = {

package/dist/engines/recall.js.map

@@ -1 +1 @@
-{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/engines/recall.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../src/engines/recall.ts"],"names":[],"mappings":"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"}

package/dist/integrations/base.d.ts

@@ -5,14 +5,15 @@ import { MemoriCore, IntegrationRequest } from '../types/integrations.js';
  * Provides common functionality for translating framework-specific data formats
  * (like OpenClaw messages) into Axon's internal LLM request/response format.
  *
- * This class is internal to the SDK - framework integrations should extend it
- * and implement their own public-facing methods.
- *
  * @internal
  */
 export declare abstract class BaseIntegration {
     protected readonly core: MemoriCore;
     constructor(core: MemoriCore);
+    /**
+     * Helper to construct Axon-compatible request payloads from the unified integration format.
+     */
+    private buildSyntheticPayload;
     /**
      * Internal helper: Captures a conversation turn by translating it into Axon format
      * and feeding it to both the Persistence and Augmentation engines.
@@ -21,6 +22,14 @@ export declare abstract class BaseIntegration {
      * @internal
      */
     protected executeAugmentation(req: IntegrationRequest): Promise<void>;
+    /**
+     * Internal helper: Captures an agentic conversation turn by translating it into Axon format
+     * and feeding it to both the Persistence and Augmentation engines, including tool traces.
+     *
+     * @param req - The unified integration message containing user text, agent text, trace, and metadata
+     * @internal
+     */
+    protected executeAgentAugmentation(req: IntegrationRequest): Promise<void>;
     /**
      * Internal helper: Recalls memories by translating the query into Axon format,
      * passing it through the Recall engine, and extracting the injected system prompt.

package/dist/integrations/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/integrations/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE1E;;;;;;;;;;GAUG;AACH,8BAAsB,eAAe;IACvB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU;gBAAhB,IAAI,EAAE,UAAU;IAE/C;;;;;;OAMG;cACa,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3E;;;;;;;OAOG;cACa,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAsBhF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/integrations/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE1E;;;;;;;GAOG;AACH,8BAAsB,eAAe;IACvB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU;gBAAhB,IAAI,EAAE,UAAU;IAE/C;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;;;;;OAMG;cACa,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAa3E;;;;;;OAMG;cACa,wBAAwB,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBhF;;;;;;;OAOG;cACa,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAsBhF"}

package/dist/integrations/base.js

@@ -4,9 +4,6 @@
  * Provides common functionality for translating framework-specific data formats
  * (like OpenClaw messages) into Axon's internal LLM request/response format.
  *
- * This class is internal to the SDK - framework integrations should extend it
- * and implement their own public-facing methods.
- *
  * @internal
  */
 export class BaseIntegration {
@@ -15,15 +12,9 @@ export class BaseIntegration {
         this.core = core;
     }
     /**
-     * Internal helper: Captures a conversation turn by translating it into Axon format
-     * and feeding it to both the Persistence and Augmentation engines.
-     *
-     * @param req - The unified integration message containing user text, agent text, and metadata
-     * @internal
+     * Helper to construct Axon-compatible request payloads from the unified integration format.
      */
-    async executeAugmentation(req) {
-        if (!this.core.session.id)
-            return;
+    buildSyntheticPayload(req) {
         const syntheticReq = {
             messages: [{ role: 'user', content: req.userMessage }],
             model: req.metadata?.model || '',
@@ -36,6 +27,19 @@ export class BaseIntegration {
             startedAt: new Date(),
             metadata: req.metadata,
         };
+        return { syntheticReq, syntheticRes, syntheticCtx };
+    }
+    /**
+     * Internal helper: Captures a conversation turn by translating it into Axon format
+     * and feeding it to both the Persistence and Augmentation engines.
+     *
+     * @param req - The unified integration message containing user text, agent text, and metadata
+     * @internal
+     */
+    async executeAugmentation(req) {
+        if (!this.core.session.id)
+            return;
+        const { syntheticReq, syntheticRes, syntheticCtx } = this.buildSyntheticPayload(req);
         try {
             await this.core.persistence.handlePersistence(syntheticReq, syntheticRes, syntheticCtx);
             await this.core.augmentation.handleAugmentation(syntheticReq, syntheticRes, syntheticCtx);
@@ -44,6 +48,25 @@ export class BaseIntegration {
             console.warn('Memori Integration Capture failed:', e);
         }
     }
+    /**
+     * Internal helper: Captures an agentic conversation turn by translating it into Axon format
+     * and feeding it to both the Persistence and Augmentation engines, including tool traces.
+     *
+     * @param req - The unified integration message containing user text, agent text, trace, and metadata
+     * @internal
+     */
+    async executeAgentAugmentation(req) {
+        if (!this.core.session.id)
+            return;
+        const { syntheticReq, syntheticRes, syntheticCtx } = this.buildSyntheticPayload(req);
+        try {
+            await this.core.persistence.handlePersistence(syntheticReq, syntheticRes, syntheticCtx);
+            await this.core.augmentation.handleAgentAugmentation(syntheticReq, syntheticRes, syntheticCtx, req.trace, req.summary);
+        }
+        catch (e) {
+            console.warn('Memori Integration Capture failed:', e);
+        }
+    }
     /**
      * Internal helper: Recalls memories by translating the query into Axon format,
      * passing it through the Recall engine, and extracting the injected system prompt.

package/dist/integrations/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/integrations/base.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,OAAgB,eAAe;IACJ;IAA/B,YAA+B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEnD;;;;;;OAMG;IACO,KAAK,CAAC,mBAAmB,CAAC,GAAuB;QACzD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO;QAElC,MAAM,YAAY,GAAe;YAC/B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;YACtD,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;SACjC,CAAC;QACF,MAAM,YAAY,GAAgB;YAChC,OAAO,EAAE,GAAG,CAAC,aAAa;SAC3B,CAAC;QAEF,MAAM,YAAY,GAAgB;YAChC,OAAO,EAAE,qBAAqB,IAAI,CAAC,GAAG,EAAE,EAAE;YAC1C,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE,GAAG,CAAC,QAA8C;SAC7D,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YACxF,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,kBAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;QAC5F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,oCAAoC,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED;;;;;;;OAOG;IACO,KAAK,CAAC,aAAa,CAAC,WAAmB;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QAE5C,MAAM,YAAY,GAAe;YAC/B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;SACnD,CAAC;QAEF,MAAM,YAAY,GAAgB;YAChC,OAAO,EAAE,qBAAqB,IAAI,CAAC,GAAG,EAAE,EAAE;YAC1C,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;YACnF,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;YACvE,OAAO,SAAS,EAAE,OAAO,CAAC;QAC5B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/integrations/base.ts"],"names":[],"mappings":"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"}

package/dist/integrations/openclaw.js

@@ -36,7 +36,7 @@ export class OpenClawIntegration extends BaseIntegration {
      * @throws Does not throw - errors are logged but swallowed to prevent disrupting the agent
      */
     async augmentation(req) {
-        await this.executeAugmentation(req);
+        await this.executeAgentAugmentation(req);
     }
     /**
      * Retrieves relevant memories for the given prompt and returns formatted context.

package/dist/integrations/openclaw.js.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../../src/integrations/openclaw.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD;;;;;;OAMG;IACI,cAAc,CAAC,QAAgB,EAAE,SAAkB;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACrC,IAAI,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,SAAiB;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,YAAY,CAAC,GAAuB;QAC/C,MAAM,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,MAAM,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;CACF"}
+{"version":3,"file":"openclaw.js","sourceRoot":"","sources":["../../src/integrations/openclaw.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD;;;;;;OAMG;IACI,cAAc,CAAC,QAAgB,EAAE,SAAkB;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACrC,IAAI,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACI,UAAU,CAAC,SAAiB;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,YAAY,CAAC,GAAuB;QAC/C,MAAM,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;OAOG;IACI,KAAK,CAAC,MAAM,CAAC,UAAkB;QACpC,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/types/api.d.ts

@@ -4,15 +4,27 @@
  * @internal
  */
 export interface RecallObject {
+    id: number;
     content: string;
     rank_score?: number;
     similarity?: number;
     date_created?: string;
+    summaries?: RecallSummary[];
 }
 /**
  * @internal
  */
 export type RecallItem = string | RecallObject;
+/**
+ * Represents a summary associated with a recalled fact.
+ * @internal
+ */
+export interface RecallSummary {
+    content: string;
+    date_created: string;
+    entity_fact_id: number;
+    fact_id: number;
+}
 /**
  * Raw response shape from the Memori Cloud API.
  * @internal
@@ -22,6 +34,7 @@ export interface CloudRecallResponse {
     results?: RecallItem[];
     memories?: RecallItem[];
     data?: RecallItem[];
+    summaries?: RecallSummary[];
     messages?: unknown[];
     conversation_messages?: unknown[];
     history?: unknown[];
@@ -47,5 +60,23 @@ export interface ParsedFact {
      * Undefined if the backend did not return temporal data.
      */
     dateCreated?: string;
+    /**
+     * Summaries associated with this fact, if provided by the backend.
+     */
+    summaries?: ParsedSummary[];
+}
+/**
+ * A normalized summary returned alongside a fact.
+ */
+export interface ParsedSummary {
+    /**
+     * The actual summary text.
+     */
+    content: string;
+    /**
+     * The ISO timestamp (YYYY-MM-DD HH:mm) when this summary was created.
+     * Undefined if the backend did not return temporal data.
+     */
+    dateCreated: string;
 }
 //# sourceMappingURL=api.d.ts.map

package/dist/types/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAElC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IAGpB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAElC,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAG5B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,EAAE,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/integrations.d.ts

@@ -16,6 +16,32 @@ export interface MemoriCore {
     config: Config;
     session: SessionManager;
 }
+/**
+ * Represents a single tool execution captured during an agent's conversation turn.
+ */
+export interface ToolCall {
+    /**
+     * The name of the tool or function executed by the agent.
+     */
+    name: string;
+    /**
+     * The arguments passed to the tool, parsed as a key-value record.
+     */
+    args: Record<string, unknown>;
+    /**
+     * The raw result returned by the tool execution.
+     */
+    result: unknown;
+}
+/**
+ * Represents an agentic execution trace containing tool calls made during a conversation turn.
+ */
+export interface Trace {
+    /**
+     * An ordered list of tool calls executed by the agent before its final response.
+     */
+    tools: ToolCall[];
+}
 /**
  * Represents a single turn of conversation to be captured by Memori.
  * This payload is used by framework integrations to send user and agent messages
@@ -36,6 +62,14 @@ export interface IntegrationRequest {
      * Optional telemetry and contextual metadata about the LLM execution.
      */
     metadata?: IntegrationMetadata;
+    /**
+     * Optional summary of the interaction turn.
+     */
+    summary?: string | null;
+    /**
+     * Optional agentic execution trace containing tool calls and their results.
+     */
+    trace?: Trace;
 }
 /**
  * Telemetry and execution metadata associated with a conversation turn.

package/dist/types/integrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/types/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,kBAAkB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEpC;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEjC;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEtC;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEjD;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,oBAAoB,IAAI,KAAK,IAAI,EAAE,UAAU,KAAK,CAAC,CAAC"}
+{"version":3,"file":"integrations.d.ts","sourceRoot":"","sources":["../../src/types/integrations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,kBAAkB,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,cAAc,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB;;OAEG;IACH,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEpC;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEjC;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEtC;;;OAGG;IACH,qBAAqB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAEjD;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,oBAAoB,IAAI,KAAK,IAAI,EAAE,UAAU,KAAK,CAAC,CAAC"}

package/dist/utils/utils.d.ts

@@ -2,6 +2,8 @@ import { Message } from '@memorilabs/axon';
 import { CloudRecallResponse, ParsedFact } from '../types/api.js';
 /** @internal */
 export declare function formatDate(dateStr?: string): string | undefined;
+/** @internal */
+export declare function formatSummariesFromFacts(facts: ParsedFact[]): string[];
 /**
  * Safely converts message content (string, array, or object) into a simple string.
  * Handles multi-modal arrays (e.g. OpenAI/Anthropic content blocks) by extracting text.

package/dist/utils/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElE,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAyBzD;AAED,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,UAAU,EAAE,CAuBxE;AAED,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,EAAE,CASvE;AAED,gBAAgB;AAChB,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAE9E"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EACL,mBAAmB,EACnB,UAAU,EAIX,MAAM,iBAAiB,CAAC;AAEzB,gBAAgB;AAChB,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS/D;AAqBD,gBAAgB;AAChB,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAItE;AAuCD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAyBzD;AAED,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,UAAU,EAAE,CA+BxE;AAED,gBAAgB;AAChB,wBAAgB,cAAc,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,EAAE,CASvE;AAED,gBAAgB;AAChB,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,GAAG,SAAS,CAE9E"}

package/dist/utils/utils.js

@@ -12,6 +12,58 @@ export function formatDate(dateStr) {
         return undefined;
     }
 }
+function collectSummariesFromFacts(facts) {
+    const summaries = [];
+    const seen = new Set();
+    for (const fact of facts) {
+        if (!fact.summaries)
+            continue;
+        for (const summary of fact.summaries) {
+            const key = `${summary.content}::${summary.dateCreated}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            summaries.push(summary);
+        }
+    }
+    return summaries;
+}
+/** @internal */
+export function formatSummariesFromFacts(facts) {
+    return collectSummariesFromFacts(facts).map((summary) => `- [${summary.dateCreated}]\n  ${summary.content}`);
+}
+function attachRawSummariesToFacts(facts, summaries) {
+    if (summaries.length === 0)
+        return facts;
+    const summariesByFactId = new Map();
+    for (const summary of summaries) {
+        const summaryFactId = summary.entity_fact_id;
+        const existing = summariesByFactId.get(summaryFactId) ?? [];
+        existing.push(summary);
+        summariesByFactId.set(summaryFactId, existing);
+    }
+    return facts.map((fact) => {
+        if (typeof fact === 'string')
+            return fact;
+        const matchedSummaries = summariesByFactId.get(fact.id) ?? [];
+        const existingSummaries = fact.summaries ?? [];
+        if (existingSummaries.length === 0 && matchedSummaries.length === 0)
+            return fact;
+        return {
+            ...fact,
+            summaries: [...existingSummaries, ...matchedSummaries],
+        };
+    });
+}
+function normalizeSummary(summary) {
+    const dateCreated = formatDate(summary.date_created);
+    if (!dateCreated)
+        return undefined;
+    return {
+        content: summary.content,
+        dateCreated,
+    };
+}
 /**
  * Safely converts message content (string, array, or object) into a simple string.
  * Handles multi-modal arrays (e.g. OpenAI/Anthropic content blocks) by extracting text.
@@ -45,11 +97,13 @@ export function stringifyContent(content) {
 }
 /** @internal */
 export function extractFacts(response) {
-    const raw = response.facts || response.results || response.memories || response.data || [];
-    if (!Array.isArray(raw))
+    const rawFacts = response.facts || response.results || response.memories || response.data || [];
+    const rawSummaries = response.summaries ?? [];
+    if (!Array.isArray(rawFacts))
         return [];
+    const factsWithSummaries = attachRawSummariesToFacts(rawFacts, rawSummaries);
     const facts = [];
-    for (const item of raw) {
+    for (const item of factsWithSummaries) {
         if (typeof item === 'string') {
             facts.push({ content: item, score: 1.0 });
         }
@@ -59,10 +113,14 @@ export function extractFacts(response) {
                 score = item.rank_score;
             else if (typeof item.similarity === 'number')
                 score = item.similarity;
+            const summaries = item.summaries
+                ?.map(normalizeSummary)
+                .filter((summary) => summary !== undefined);
             facts.push({
                 content: item.content,
                 score,
                 dateCreated: formatDate(item.date_created),
+                summaries: summaries && summaries.length > 0 ? summaries : undefined,
             });
         }
     }

package/dist/utils/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "0.0.5";
+export declare const SDK_VERSION = "0.0.7";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const SDK_VERSION = '0.0.5';
+export const SDK_VERSION = '0.0.7';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorilabs/memori",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "The official TypeScript SDK for Memori",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,6 +37,7 @@
     "check": "npm run format:check && npm run lint && npm run typecheck",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
+    "test:integration": "TEST_ENV=integration vitest run",
     "example": "npm run build:dev && node dist/examples/cloud/simple.js",
     "prepublishOnly": "npm run build"
   },
@@ -64,6 +65,7 @@
   "homepage": "https://github.com/MemoriLabs/Memori",
   "peerDependencies": {
     "@anthropic-ai/sdk": "*",
+    "@google/genai": "*",
     "openai": "*"
   },
   "peerDependenciesMeta": {
@@ -72,11 +74,15 @@
     },
     "@anthropic-ai/sdk": {
       "optional": true
+    },
+    "@google/genai": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@anthropic-ai/sdk": "*",
     "@eslint/js": "^9.0.0",
+    "@google/genai": "*",
     "@types/node": "^20.0.0",
     "@vitest/coverage-v8": "^2.1.9",
     "@vitest/ui": "^2.1.9",
@@ -95,6 +101,6 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@memorilabs/axon": "^0.1.2"
+    "@memorilabs/axon": "^0.1.3"
   }
 }