@mrc2204/agent-smart-memo 4.1.2 → 5.0.0

package/dist/core/runtime-boundary.d.ts

@@ -0,0 +1,23 @@
+export interface MemoryRuntimeConfig {
+    stateDir: string;
+    slotDbDir: string;
+}
+export declare function createInitialRuntimeConfig(): MemoryRuntimeConfig;
+export declare function resolveSlotDbDirForContext(ctx: any, runtimeConfig: MemoryRuntimeConfig): string;
+export declare function parseSessionIdentity(sessionKey?: string): {
+    userId: string;
+    agentId: string;
+};
+export declare function createToolTextResult(text: string, isError?: boolean): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    details: {
+        toolResult: {
+            text: string;
+        };
+    };
+    isError: boolean;
+};
+//# sourceMappingURL=runtime-boundary.d.ts.map

package/dist/core/runtime-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-boundary.d.ts","sourceRoot":"","sources":["../../src/core/runtime-boundary.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,CAUhE;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,GAAG,EACR,aAAa,EAAE,mBAAmB,GACjC,MAAM,CASR;AAED,wBAAgB,oBAAoB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB,CASA;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,UAAQ;;;;;;;;;;;EAMjE"}

package/dist/core/runtime-boundary.js

@@ -0,0 +1,39 @@
+import { resolveSlotDbDir } from "../shared/slotdb-path.js";
+export function createInitialRuntimeConfig() {
+    const stateDir = process.env.OPENCLAW_STATE_DIR || `${process.env.HOME}/.openclaw`;
+    return {
+        stateDir,
+        slotDbDir: resolveSlotDbDir({
+            stateDir,
+            env: process.env,
+            homeDir: process.env.HOME,
+        }),
+    };
+}
+export function resolveSlotDbDirForContext(ctx, runtimeConfig) {
+    const stateDir = ctx?.stateDir || runtimeConfig.stateDir;
+    const configSlotDbDir = ctx?.pluginConfig?.slotDbDir || ctx?.config?.slotDbDir;
+    return resolveSlotDbDir({
+        stateDir,
+        slotDbDir: configSlotDbDir,
+        env: process.env,
+        homeDir: process.env.HOME,
+    });
+}
+export function parseSessionIdentity(sessionKey) {
+    const normalized = typeof sessionKey === "string" && sessionKey.trim().length > 0
+        ? sessionKey.trim()
+        : "agent:main:default";
+    const parts = normalized.split(":");
+    const agentId = parts.length >= 2 ? parts[1] : "main";
+    const userId = parts.length >= 3 ? parts.slice(2).join(":") : "default";
+    return { userId, agentId };
+}
+export function createToolTextResult(text, isError = false) {
+    return {
+        content: [{ type: "text", text }],
+        details: { toolResult: { text } },
+        isError,
+    };
+}
+//# sourceMappingURL=runtime-boundary.js.map

package/dist/core/runtime-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-boundary.js","sourceRoot":"","sources":["../../src/core/runtime-boundary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAO5D,MAAM,UAAU,0BAA0B;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,YAAY,CAAC;IACnF,OAAO;QACL,QAAQ;QACR,SAAS,EAAE,gBAAgB,CAAC;YAC1B,QAAQ;YACR,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI;SAC1B,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,GAAQ,EACR,aAAkC;IAElC,MAAM,QAAQ,GAAG,GAAG,EAAE,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC;IACzD,MAAM,eAAe,GAAG,GAAG,EAAE,YAAY,EAAE,SAAS,IAAI,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC;IAC/E,OAAO,gBAAgB,CAAC;QACtB,QAAQ;QACR,SAAS,EAAE,eAAe;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IAItD,MAAM,UAAU,GAAG,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;QAC/E,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE;QACnB,CAAC,CAAC,oBAAoB,CAAC;IAEzB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAO,GAAG,KAAK;IAChE,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC;QAC1C,OAAO,EAAE,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE;QACjC,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/core/usecases/default-memory-usecase-port.d.ts

