@tryhamster/gerbil 1.0.0-rc.11 → 1.0.0-rc.12

package/dist/frameworks/express.d.mts

@@ -1,4 +1,4 @@
-import { c as GerbilConfig } from "../types-CiTc7ez3.mjs";
+import { c as GerbilConfig } from "../types-Bgb_89Bh.mjs";
 import { Request, Response, Router } from "express";
 
 //#region src/frameworks/express.d.ts

package/dist/frameworks/express.mjs

@@ -1,5 +1,5 @@
 import { t as __require } from "../chunk-CkXuGtQK.mjs";
-import { t as Gerbil } from "../gerbil-DoDGHe6Z.mjs";
+import { t as Gerbil } from "../gerbil-BcWjCGtM.mjs";
 import "../utils-CZBZ8dgR.mjs";
 
 //#region src/frameworks/express.ts

package/dist/frameworks/fastify.d.mts

@@ -1,4 +1,4 @@
-import { c as GerbilConfig } from "../types-CiTc7ez3.mjs";
+import { c as GerbilConfig } from "../types-Bgb_89Bh.mjs";
 
 //#region src/frameworks/fastify.d.ts
 

package/dist/frameworks/fastify.mjs

@@ -1,4 +1,4 @@
-import { t as Gerbil } from "../gerbil-DoDGHe6Z.mjs";
+import { t as Gerbil } from "../gerbil-BcWjCGtM.mjs";
 import "../utils-CZBZ8dgR.mjs";
 
 //#region src/frameworks/fastify.ts

package/dist/frameworks/hono.d.mts

@@ -1,4 +1,4 @@
-import { c as GerbilConfig } from "../types-CiTc7ez3.mjs";
+import { c as GerbilConfig } from "../types-Bgb_89Bh.mjs";
 import * as hono0 from "hono";
 import * as hono_types0 from "hono/types";
 

package/dist/frameworks/hono.mjs

@@ -1,4 +1,4 @@
-import { t as Gerbil } from "../gerbil-DoDGHe6Z.mjs";
+import { t as Gerbil } from "../gerbil-BcWjCGtM.mjs";
 import "../utils-CZBZ8dgR.mjs";
 
 //#region src/frameworks/hono.ts

package/dist/frameworks/next.d.mts

@@ -1,5 +1,5 @@
-import { c as GerbilConfig } from "../types-CiTc7ez3.mjs";
-import { t as Gerbil } from "../gerbil-qOTe1nl2.mjs";
+import { c as GerbilConfig } from "../types-Bgb_89Bh.mjs";
+import { t as Gerbil } from "../gerbil-E12cYLNi.mjs";
 
 //#region src/frameworks/next.d.ts
 

package/dist/frameworks/next.mjs

@@ -1,4 +1,4 @@
-import { t as Gerbil } from "../gerbil-DoDGHe6Z.mjs";
+import { t as Gerbil } from "../gerbil-BcWjCGtM.mjs";
 import "../utils-CZBZ8dgR.mjs";
 
 //#region src/frameworks/next.ts

package/dist/frameworks/react.d.mts

@@ -1,4 +1,4 @@
-import { c as GerbilConfig, o as GenerateOptions, s as GenerateResult } from "../types-CiTc7ez3.mjs";
+import { c as GerbilConfig, o as GenerateOptions, s as GenerateResult } from "../types-Bgb_89Bh.mjs";
 
 //#region src/frameworks/react.d.ts
 

package/dist/frameworks/react.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.mts","names":[],"sources":["../../src/frameworks/react.ts"],"sourcesContent":[],"mappings":";;;;AA+N2B,UA1MV,gBAAA,SAAyB,YA0Mf,CAAA;EAAc;EAEhC,QAAA,CAAA,EAAA,MAAA;EAAK;EAIE,WAAO,CAAA,EAAA,OAAA;;KAxMX,eAAA;;uCAE2B,oBAAoB,QAAQ;;qCAG9B,oBAAoB;;;;SAMhD;;;;UAMC;;;;;;;iBASM,SAAA,WAAmB,mBAAwB;;;;KAuJ/C,OAAA;;;;UAKK,cAAA,SAAuB;;oBAEpB;;;;KAMR,aAAA;YACA;;;qBAGS,KAAA,CAAM,cAAc;;SAEhC;;;iBAIO,OAAA,WAAiB,iBAAsB"}
+{"version":3,"file":"react.d.mts","names":[],"sources":["../../src/frameworks/react.ts"],"sourcesContent":[],"mappings":";;;;AA+N2B,UA1MV,gBAAA,SAAyB,YA0Mf,CAAA;EAAc;EAEhC,QAAA,CAAA,EAAA,MAAA;EAAK;EAIE,WAAO,CAAA,EAAA,OAAU;;KAxMrB,eAAA;;uCAE2B,oBAAoB,QAAQ;;qCAG9B,oBAAoB;;;;SAMhD;;;;UAMC;;;;;;;iBASM,SAAA,WAAmB,mBAAwB;;;;KAuJ/C,OAAA;;;;UAKK,cAAA,SAAuB;;oBAEpB;;;;KAMR,aAAA;YACA;;;qBAGS,KAAA,CAAM,cAAc;;SAEhC;;;iBAIO,OAAA,WAAiB,iBAAsB"}

