@framers/agentos 0.1.46 → 0.1.47

package/dist/memory/graph/GraphologyMemoryGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphologyMemoryGraph.js","sourceRoot":"","sources":["../../../src/memory/graph/GraphologyMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAO5D,IAAI,UAA4E,CAAC;AAEjF,KAAK,UAAU,iBAAiB;IAC9B,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;QACvC,UAAU,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAiC,CAAC;QAClE,OAAO,UAAW,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,sEAAsE;YACpE,qDAAqD,CACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,OAAO,qBAAqB;IAAlC;QACU,UAAK,GAAsB,IAAI,CAAC;IA2N1C,CAAC;IAzNC,KAAK,CAAC,UAAU;QACd,MAAM,SAAS,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;IACnE,CAAC;IAEO,WAAW;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,0BAA0B;IAE1B,KAAK,CAAC,OAAO,CAAC,QAAgB,EAAE,QAA6B;QAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,CAAC,CAAC,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAgB;QACtB,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;IAChD,CAAC;IAED,0BAA0B;IAE1B,KAAK,CAAC,OAAO,CAAC,IAAgB;QAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QACnE,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE5C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,KAAK,GAAG,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAuB,CAAC;gBAClE,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;oBAC/B,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;oBACpD,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;oBACtC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,QAAgB,EAAE,IAAqB;QAC9C,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAEpC,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAa,EAAE,KAA8B,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;YACxG,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAsB,CAAC;YAC9C,IAAI,CAAC,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC;oBACT,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,KAAK,CAAC,MAAgB;oBAC9B,SAAS,EAAE,KAAK,CAAC,SAAmB;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,QAAgB,EAAE,QAAgB;QACjD,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACxC,IAAI,IAAI;gBAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;IACzB,CAAC;IAED,+BAA+B;IAE/B,KAAK,CAAC,mBAAmB,CACvB,OAAiB,EACjB,MAAkC;QAElC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAE7B,2CAA2C;QAC3C,OAAO,gBAAgB,CAAC;YACtB,OAAO;YACP,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;gBACvB,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;oBAAE,OAAO,EAAE,CAAC;gBAClC,MAAM,SAAS,GAA0C,EAAE,CAAC;gBAC5D,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,KAA8B,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;oBACtG,MAAM,UAAU,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBACvD,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,MAAgB,EAAE,CAAC,CAAC;gBACrE,CAAC,CAAC,CAAC;gBACH,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,2CAA2C;IAE3C,KAAK,CAAC,kBAAkB,CAAC,SAAmB,EAAE,eAAuB,GAAG;QACtE,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;oBAClD,IAAI,QAAQ,EAAE,CAAC;wBACb,MAAM,KAAK,GAAG,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAuB,CAAC;wBAClE,0CAA0C;wBAC1C,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;oBACrF,CAAC;yBAAM,CAAC;wBACN,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE;4BAClC,IAAI,EAAE,cAAc;4BACpB,MAAM,EAAE,YAAY;4BACpB,SAAS,EAAE,GAAG;yBACf,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAED,6BAA6B;IAE7B,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,qBAAqB;IAErB,KAAK,CAAC,cAAc,CAAC,UAAkB,CAAC;QACtC,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,KAAK,GAAG,OAAO;YAAE,OAAO,EAAE,CAAC;QAEjC,sGAAsG;QACtG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,CAAC,CAAC,WAAW,CAAC,CAAC,MAAc,EAAE,EAAE;YAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAAE,OAAO;YAEhC,qBAAqB;YACrB,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEpB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;gBAC/B,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAExB,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,KAAa,EAAE,MAA+B,EAAE,MAAc,EAAE,MAAc,EAAE,EAAE;oBACxG,MAAM,QAAQ,GAAG,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;oBACtD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;wBACtB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACvB,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,SAAS,CAAC,MAAM,IAAI,OAAO,EAAE,CAAC;gBAChC,0CAA0C;gBAC1C,IAAI,SAAS,GAAG,CAAC,CAAC;gBAClB,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;oBAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;oBACpC,SAAS,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAClC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAChE,CAAC,MAAM,CAAC;gBACX,CAAC;gBACD,SAAS,IAAI,CAAC,CAAC,CAAC,aAAa;gBAC7B,MAAM,aAAa,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBAEtE,QAAQ,CAAC,IAAI,CAAC;oBACZ,SAAS,EAAE,WAAW,UAAU,EAAE,EAAE;oBACpC,SAAS,EAAE,SAAS;oBACpB,OAAO,EAAE,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;iBAC3D,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,oBAAoB;IAEpB,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,EAAE,KAAK,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACpB,CAAC;CACF"}