@@ -0,0 +1,21 @@
+import type { CoreRequestEnvelope, MemoryUseCaseName, MemoryUseCasePort } from "../contracts/adapter-contracts.js";
+import { SlotDB } from "../../db/slot-db.js";
+import type { SemanticMemoryUseCase } from "./semantic-memory-usecase.js";
+export declare class DefaultMemoryUseCasePort implements MemoryUseCasePort {
+    private readonly slotDb;
+    private readonly semanticUseCase?;
+    constructor(slotDb: SlotDB, semanticUseCase?: SemanticMemoryUseCase | undefined);
+    run<TReq, TRes>(useCase: MemoryUseCaseName, req: CoreRequestEnvelope<TReq>): Promise<TRes>;
+    private handleSlotGet;
+    private handleSlotSet;
+    private handleSlotList;
+    private handleSlotDelete;
+    private handleGraphEntityGet;
+    private handleGraphEntitySet;
+    private handleGraphRelAdd;
+    private handleGraphRelRemove;
+    private handleMemoryCapture;
+    private handleMemorySearch;
+    private handleGraphSearch;
+}
+//# sourceMappingURL=default-memory-usecase-port.d.ts.map

package/dist/core/usecases/default-memory-usecase-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-memory-usecase-port.d.ts","sourceRoot":"","sources":["../../../src/core/usecases/default-memory-usecase-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AA2G1E,qBAAa,wBAAyB,YAAW,iBAAiB;IAE9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;gBADhB,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,qBAAqB,YAAA;IAGpD,GAAG,CAAC,IAAI,EAAE,IAAI,EAClB,OAAO,EAAE,iBAAiB,EAC1B,GAAG,EAAE,mBAAmB,CAAC,IAAI,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IA+BhB,OAAO,CAAC,aAAa;IAqDrB,OAAO,CAAC,aAAa;IAsBrB,OAAO,CAAC,cAAc;IA6BtB,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,oBAAoB;IA0B5B,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,oBAAoB;YAuBd,mBAAmB;YAOnB,kBAAkB;IAOhC,OAAO,CAAC,iBAAiB;CAmB1B"}

package/dist/core/usecases/default-memory-usecase-port.js

