**feat(similarity): add similarity calculation between vectors and text inputs**

- Introduced `calculateSimilarity` method in `types.d.ts` for comparing vectors or textual inputs:
  - Added support for custom options, including `forceEmbed` and a custom `distanceFunction`.
- Enhanced functionality in `embed` to convert text inputs into vector representations.
- Added new test cases in `vector-operations.test.ts`:
  - Validated similarity calculations between identical and different vectors.
  - Tested similarity scoring for similar and dissimilar text inputs.
- Updated `README.md`:
  - Documented `calculateSimilarity` usage examples, including advanced options.
  - Clarified the integration of the similarity function into workflows.

**Purpose**: Enable calculation of similarity scores for vectors and text inputs to facilitate advanced data comparison and retrieval tasks.

cli-package/types.d.ts

@@ -15,6 +15,14 @@ declare module '@soulcraft/brainy' {
     search(query: string, limit?: number, options?: any): Promise<any[]>
 
     searchText(query: string, limit?: number, options?: any): Promise<any[]>
+    
+    embed(data: string | string[]): Promise<number[]>
+    
+    calculateSimilarity(
+      a: number[] | string | string[],
+      b: number[] | string | string[],
+      options?: { forceEmbed?: boolean, distanceFunction?: any }
+    ): Promise<number>
 
     addVerb(
       sourceId: string,