package/dist/frameworks/trpc.d.mts

@@ -1,4 +1,4 @@
-import { c as GerbilConfig } from "../types-CiTc7ez3.mjs";
+import { c as GerbilConfig } from "../types-Bgb_89Bh.mjs";
 
 //#region src/frameworks/trpc.d.ts
 

package/dist/frameworks/trpc.mjs

@@ -1,4 +1,4 @@
-import { t as Gerbil } from "../gerbil-DoDGHe6Z.mjs";
+import { t as Gerbil } from "../gerbil-BcWjCGtM.mjs";
 import "../utils-CZBZ8dgR.mjs";
 import { z } from "zod";
 

package/dist/{gerbil-DoDGHe6Z.mjs → gerbil-BcWjCGtM.mjs}

@@ -1156,6 +1156,88 @@ The JSON must conform to this schema: ${JSON.stringify(zodToJsonSchema(schema))}
 		return results;
 	}
 	/**
+	* Compute cosine similarity between two vectors
+	*
+	* @example
+	* ```ts
+	* const sim = g.cosineSimilarity([1, 0, 0], [1, 0, 0]); // 1.0
+	* const sim2 = g.cosineSimilarity([1, 0, 0], [0, 1, 0]); // 0.0
+	* ```
+	*/
+	cosineSimilarity(a, b) {
+		if (a.length !== b.length) throw new Error(`Vector dimensions must match: ${a.length} vs ${b.length}`);
+		let dotProduct = 0;
+		let normA = 0;
+		let normB = 0;
+		for (let i = 0; i < a.length; i++) {
+			dotProduct += a[i] * b[i];
+			normA += a[i] * a[i];
+			normB += b[i] * b[i];
+		}
+		const magnitude = Math.sqrt(normA) * Math.sqrt(normB);
+		if (magnitude === 0) return 0;
+		return dotProduct / magnitude;
+	}
+	/**
+	* Compare similarity between two texts
+	*
+	* @example
+	* ```ts
+	* const result = await g.similarity("Hello world", "Hi there");
+	* console.log(result.score); // 0.85
+	* ```
+	*/
+	async similarity(textA, textB, options = {}) {
+		const startTime = performance.now();
+		const [embedA, embedB] = await Promise.all([this.embed(textA, options), this.embed(textB, options)]);
+		return {
+			score: this.cosineSimilarity(embedA.vector, embedB.vector),
+			textA,
+			textB,
+			totalTime: performance.now() - startTime
+		};
+	}
+	/**
+	* Semantic search - find most similar texts from a corpus
+	*
+	* @example
+	* ```ts
+	* const results = await g.search("capital of France", [
+	*   "Paris is beautiful",
+	*   "London is in England",
+	*   "Dogs are pets"
+	* ]);
+	* // [{ text: "Paris is beautiful", score: 0.89, index: 0 }, ...]
+	* ```
+	*/
+	async search(query, corpus, options = {}) {
+		const { topK = corpus.length, ...embedOptions } = options;
+		const queryEmbedding = await this.embed(query, embedOptions);
+		return (await this.embedBatch(corpus, embedOptions)).map((doc, index) => ({
+			text: doc.text,
+			score: this.cosineSimilarity(queryEmbedding.vector, doc.vector),
+			index
+		})).sort((a, b) => b.score - a.score).slice(0, topK);
+	}
+	/**
+	* Find the nearest text to an embedding vector
+	*
+	* @example
+	* ```ts
+	* const embedding = (await g.embed("dog")).vector;
+	* const match = await g.findNearest(embedding, ["cat", "car", "tree"]);
+	* // { text: "cat", score: 0.85, index: 0 }
+	* ```
+	*/
+	async findNearest(embedding, candidates, options = {}) {
+		const { topK = candidates.length, ...embedOptions } = options;
+		return (await this.embedBatch(candidates, embedOptions)).map((doc, index) => ({
+			text: doc.text,
+			score: this.cosineSimilarity(embedding, doc.vector),
+			index
+		})).sort((a, b) => b.score - a.score).slice(0, topK);
+	}
+	/**
 	* Get session stats
 	*/
 	getStats() {
@@ -1628,4 +1710,4 @@ The JSON must conform to this schema: ${JSON.stringify(zodToJsonSchema(schema))}
 
 //#endregion
 export { ResponseCache as a, getGlobalCache as c, resolveModel as i, BUILTIN_MODELS as n, clearGlobalCache as o, listBuiltinModels as r, configureGlobalCache as s, Gerbil as t };
-//# sourceMappingURL=gerbil-DoDGHe6Z.mjs.map
+//# sourceMappingURL=gerbil-BcWjCGtM.mjs.map