@@ -0,0 +1,263 @@
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+function normalizePrivateIdentity(ctx) {
+    return {
+        userId: ctx.userId || "default",
+        agentId: ctx.agentId || "assistant",
+        scope: "private",
+    };
+}
+function scopeToIdentity(ctx, scope) {
+    const base = normalizePrivateIdentity(ctx);
+    if (scope === "team") {
+        return { userId: base.userId, agentId: "__team__", scope: "team" };
+    }
+    if (scope === "public") {
+        return { userId: "__public__", agentId: "__public__", scope: "public" };
+    }
+    return base;
+}
+function allScopeIdentities(ctx) {
+    const base = normalizePrivateIdentity(ctx);
+    return [
+        base,
+        { userId: base.userId, agentId: "__team__", scope: "team" },
+        { userId: "__public__", agentId: "__public__", scope: "public" },
+    ];
+}
+export class DefaultMemoryUseCasePort {
+    slotDb;
+    semanticUseCase;
+    constructor(slotDb, semanticUseCase) {
+        this.slotDb = slotDb;
+        this.semanticUseCase = semanticUseCase;
+    }
+    async run(useCase, req) {
+        const payload = asRecord(req.payload);
+        switch (useCase) {
+            case "slot.get":
+                return this.handleSlotGet(payload, req);
+            case "slot.set":
+                return this.handleSlotSet(payload, req);
+            case "slot.list":
+                return this.handleSlotList(payload, req);
+            case "slot.delete":
+                return this.handleSlotDelete(payload, req);
+            case "graph.entity.get":
+                return this.handleGraphEntityGet(payload, req);
+            case "graph.entity.set":
+                return this.handleGraphEntitySet(payload, req);
+            case "graph.rel.add":
+                return this.handleGraphRelAdd(payload, req);
+            case "graph.rel.remove":
+                return this.handleGraphRelRemove(payload, req);
+            case "graph.search":
+                return this.handleGraphSearch(payload, req);
+            case "memory.capture":
+                return this.handleMemoryCapture(payload, req);
+            case "memory.search":
+                return this.handleMemorySearch(payload, req);
+            default:
+                throw new Error(`Unsupported use-case: ${useCase}`);
+        }
+    }
+    handleSlotGet(payload, req) {
+        if (payload.scope === "all") {
+            const rows = allScopeIdentities(req.context).flatMap((identity) => {
+                const result = this.slotDb.get(identity.userId, identity.agentId, {
+                    key: payload.key,
+                    category: payload.category,
+                });
+                if (!result)
+                    return [];
+                const list = Array.isArray(result) ? result : [result];
+                return list.map((slot) => ({
+                    key: slot.key,
+                    value: slot.value,
+                    category: slot.category,
+                    version: slot.version,
+                    scope: identity.scope,
+                }));
+            });
+            if (payload.key) {
+                return rows.length > 0 ? rows[0] : null;
+            }
+            return rows;
+        }
+        const identity = scopeToIdentity(req.context, payload.scope);
+        const result = this.slotDb.get(identity.userId, identity.agentId, {
+            key: payload.key,
+            category: payload.category,
+        });
+        if (!result)
+            return null;
+        if (Array.isArray(result)) {
+            return result.map((slot) => ({
+                key: slot.key,
+                value: slot.value,
+                category: slot.category,
+                version: slot.version,
+                scope: identity.scope,
+            }));
+        }
+        return {
+            key: result.key,
+            value: result.value,
+            category: result.category,
+            version: result.version,
+            scope: identity.scope,
+        };
+    }
+    handleSlotSet(payload, req) {
+        if (!payload.key || typeof payload.key !== "string") {
+            throw new Error("slot.set requires payload.key");
+        }
+        const identity = scopeToIdentity(req.context, payload.scope);
+        const slot = this.slotDb.set(identity.userId, identity.agentId, {
+            key: payload.key,
+            value: payload.value,
+            category: payload.category,
+            source: payload.source || "tool",
+        });
+        return {
+            key: slot.key,
+            value: slot.value,
+            category: slot.category,
+            version: slot.version,
+            scope: identity.scope,
+        };
+    }
+    handleSlotList(payload, req) {
+        if (payload.scope === "all" || !payload.scope) {
+            return allScopeIdentities(req.context).flatMap((identity) => this.slotDb.list(identity.userId, identity.agentId, {
+                category: payload.category,
+                prefix: payload.prefix,
+            }).map((slot) => ({
+                key: slot.key,
+                value: slot.value,
+                category: slot.category,
+                version: slot.version,
+                scope: identity.scope,
+            })));
+        }
+        const identity = scopeToIdentity(req.context, payload.scope);
+        return this.slotDb.list(identity.userId, identity.agentId, {
+            category: payload.category,
+            prefix: payload.prefix,
+        }).map((slot) => ({
+            key: slot.key,
+            value: slot.value,
+            category: slot.category,
+            version: slot.version,
+            scope: identity.scope,
+        }));
+    }
+    handleSlotDelete(payload, req) {
+        if (!payload.key || typeof payload.key !== "string") {
+            throw new Error("slot.delete requires payload.key");
+        }
+        const identity = scopeToIdentity(req.context, payload.scope);
+        return {
+            key: payload.key,
+            deleted: this.slotDb.delete(identity.userId, identity.agentId, payload.key),
+            scope: identity.scope,
+        };
+    }
+    handleGraphEntityGet(payload, req) {
+        const identity = normalizePrivateIdentity(req.context);
+        if (payload.id) {
+            return this.slotDb.graph.getEntity(identity.userId, identity.agentId, payload.id);
+        }
+        return this.slotDb.graph.listEntities(identity.userId, identity.agentId, {
+            type: payload.type,
+            name: payload.name,
+        });
+    }
+    handleGraphEntitySet(payload, req) {
+        const identity = normalizePrivateIdentity(req.context);
+        if (!payload.name || !payload.type) {
+            throw new Error("graph.entity.set requires payload.name and payload.type");
+        }
+        if (payload.id) {
+            const updated = this.slotDb.graph.updateEntity(identity.userId, identity.agentId, payload.id, {
+                name: payload.name,
+                type: payload.type,
+                properties: payload.properties,
+            });
+            if (!updated) {
+                throw new Error(`Entity with ID '${payload.id}' not found`);
+            }
+            return updated;
+        }
+        return this.slotDb.graph.createEntity(identity.userId, identity.agentId, {
+            name: payload.name,
+            type: payload.type,
+            properties: payload.properties,
+        });
+    }
+    handleGraphRelAdd(payload, req) {
+        const identity = normalizePrivateIdentity(req.context);
+        if (!payload.source_id || !payload.target_id || !payload.relation_type) {
+            throw new Error("graph.rel.add requires source_id, target_id, relation_type");
+        }
+        const source = this.slotDb.graph.getEntity(identity.userId, identity.agentId, payload.source_id);
+        if (!source)
+            throw new Error(`Source entity '${payload.source_id}' not found`);
+        const target = this.slotDb.graph.getEntity(identity.userId, identity.agentId, payload.target_id);
+        if (!target)
+            throw new Error(`Target entity '${payload.target_id}' not found`);
+        return this.slotDb.graph.createRelationship(identity.userId, identity.agentId, {
+            source_entity_id: payload.source_id,
+            target_entity_id: payload.target_id,
+            relation_type: payload.relation_type,
+            weight: payload.weight,
+            properties: payload.properties,
+        });
+    }
+    handleGraphRelRemove(payload, req) {
+        const identity = normalizePrivateIdentity(req.context);
+        if (payload.id) {
+            return { deleted: this.slotDb.graph.deleteRelationship(identity.userId, identity.agentId, payload.id) };
+        }
+        if (!payload.source_id || !payload.target_id || !payload.relation_type) {
+            throw new Error("graph.rel.remove requires id OR source_id + target_id + relation_type");
+        }
+        const rels = this.slotDb.graph.getRelationships(identity.userId, identity.agentId, payload.source_id, "outgoing");
+        const rel = rels.find((item) => item.target_entity_id === payload.target_id && item.relation_type === payload.relation_type);
+        if (!rel) {
+            return { deleted: false };
+        }
+        return { deleted: this.slotDb.graph.deleteRelationship(identity.userId, identity.agentId, rel.id) };
+    }
+    async handleMemoryCapture(payload, req) {
+        if (!this.semanticUseCase) {
+            throw new Error("memory.capture is not available: semantic runtime dependencies are not wired");
+        }
+        return this.semanticUseCase.capture(payload, req.context);
+    }
+    async handleMemorySearch(payload, req) {
+        if (!this.semanticUseCase) {
+            throw new Error("memory.search is not available: semantic runtime dependencies are not wired");
+        }
+        return this.semanticUseCase.search(payload, req.context);
+    }
+    handleGraphSearch(payload, req) {
+        const identity = normalizePrivateIdentity(req.context);
+        if (!payload.entity_id) {
+            throw new Error("graph.search requires entity_id");
+        }
+        const depth = Math.min(Math.max(payload.depth || 2, 1), 3);
+        const traversed = this.slotDb.graph.traverseGraph(identity.userId, identity.agentId, payload.entity_id, depth);
+        if (!payload.relation_type) {
+            return traversed;
+        }
+        return {
+            entities: traversed.entities,
+            relationships: traversed.relationships.filter((rel) => rel.relation_type === payload.relation_type),
+        };
+    }
+}
+//# sourceMappingURL=default-memory-usecase-port.js.map