package/dist/memory/graph/IMemoryGraph.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Adapter interface for the memory association graph.
+ *
+ * Abstracts over graphology (dev/testing) and IKnowledgeGraph (production).
+ * Supports:
+ * - Node/edge CRUD for memory traces
+ * - Spreading activation (Anderson's ACT-R)
+ * - Co-activation recording (Hebbian learning)
+ * - Conflict/contradiction edge detection
+ * - Community/cluster detection for consolidation
+ *
+ * @module agentos/memory/graph/IMemoryGraph
+ */
+export interface MemoryGraphNodeMeta {
+    type: string;
+    scope: string;
+    scopeId: string;
+    /** Current encoding strength (updated periodically). */
+    strength: number;
+    createdAt: number;
+}
+export type MemoryEdgeType = 'SHARED_ENTITY' | 'TEMPORAL_SEQUENCE' | 'SAME_TOPIC' | 'CONTRADICTS' | 'SUPERSEDES' | 'CAUSED_BY' | 'CO_ACTIVATED' | 'SCHEMA_INSTANCE';
+export interface MemoryEdge {
+    sourceId: string;
+    targetId: string;
+    type: MemoryEdgeType;
+    weight: number;
+    createdAt: number;
+}
+export interface SpreadingActivationConfig {
+    /** Maximum hops from seed nodes. @default 3 */
+    maxDepth?: number;
+    /** Activation decay per hop (multiplied each step). @default 0.5 */
+    decayPerHop?: number;
+    /** Minimum activation to continue spreading. @default 0.1 */
+    activationThreshold?: number;
+    /** Maximum activated nodes to return. @default 20 */
+    maxResults?: number;
+}
+export interface ActivatedNode {
+    memoryId: string;
+    activation: number;
+    depth: number;
+    /** IDs of seed nodes that contributed activation. */
+    activatedBy: string[];
+}
+export interface MemoryCluster {
+    clusterId: string;
+    memberIds: string[];
+    density: number;
+}
+export interface IMemoryGraph {
+    /** Initialize the graph backend. */
+    initialize(): Promise<void>;
+    addNode(memoryId: string, metadata: MemoryGraphNodeMeta): Promise<void>;
+    removeNode(memoryId: string): Promise<void>;
+    hasNode(memoryId: string): boolean;
+    addEdge(edge: MemoryEdge): Promise<void>;
+    getEdges(memoryId: string, type?: MemoryEdgeType): MemoryEdge[];
+    removeEdge(sourceId: string, targetId: string): Promise<void>;
+    spreadingActivation(seedIds: string[], config?: SpreadingActivationConfig): Promise<ActivatedNode[]>;
+    recordCoActivation(memoryIds: string[], learningRate?: number): Promise<void>;
+    getConflicts(memoryId: string): MemoryEdge[];
+    detectClusters(minSize?: number): Promise<MemoryCluster[]>;
+    nodeCount(): number;
+    edgeCount(): number;
+    clear(): void;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=IMemoryGraph.d.ts.map

package/dist/memory/graph/IMemoryGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryGraph.d.ts","sourceRoot":"","sources":["../../../src/memory/graph/IMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,MAAM,cAAc,GACtB,eAAe,GACf,mBAAmB,GACnB,YAAY,GACZ,aAAa,GACb,YAAY,GACZ,WAAW,GACX,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAMD,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAGnC,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE,CAAC;IAChE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG9D,mBAAmB,CACjB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAG5B,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG9E,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAG7C,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAG3D,SAAS,IAAI,MAAM,CAAC;IACpB,SAAS,IAAI,MAAM,CAAC;IACpB,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/memory/graph/IMemoryGraph.js

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview Adapter interface for the memory association graph.
+ *
+ * Abstracts over graphology (dev/testing) and IKnowledgeGraph (production).
+ * Supports:
+ * - Node/edge CRUD for memory traces
+ * - Spreading activation (Anderson's ACT-R)
+ * - Co-activation recording (Hebbian learning)
+ * - Conflict/contradiction edge detection
+ * - Community/cluster detection for consolidation
+ *
+ * @module agentos/memory/graph/IMemoryGraph
+ */
+export {};
+//# sourceMappingURL=IMemoryGraph.js.map

package/dist/memory/graph/IMemoryGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMemoryGraph.js","sourceRoot":"","sources":["../../../src/memory/graph/IMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/memory/graph/KnowledgeGraphMemoryGraph.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Production memory graph backend wrapping IKnowledgeGraph.
+ *
+ * Maps memory graph operations to the existing IKnowledgeGraph interface:
+ * - Nodes = KnowledgeEntity of type 'memory'
+ * - Edges = KnowledgeRelation with memory-specific labels
+ * - Uses traverse() and getNeighborhood() for spreading activation
+ * - Leverages existing Neo4j backend at scale
+ *
+ * @module agentos/memory/graph/KnowledgeGraphMemoryGraph
+ */
+import type { IKnowledgeGraph } from '../../core/knowledge/IKnowledgeGraph.js';
+import type { IMemoryGraph, MemoryGraphNodeMeta, MemoryEdge, MemoryEdgeType, SpreadingActivationConfig, ActivatedNode, MemoryCluster } from './IMemoryGraph.js';
+export declare class KnowledgeGraphMemoryGraph implements IMemoryGraph {
+    private readonly kg;
+    /** In-memory cache of node IDs for hasNode() (sync requirement). */
+    private nodeCache;
+    /** In-memory edge cache for sync getEdges(). */
+    private edgeCache;
+    constructor(kg: IKnowledgeGraph);
+    initialize(): Promise<void>;
+    addNode(memoryId: string, metadata: MemoryGraphNodeMeta): Promise<void>;
+    removeNode(memoryId: string): Promise<void>;
+    hasNode(memoryId: string): boolean;
+    addEdge(edge: MemoryEdge): Promise<void>;
+    getEdges(memoryId: string, type?: MemoryEdgeType): MemoryEdge[];
+    removeEdge(sourceId: string, targetId: string): Promise<void>;
+    spreadingActivation(seedIds: string[], config?: SpreadingActivationConfig): Promise<ActivatedNode[]>;
+    recordCoActivation(memoryIds: string[], learningRate?: number): Promise<void>;
+    getConflicts(memoryId: string): MemoryEdge[];
+    detectClusters(minSize?: number): Promise<MemoryCluster[]>;
+    nodeCount(): number;
+    edgeCount(): number;
+    clear(): void;
+    shutdown(): Promise<void>;
+    private cacheEdge;
+}
+//# sourceMappingURL=KnowledgeGraphMemoryGraph.d.ts.map

package/dist/memory/graph/KnowledgeGraphMemoryGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeGraphMemoryGraph.d.ts","sourceRoot":"","sources":["../../../src/memory/graph/KnowledgeGraphMemoryGraph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAsC,MAAM,yCAAyC,CAAC;AACnH,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,UAAU,EACV,cAAc,EACd,yBAAyB,EACzB,aAAa,EACb,aAAa,EACd,MAAM,mBAAmB,CAAC;AAqC3B,qBAAa,yBAA0B,YAAW,YAAY;IAMhD,OAAO,CAAC,QAAQ,CAAC,EAAE;IAL/B,oEAAoE;IACpE,OAAO,CAAC,SAAS,CAAqB;IACtC,gDAAgD;IAChD,OAAO,CAAC,SAAS,CAAmC;gBAEvB,EAAE,EAAE,eAAe;IAE1C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBvE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM5B,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,UAAU,EAAE;IAMzD,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB7D,mBAAmB,CACvB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,aAAa,EAAE,CAAC;IAyBrB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BxF,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE;IAMtC,cAAc,CAAC,OAAO,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA8CnE,SAAS,IAAI,MAAM;IAInB,SAAS,IAAI,MAAM;IAQnB,KAAK,IAAI,IAAI;IAKP,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B,OAAO,CAAC,SAAS;CAclB"}

package/dist/memory/graph/KnowledgeGraphMemoryGraph.js

@@ -0,0 +1,264 @@
+/**
+ * @fileoverview Production memory graph backend wrapping IKnowledgeGraph.
+ *
+ * Maps memory graph operations to the existing IKnowledgeGraph interface:
+ * - Nodes = KnowledgeEntity of type 'memory'
+ * - Edges = KnowledgeRelation with memory-specific labels
+ * - Uses traverse() and getNeighborhood() for spreading activation
+ * - Leverages existing Neo4j backend at scale
+ *
+ * @module agentos/memory/graph/KnowledgeGraphMemoryGraph
+ */
+import { spreadActivation } from './SpreadingActivation.js';
+// ---------------------------------------------------------------------------
+// Edge type mapping
+// ---------------------------------------------------------------------------
+const EDGE_TYPE_TO_LABEL = {
+    SHARED_ENTITY: 'related_to',
+    TEMPORAL_SEQUENCE: 'precedes',
+    SAME_TOPIC: 'similar_to',
+    CONTRADICTS: 'opposite_of',
+    SUPERSEDES: 'related_to',
+    CAUSED_BY: 'causes',
+    CO_ACTIVATED: 'related_to',
+    SCHEMA_INSTANCE: 'is_a',
+};
+const LABEL_TO_EDGE_TYPE = {
+    related_to: 'SHARED_ENTITY',
+    precedes: 'TEMPORAL_SEQUENCE',
+    similar_to: 'SAME_TOPIC',
+    opposite_of: 'CONTRADICTS',
+    causes: 'CAUSED_BY',
+    is_a: 'SCHEMA_INSTANCE',
+};
+function labelToEdgeType(label, properties) {
+    // Prefer explicit memoryEdgeType stored in properties
+    if (properties?.memoryEdgeType)
+        return properties.memoryEdgeType;
+    return LABEL_TO_EDGE_TYPE[label] ?? 'SHARED_ENTITY';
+}
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+export class KnowledgeGraphMemoryGraph {
+    constructor(kg) {
+        this.kg = kg;
+        /** In-memory cache of node IDs for hasNode() (sync requirement). */
+        this.nodeCache = new Set();
+        /** In-memory edge cache for sync getEdges(). */
+        this.edgeCache = new Map();
+    }
+    async initialize() {
+        await this.kg.initialize();
+        // Warm caches from existing memory entities
+        const existing = await this.kg.queryEntities({
+            entityTypes: ['memory'],
+            limit: 10000,
+        });
+        for (const entity of existing) {
+            this.nodeCache.add(entity.id);
+        }
+    }
+    // --- Node operations ---
+    async addNode(memoryId, metadata) {
+        await this.kg.upsertEntity({
+            id: memoryId,
+            type: 'memory',
+            label: `memory:${memoryId}`,
+            properties: {
+                memoryType: metadata.type,
+                scope: metadata.scope,
+                scopeId: metadata.scopeId,
+                strength: metadata.strength,
+            },
+            confidence: metadata.strength,
+            source: {
+                type: 'system',
+                timestamp: new Date(metadata.createdAt).toISOString(),
+                method: 'cognitive-memory',
+            },
+        });
+        this.nodeCache.add(memoryId);
+    }
+    async removeNode(memoryId) {
+        await this.kg.deleteEntity(memoryId);
+        this.nodeCache.delete(memoryId);
+        this.edgeCache.delete(memoryId);
+    }
+    hasNode(memoryId) {
+        return this.nodeCache.has(memoryId);
+    }
+    // --- Edge operations ---
+    async addEdge(edge) {
+        if (!this.nodeCache.has(edge.sourceId) || !this.nodeCache.has(edge.targetId))
+            return;
+        if (edge.sourceId === edge.targetId)
+            return;
+        const relationType = EDGE_TYPE_TO_LABEL[edge.type];
+        await this.kg.upsertRelation({
+            sourceId: edge.sourceId,
+            targetId: edge.targetId,
+            type: relationType,
+            label: edge.type,
+            weight: edge.weight,
+            bidirectional: true,
+            confidence: edge.weight,
+            properties: {
+                memoryEdgeType: edge.type,
+            },
+            source: {
+                type: 'system',
+                timestamp: new Date(edge.createdAt).toISOString(),
+                method: 'cognitive-memory',
+            },
+        });
+        // Update edge cache
+        this.cacheEdge(edge);
+    }
+    getEdges(memoryId, type) {
+        const cached = this.edgeCache.get(memoryId) ?? [];
+        if (!type)
+            return cached;
+        return cached.filter((e) => e.type === type);
+    }
+    async removeEdge(sourceId, targetId) {
+        // Find the relation ID first
+        const relations = await this.kg.getRelations(sourceId, { direction: 'both' });
+        for (const rel of relations) {
+            if ((rel.sourceId === sourceId && rel.targetId === targetId) ||
+                (rel.sourceId === targetId && rel.targetId === sourceId)) {
+                await this.kg.deleteRelation(rel.id);
+                break;
+            }
+        }
+        // Update cache
+        const sourceEdges = this.edgeCache.get(sourceId);
+        if (sourceEdges) {
+            this.edgeCache.set(sourceId, sourceEdges.filter((e) => !(e.targetId === targetId || e.sourceId === targetId)));
+        }
+    }
+    // --- Spreading activation ---
+    async spreadingActivation(seedIds, config) {
+        return spreadActivation({
+            seedIds,
+            getNeighbors: async (nodeId) => {
+                if (!this.nodeCache.has(nodeId))
+                    return [];
+                try {
+                    const { entities, relations } = await this.kg.getNeighborhood(nodeId, 1);
+                    return relations
+                        .filter((r) => r.sourceId === nodeId || r.targetId === nodeId)
+                        .map((r) => ({
+                        id: r.sourceId === nodeId ? r.targetId : r.sourceId,
+                        weight: r.weight,
+                    }))
+                        .filter((n) => this.nodeCache.has(n.id));
+                }
+                catch {
+                    return [];
+                }
+            },
+            config,
+        });
+    }
+    // --- Co-activation (Hebbian learning) ---
+    async recordCoActivation(memoryIds, learningRate = 0.1) {
+        const validIds = memoryIds.filter((id) => this.nodeCache.has(id));
+        const now = Date.now();
+        for (let i = 0; i < validIds.length; i++) {
+            for (let j = i + 1; j < validIds.length; j++) {
+                const existingEdges = this.getEdges(validIds[i]).filter((e) => e.targetId === validIds[j] || e.sourceId === validIds[j]);
+                if (existingEdges.length > 0) {
+                    // Strengthen existing edge
+                    const edge = existingEdges[0];
+                    const newWeight = Math.min(1.0, edge.weight + learningRate);
+                    await this.addEdge({ ...edge, weight: newWeight });
+                }
+                else {
+                    await this.addEdge({
+                        sourceId: validIds[i],
+                        targetId: validIds[j],
+                        type: 'CO_ACTIVATED',
+                        weight: learningRate,
+                        createdAt: now,
+                    });
+                }
+            }
+        }
+    }
+    // --- Conflict detection ---
+    getConflicts(memoryId) {
+        return this.getEdges(memoryId, 'CONTRADICTS');
+    }
+    // --- Clustering ---
+    async detectClusters(minSize = 3) {
+        // Use KnowledgeGraph traversal to find connected components
+        const visited = new Set();
+        const clusters = [];
+        let clusterIdx = 0;
+        for (const nodeId of this.nodeCache) {
+            if (visited.has(nodeId))
+                continue;
+            try {
+                const result = await this.kg.traverse(nodeId, {
+                    maxDepth: 5,
+                    direction: 'both',
+                    maxNodes: 100,
+                });
+                const component = [];
+                component.push(result.root.id);
+                visited.add(result.root.id);
+                for (const level of result.levels) {
+                    for (const entity of level.entities) {
+                        if (!visited.has(entity.id) && this.nodeCache.has(entity.id)) {
+                            visited.add(entity.id);
+                            component.push(entity.id);
+                        }
+                    }
+                }
+                if (component.length >= minSize) {
+                    clusters.push({
+                        clusterId: `cluster_${clusterIdx++}`,
+                        memberIds: component,
+                        density: result.totalRelations / Math.max(1, (component.length * (component.length - 1)) / 2),
+                    });
+                }
+            }
+            catch {
+                visited.add(nodeId);
+            }
+        }
+        return clusters;
+    }
+    // --- Lifecycle ---
+    nodeCount() {
+        return this.nodeCache.size;
+    }
+    edgeCount() {
+        let count = 0;
+        for (const edges of this.edgeCache.values()) {
+            count += edges.length;
+        }
+        return Math.floor(count / 2); // undirected
+    }
+    clear() {
+        this.nodeCache.clear();
+        this.edgeCache.clear();
+    }
+    async shutdown() {
+        this.clear();
+    }
+    // --- Internal ---
+    cacheEdge(edge) {
+        // Cache for both endpoints
+        for (const id of [edge.sourceId, edge.targetId]) {
+            const list = this.edgeCache.get(id) ?? [];
+            // Remove existing edge between these two nodes
+            const filtered = list.filter((e) => !((e.sourceId === edge.sourceId && e.targetId === edge.targetId) ||
+                (e.sourceId === edge.targetId && e.targetId === edge.sourceId)));
+            filtered.push(edge);
+            this.edgeCache.set(id, filtered);
+        }
+    }
+}
+//# sourceMappingURL=KnowledgeGraphMemoryGraph.js.map

package/dist/memory/graph/KnowledgeGraphMemoryGraph.js.map

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

package/dist/memory/graph/SpreadingActivation.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Anderson's spreading activation algorithm.
+ *
+ * Pure function implementation decoupled from graph backend.
+ * Used by both GraphologyMemoryGraph and KnowledgeGraphMemoryGraph.
+ *
+ * Algorithm:
+ * 1. Seed nodes start at activation = 1.0
+ * 2. Each hop: neighbor_activation = current · edge_weight · decayPerHop
+ * 3. Multi-path summation (capped at 1.0)
+ * 4. BFS with maxDepth and activationThreshold cutoffs
+ * 5. Hebbian rule: co-retrieved memories strengthen edges (caller's responsibility)
+ *
+ * @module agentos/memory/graph/SpreadingActivation
+ */
+import type { SpreadingActivationConfig, ActivatedNode } from './IMemoryGraph.js';
+export interface SpreadingActivationInput {
+    seedIds: string[];
+    /** Get neighbors with edge weights. Can be sync or async. */
+    getNeighbors: (nodeId: string) => Array<{
+        id: string;
+        weight: number;
+    }> | Promise<Array<{
+        id: string;
+        weight: number;
+    }>>;
+    config?: SpreadingActivationConfig;
+}
+/**
+ * Run spreading activation from seed nodes.
+ *
+ * Returns activated nodes sorted by activation level (descending),
+ * excluding seed nodes themselves.
+ */
+export declare function spreadActivation(input: SpreadingActivationInput): Promise<ActivatedNode[]>;
+//# sourceMappingURL=SpreadingActivation.d.ts.map

package/dist/memory/graph/SpreadingActivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpreadingActivation.d.ts","sourceRoot":"","sources":["../../../src/memory/graph/SpreadingActivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAMlF,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACzH,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAiBD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAuEhG"}

package/dist/memory/graph/SpreadingActivation.js

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Anderson's spreading activation algorithm.
+ *
+ * Pure function implementation decoupled from graph backend.
+ * Used by both GraphologyMemoryGraph and KnowledgeGraphMemoryGraph.
+ *
+ * Algorithm:
+ * 1. Seed nodes start at activation = 1.0
+ * 2. Each hop: neighbor_activation = current · edge_weight · decayPerHop
+ * 3. Multi-path summation (capped at 1.0)
+ * 4. BFS with maxDepth and activationThreshold cutoffs
+ * 5. Hebbian rule: co-retrieved memories strengthen edges (caller's responsibility)
+ *
+ * @module agentos/memory/graph/SpreadingActivation
+ */
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIG = {
+    maxDepth: 3,
+    decayPerHop: 0.5,
+    activationThreshold: 0.1,
+    maxResults: 20,
+};
+// ---------------------------------------------------------------------------
+// Algorithm
+// ---------------------------------------------------------------------------
+/**
+ * Run spreading activation from seed nodes.
+ *
+ * Returns activated nodes sorted by activation level (descending),
+ * excluding seed nodes themselves.
+ */
+export async function spreadActivation(input) {
+    const cfg = { ...DEFAULT_CONFIG, ...input.config };
+    const { seedIds, getNeighbors } = input;
+    // Activation map: nodeId → { activation, depth, activatedBy }
+    const activationMap = new Map();
+    // Initialize seeds at full activation
+    const seedSet = new Set(seedIds);
+    for (const seedId of seedIds) {
+        activationMap.set(seedId, { activation: 1.0, depth: 0, activatedBy: new Set([seedId]) });
+    }
+    // BFS wavefront
+    let currentWave = [...seedIds];
+    for (let depth = 1; depth <= cfg.maxDepth; depth++) {
+        const nextWave = [];
+        const decayFactor = Math.pow(cfg.decayPerHop, depth);
+        for (const nodeId of currentWave) {
+            const nodeActivation = activationMap.get(nodeId).activation;
+            const nodeActivatedBy = activationMap.get(nodeId).activatedBy;
+            const neighbors = await getNeighbors(nodeId);
+            for (const neighbor of neighbors) {
+                // Compute activation contribution from this path
+                const contribution = nodeActivation * neighbor.weight * cfg.decayPerHop;
+                if (contribution < cfg.activationThreshold)
+                    continue;
+                const existing = activationMap.get(neighbor.id);
+                if (existing) {
+                    // Multi-path summation, capped at 1.0
+                    existing.activation = Math.min(1.0, existing.activation + contribution);
+                    for (const by of nodeActivatedBy)
+                        existing.activatedBy.add(by);
+                    // Keep the shallowest depth
+                    if (depth < existing.depth)
+                        existing.depth = depth;
+                }
+                else {
+                    activationMap.set(neighbor.id, {
+                        activation: Math.min(1.0, contribution),
+                        depth,
+                        activatedBy: new Set(nodeActivatedBy),
+                    });
+                    nextWave.push(neighbor.id);
+                }
+            }
+        }
+        currentWave = nextWave;
+        if (currentWave.length === 0)
+            break;
+    }
+    // Collect results (exclude seeds)
+    const results = [];
+    for (const [nodeId, data] of activationMap) {
+        if (seedSet.has(nodeId))
+            continue;
+        if (data.activation < cfg.activationThreshold)
+            continue;
+        results.push({
+            memoryId: nodeId,
+            activation: data.activation,
+            depth: data.depth,
+            activatedBy: Array.from(data.activatedBy),
+        });
+    }
+    // Sort by activation descending, cap at maxResults
+    results.sort((a, b) => b.activation - a.activation);
+    return results.slice(0, cfg.maxResults);
+}
+//# sourceMappingURL=SpreadingActivation.js.map

package/dist/memory/graph/SpreadingActivation.js.map

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

package/dist/memory/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview Barrel exports for the Cognitive Memory System.
+ * @module agentos/memory
+ */
+export type { MemoryType, MemoryScope, MemorySourceType, MemoryProvenance, EmotionalContext, ContentFeatures, MemoryTrace, WorkingMemorySlot, EncodingWeights, EncodingResult, CognitiveRetrievalOptions, ScoredMemoryTrace, PartiallyRetrievedTrace, CognitiveRetrievalResult, MemoryBudgetAllocation, AssembledMemoryContext, MemoryHealthReport, } from './types.js';
+export type { CognitiveMemoryConfig, CognitiveMemoryPersonaConfig, PADState, HexacoTraits, EncodingConfig, DecayConfig, ObserverConfig, ReflectorConfig, MemoryGraphConfig, ConsolidationConfig, } from './config.js';
+export { DEFAULT_ENCODING_CONFIG, DEFAULT_DECAY_CONFIG, DEFAULT_BUDGET_ALLOCATION, } from './config.js';
+export { computeEncodingWeights, computeEncodingStrength, computeAttentionMultiplier, yerksDodson, moodCongruenceBoost, isFlashbulbMemory, buildEmotionalContext, } from './encoding/EncodingModel.js';
+export { createFeatureDetector, KeywordFeatureDetector, LlmFeatureDetector, HybridFeatureDetector, } from './encoding/ContentFeatureDetector.js';
+export type { IContentFeatureDetector } from './encoding/ContentFeatureDetector.js';
+export { computeCurrentStrength, updateOnRetrieval, computeInterference, findPrunableTraces, } from './decay/DecayModel.js';
+export type { RetrievalUpdateResult, InterferenceResult, InterferenceVictim } from './decay/DecayModel.js';
+export { scoreAndRankTraces, detectPartiallyRetrieved, computeRecencyBoost, computeEmotionalCongruence, DEFAULT_SCORING_WEIGHTS, } from './decay/RetrievalPriorityScorer.js';
+export type { ScoringWeights, ScoringContext, CandidateTrace } from './decay/RetrievalPriorityScorer.js';
+export { CognitiveWorkingMemory } from './working/CognitiveWorkingMemory.js';
+export type { CognitiveWorkingMemoryConfig } from './working/CognitiveWorkingMemory.js';
+export { MemoryStore } from './store/MemoryStore.js';
+export type { MemoryStoreConfig } from './store/MemoryStore.js';
+export { assembleMemoryContext } from './prompt/MemoryPromptAssembler.js';
+export type { MemoryAssemblerInput } from './prompt/MemoryPromptAssembler.js';
+export { formatMemoryTrace, formatMemoryTraces } from './prompt/MemoryFormatters.js';
+export type { FormattingStyle } from './prompt/MemoryFormatters.js';
+export { CognitiveMemoryManager } from './CognitiveMemoryManager.js';
+export type { ICognitiveMemoryManager } from './CognitiveMemoryManager.js';
+export { createCognitiveMemoryDescriptor } from './extension/CognitiveMemoryExtension.js';
+export type { IMemoryGraph, MemoryGraphNodeMeta, MemoryEdge, MemoryEdgeType, SpreadingActivationConfig, ActivatedNode, MemoryCluster, } from './graph/IMemoryGraph.js';
+export { GraphologyMemoryGraph } from './graph/GraphologyMemoryGraph.js';
+export { KnowledgeGraphMemoryGraph } from './graph/KnowledgeGraphMemoryGraph.js';
+export { spreadActivation } from './graph/SpreadingActivation.js';
+export type { SpreadingActivationInput } from './graph/SpreadingActivation.js';
+export { ObservationBuffer } from './observation/ObservationBuffer.js';
+export type { BufferedMessage, ObservationBufferConfig } from './observation/ObservationBuffer.js';
+export { MemoryObserver } from './observation/MemoryObserver.js';
+export type { ObservationNote } from './observation/MemoryObserver.js';
+export { MemoryReflector } from './observation/MemoryReflector.js';
+export type { MemoryReflectionResult } from './observation/MemoryReflector.js';
+export { ProspectiveMemoryManager } from './prospective/ProspectiveMemoryManager.js';
+export type { ProspectiveMemoryItem, ProspectiveTriggerType } from './prospective/ProspectiveMemoryManager.js';
+export { ConsolidationPipeline } from './consolidation/ConsolidationPipeline.js';
+export type { ConsolidationResult, ConsolidationPipelineConfig } from './consolidation/ConsolidationPipeline.js';
+export { ContextWindowManager } from './context/ContextWindowManager.js';
+export type { ContextWindowManagerConfig, ContextWindowStats } from './context/ContextWindowManager.js';
+export { CompactionEngine } from './context/CompactionEngine.js';
+export { CompactionLog } from './context/CompactionLog.js';
+export type { CompactionLogStats } from './context/CompactionLog.js';
+export { RollingSummaryChain } from './context/RollingSummaryChain.js';
+export { SlidingSummaryStrategy } from './context/strategies/SlidingSummaryStrategy.js';
+export { HierarchicalStrategy } from './context/strategies/HierarchicalStrategy.js';
+export { HybridStrategy } from './context/strategies/HybridStrategy.js';
+export type { InfiniteContextConfig, CompactionStrategy, TransparencyLevel, ContextMessage, CompactionEntry, SummaryChainNode, CompactionInput, CompactionResult, ICompactionStrategy, } from './context/types.js';
+export { DEFAULT_INFINITE_CONTEXT_CONFIG } from './context/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

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