@memorilabs/memori 0.0.6 → 0.0.8

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: { messages: 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":"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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/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/version.d.ts

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

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memorilabs/memori",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "The official TypeScript SDK for Memori",
   "type": "module",
   "main": "./dist/index.js",