package/dist/core/usecases/default-memory-usecase-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-memory-usecase-port.js","sourceRoot":"","sources":["../../../src/core/usecases/default-memory-usecase-port.ts"],"names":[],"mappings":"AAyEA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,wBAAwB,CAAC,GAAwC;IACxE,OAAO;QACL,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,SAAS;QAC/B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,WAAW;QACnC,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,GAAwC,EACxC,KAAgD;IAEhD,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAE3C,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAwC;IAClE,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO;QACL,IAAI;QACJ,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE;QAC3D,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE;KACjE,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,wBAAwB;IAEhB;IACA;IAFnB,YACmB,MAAc,EACd,eAAuC;QADvC,WAAM,GAAN,MAAM,CAAQ;QACd,oBAAe,GAAf,eAAe,CAAwB;IACvD,CAAC;IAEJ,KAAK,CAAC,GAAG,CACP,OAA0B,EAC1B,GAA8B;QAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEtC,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,aAAa,CAAC,OAAoC,EAAE,GAAG,CAAS,CAAC;YAC/E,KAAK,UAAU;gBACb,OAAO,IAAI,CAAC,aAAa,CAAC,OAAoC,EAAE,GAAG,CAAS,CAAC;YAC/E,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,cAAc,CAAC,OAAqC,EAAE,GAAG,CAAS,CAAC;YACjF,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC,OAAuC,EAAE,GAAG,CAAS,CAAC;YACrF,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAA2C,EAAE,GAAG,CAAS,CAAC;YAC7F,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAA2C,EAAE,GAAG,CAAS,CAAC;YAC7F,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAwC,EAAE,GAAG,CAAS,CAAC;YACvF,KAAK,kBAAkB;gBACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC,OAA2C,EAAE,GAAG,CAAS,CAAC;YAC7F,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAwC,EAAE,GAAG,CAAS,CAAC;YACvF,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAS,CAAC;YACxD,KAAK,eAAe;gBAClB,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,GAAG,CAAS,CAAC;YACvD;gBACE,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,EAAE,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAuB,EAAE,GAAiC;QAC9E,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;gBAChE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;oBAChE,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;iBAC3B,CAAC,CAAC;gBAEH,IAAI,CAAC,MAAM;oBAAE,OAAO,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBACvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;oBACzB,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;iBACtB,CAAC,CAAC,CAAC;YACN,CAAC,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC1C,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;YAChE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;aACtB,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO;YACL,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IAEO,aAAa,CAAC,OAAuB,EAAE,GAAiC;QAC9E,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;YAC9D,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM;SACjC,CAAC,CAAC;QAEH,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,OAAwB,EAAE,GAAiC;QAChF,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC9C,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAC1D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;gBAClD,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;aACvB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAChB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;aACtB,CAAC,CAAC,CACJ,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;YACzD,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,gBAAgB,CAAC,OAA0B,EAAE,GAAiC;QACpF,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7D,OAAO;YACL,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC;YAC3E,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;IAEO,oBAAoB,CAAC,OAA8B,EAAE,GAAiC;QAC5F,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvD,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;YACvE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;IAEO,oBAAoB,CAAC,OAA8B,EAAE,GAAiC;QAC5F,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvD,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,EAAE;gBAC5F,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,mBAAmB,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC;YAC9D,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;YACvE,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,OAA2B,EAAE,GAAiC;QACtF,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACjG,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,SAAS,aAAa,CAAC,CAAC;QAE/E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACjG,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,SAAS,aAAa,CAAC,CAAC;QAE/E,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;YAC7E,gBAAgB,EAAE,OAAO,CAAC,SAAS;YACnC,gBAAgB,EAAE,OAAO,CAAC,SAAS;YACnC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;IACL,CAAC;IAEO,oBAAoB,CAAC,OAA8B,EAAE,GAAiC;QAC5F,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvD,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1G,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;QAC3F,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAClH,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CACnB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,KAAK,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,aAAa,KAAK,OAAO,CAAC,aAAa,CACtG,CAAC;QAEF,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC5B,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;IACtG,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAAC,OAAgC,EAAE,GAAiC;QACnG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,OAAc,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,OAAgC,EAAE,GAAiC;QAClG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAc,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IAEO,iBAAiB,CAAC,OAA2B,EAAE,GAAiC;QACtF,MAAM,QAAQ,GAAG,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAE/G,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,aAAa,EAAE,SAAS,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC;SACpG,CAAC;IACJ,CAAC;CACF"}

package/dist/core/usecases/semantic-memory-usecase.d.ts

@@ -0,0 +1,52 @@
+import type { QdrantClient } from "../../services/qdrant.js";
+import type { EmbeddingClient } from "../../services/embedding.js";
+import type { DeduplicationService } from "../../services/dedupe.js";
+import type { MemoryContext } from "../contracts/adapter-contracts.js";
+import { type MemoryNamespace } from "../../shared/memory-config.js";
+export interface MemoryCapturePayload {
+    text: string;
+    namespace?: string;
+    sessionId?: string;
+    userId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface MemorySearchPayload {
+    query: string;
+    limit?: number;
+    minScore?: number;
+    namespace?: string;
+    sessionId?: string;
+    userId?: string;
+    sourceAgent?: string;
+}
+export interface MemoryCaptureResult {
+    id: string;
+    created: boolean;
+    updated: boolean;
+    namespace: MemoryNamespace;
+    score?: number;
+}
+export interface MemorySearchResult {
+    query: string;
+    count: number;
+    results: Array<{
+        id: string;
+        score: number;
+        rawScore: number;
+        text: string;
+        namespace: string;
+        timestamp?: number;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+export declare class SemanticMemoryUseCase {
+    private readonly qdrant;
+    private readonly embedding;
+    private readonly dedupe;
+    constructor(qdrant: QdrantClient, embedding: EmbeddingClient, dedupe: DeduplicationService);
+    capture(payload: MemoryCapturePayload, context: MemoryContext): Promise<MemoryCaptureResult>;
+    search(payload: MemorySearchPayload, context: MemoryContext): Promise<MemorySearchResult>;
+    private resolveNamespace;
+    private embedDetailedCompat;
+}
+//# sourceMappingURL=semantic-memory-usecase.d.ts.map

package/dist/core/usecases/semantic-memory-usecase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-memory-usecase.d.ts","sourceRoot":"","sources":["../../../src/core/usecases/semantic-memory-usecase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AACvE,OAAO,EAA+E,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAGlJ,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;CACJ;AAED,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,oBAAoB;IAGzC,OAAO,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAmD5F,MAAM,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiE/F,OAAO,CAAC,gBAAgB;YAOV,mBAAmB;CAmBlC"}

package/dist/core/usecases/semantic-memory-usecase.js

@@ -0,0 +1,136 @@
+import { getAgentNamespaces, getNamespaceWeight, parseExplicitNamespace, toCoreAgent } from "../../shared/memory-config.js";
+export class SemanticMemoryUseCase {
+    qdrant;
+    embedding;
+    dedupe;
+    constructor(qdrant, embedding, dedupe) {
+        this.qdrant = qdrant;
+        this.embedding = embedding;
+        this.dedupe = dedupe;
+    }
+    async capture(payload, context) {
+        if (!payload?.text || typeof payload.text !== "string" || payload.text.trim().length === 0) {
+            throw new Error("memory.capture requires payload.text");
+        }
+        const text = payload.text.trim();
+        const sourceAgent = toCoreAgent(context.agentId || "assistant");
+        const namespace = this.resolveNamespace(payload.namespace, sourceAgent);
+        const embeddingResult = await this.embedDetailedCompat(text);
+        const vector = embeddingResult.vector;
+        const existing = await this.qdrant.search(vector, 5, {
+            must: [{ key: "namespace", match: { value: namespace } }],
+        });
+        const duplicateId = this.dedupe.findDuplicate(text, existing);
+        const id = duplicateId || crypto.randomUUID();
+        const now = Date.now();
+        await this.qdrant.upsert([
+            {
+                id,
+                vector,
+                payload: {
+                    text,
+                    namespace,
+                    agent: sourceAgent,
+                    source_agent: sourceAgent,
+                    source_type: "manual",
+                    sessionId: payload.sessionId || context.sessionId || null,
+                    userId: payload.userId || context.userId || null,
+                    metadata: {
+                        ...(payload.metadata || {}),
+                        ...embeddingResult.metadata,
+                    },
+                    ...embeddingResult.metadata,
+                    timestamp: now,
+                    ...(duplicateId ? { updatedAt: now } : {}),
+                },
+            },
+        ]);
+        return {
+            id,
+            created: !duplicateId,
+            updated: Boolean(duplicateId),
+            namespace,
+        };
+    }
+    async search(payload, context) {
+        if (!payload?.query || typeof payload.query !== "string" || payload.query.trim().length === 0) {
+            throw new Error("memory.search requires payload.query");
+        }
+        const query = payload.query.trim();
+        const sourceAgent = toCoreAgent(context.agentId || "assistant");
+        const minScore = typeof payload.minScore === "number" ? payload.minScore : 0.7;
+        const limit = Math.min(Math.max(payload.limit || 5, 1), 20);
+        const namespaces = payload.namespace
+            ? [this.resolveNamespace(payload.namespace, sourceAgent)]
+            : getAgentNamespaces(sourceAgent);
+        const namespaceFilter = namespaces.length === 1
+            ? namespaces[0]
+            : null;
+        const filterMust = [];
+        if (namespaceFilter) {
+            filterMust.push({ key: "namespace", match: { value: namespaceFilter } });
+        }
+        else {
+            filterMust.push({ should: namespaces.map((ns) => ({ key: "namespace", match: { value: ns } })) });
+        }
+        if (payload.sessionId || context.sessionId) {
+            filterMust.push({ key: "sessionId", match: { value: payload.sessionId || context.sessionId } });
+        }
+        if (payload.userId || context.userId) {
+            filterMust.push({ key: "userId", match: { value: payload.userId || context.userId } });
+        }
+        if (payload.sourceAgent) {
+            filterMust.push({ key: "source_agent", match: { value: payload.sourceAgent } });
+        }
+        const vector = await this.embedding.embed(query);
+        const points = await this.qdrant.search(vector, limit, { must: filterMust });
+        const weighted = points
+            .filter((r) => (r.payload?.namespace || "") !== "noise.filtered")
+            .map((r) => {
+            const ns = String(r.payload?.namespace || "");
+            const weight = getNamespaceWeight(sourceAgent, ns);
+            const weightedScore = Math.min(1, r.score * weight);
+            return {
+                id: String(r.id),
+                rawScore: r.score,
+                score: weightedScore,
+                text: String(r.payload?.text || ""),
+                namespace: ns,
+                timestamp: typeof r.payload?.timestamp === "number" ? r.payload.timestamp : undefined,
+                metadata: (r.payload?.metadata || {}),
+            };
+        })
+            .filter((r) => r.score >= minScore)
+            .sort((a, b) => b.score - a.score);
+        return {
+            query,
+            count: weighted.length,
+            results: weighted,
+        };
+    }
+    resolveNamespace(namespace, sourceAgent) {
+        if (typeof namespace === "string" && namespace.trim().length > 0) {
+            return parseExplicitNamespace(namespace, sourceAgent);
+        }
+        return `agent.${sourceAgent}.working_memory`;
+    }
+    async embedDetailedCompat(text) {
+        const emb = this.embedding;
+        if (typeof emb.embedDetailed === "function") {
+            return emb.embedDetailed(text);
+        }
+        const vector = await this.embedding.embed(text);
+        return {
+            vector,
+            metadata: {
+                embedding_chunked: false,
+                embedding_chunks_count: 1,
+                embedding_chunking_strategy: "array_batch_weighted_avg",
+                embedding_model: "unknown",
+                embedding_model_key: "unknown",
+                embedding_provider: "auto",
+            },
+        };
+    }
+}
+//# sourceMappingURL=semantic-memory-usecase.js.map

package/dist/core/usecases/semantic-memory-usecase.js.map

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

package/dist/hooks/tool-context-injector.d.ts

@@ -0,0 +1,9 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+/**
+ * Inject runtime agent/session identity into memory tool params.
+ *
+ * Runtime provides identity in before_tool_call hook context; memory tools previously
+ * fell back to assistant when params.agentId was missing.
+ */
+export declare function registerMemoryToolContextInjector(api: OpenClawPluginApi): void;
+//# sourceMappingURL=tool-context-injector.d.ts.map

package/dist/hooks/tool-context-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context-injector.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-context-injector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAoC7D;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,iBAAiB,QAoCvE"}