@agentica/vector-selector 0.20.0 → 0.21.0

package/README.md

@@ -2,7 +2,7 @@
 
 <!-- https://github.com/user-attachments/assets/5326cc59-5129-470d-abcb-c3f458b5c488 -->
 
-![Logo](https://wrtnlabs.io/agentica/logo.png)
+![Logo](https://wrtnlabs.io/agentica/og.jpg?refresh)
 
 [![GitHub License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/wrtnlabs/agentica/blob/master/LICENSE)
 [![NPM Version](https://img.shields.io/npm/v/@agentica/core.svg)](https://www.npmjs.com/package/@agentica/core)
@@ -147,9 +147,10 @@ flowchart
 
 Agentica enhances AI function calling by the following strategies:
 
-- [**JSON schema conversion**](https://wrtnlabs.io/agentica/docs/core/vendor/#schema-specification): Automatically handles specification differences between LLM vendors, ensuring seamless integration regardless of your chosen AI model.
-- [**Validation Feedback**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#validation-feedback): Detects and corrects AI mistakes in argument composition, dramatically reducing errors and improving reliability.
-- [**Selector Agent**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#orchestration-strategy): Filtering candidate functions to minimize context usage, optimize performance, and reduce token consumption.
+- [**Compiler Driven Development**](https://wrtnlabs.io/agentica/docs/concepts/compiler-driven-development): constructs function calling schema automatically by compiler skills without hand-writing.
+- [**JSON Schema Conversion**](https://wrtnlabs.io/agentica/docs/core/vendor/#schema-specification): automatically handles specification differences between LLM vendors, ensuring seamless integration regardless of your chosen AI model.
+- [**Validation Feedback**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#validation-feedback): detects and corrects AI mistakes in argument composition, dramatically reducing errors and improving reliability.
+- [**Selector Agent**](https://wrtnlabs.io/agentica/docs/concepts/function-calling#orchestration-strategy): filtering candidate functions to minimize context usage, optimize performance, and reduce token consumption.
 
 Thanks to these innovations, Agentica makes AI function calling easier, safer, and more accurate than before. Development becomes more intuitive since you only need to prepare functions relevant to your specific use case, and scaling your agent's capabilities is as simple as adding or removing functions.
 

package/lib/index.js

@@ -22,10 +22,7 @@ function BootAgenticaVectorSelector(props) {
             yield embedContext({ ctx, setEmbedded: () => setEmbedded(ctx) });
         }
         const queries = yield (0, extract_query_1.extractQuery)(ctx);
-        const toolList = yield Promise.all(queries.map((query) => __awaiter(this, void 0, void 0, function* () { return searchTool(ctx, query); }))).then(res => res.flatMap(output => output.map(v => ({
-            name: v.name,
-            description: v.description,
-        }))).map((v) => {
+        const toolList = yield Promise.all(queries.map((query) => __awaiter(this, void 0, void 0, function* () { return searchTool(ctx, query); }))).then(res => res.flat().map((v) => {
             const op = ctx.operations.flat.get(v.name);
             if (op === undefined || op.protocol !== "http") {
                 return v;

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;AAuBA,gEA2CC;AAED,gDASC;AA1ED,mDAA+C;AAC/C,qCAA0C;AAC1C,mCAAiC;AAkBjC,SAAgB,0BAA0B,CAAuC,KAAoD;IACnI,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,kBAAkB,EAAe,CAAC;IACtE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;IACpD,MAAM,eAAe,GAAG,CACtB,GAAiC,EACQ,EAAE;QAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,YAAY,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAY,EAAC,GAAG,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,OAAO,CAAC,GAAG,CAAC,CAAM,KAAK,EAAC,EAAE,gDAAC,OAAA,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA,GAAA,CAAC,CACnD,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACX,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CACnB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACf,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;SAC3B,CAAC,CAAC,CACJ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC/C,OAAO,CAAC,CAAC;YACX,CAAC;YAED,uCACK,CAAC,KACJ,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAC1B,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EACtB,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,IACtB;QACJ,CAAC,CAAC,CACH,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,cAAM,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAExC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAA,uBAAc,EAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAA,CAAC;IAEF,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,OAAO;QACL,UAAU,EAAE,CAAC,GAAiC,EAAE,EAAE,CAChD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/C,WAAW,EAAE,CAAC,GAAiC,EAAE,EAAE;YACjD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,CAAC;KACO,CAAC;AACb,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;AAuBA,gEAoCC;AAED,gDASC;AAnED,mDAA+C;AAC/C,qCAA0C;AAC1C,mCAAiC;AAkBjC,SAAgB,0BAA0B,CAAuC,KAAoD;IACnI,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,kBAAkB,EAAe,CAAC;IACtE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;IACpD,MAAM,eAAe,GAAG,CACtB,GAAiC,EACQ,EAAE;QAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,YAAY,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAY,EAAC,GAAG,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,OAAO,CAAC,GAAG,CAAC,CAAM,KAAK,EAAC,EAAE,gDAAC,OAAA,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA,GAAA,CAAC,CACnD,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACjC,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;gBAC/C,OAAO,CAAC,CAAC;YACX,CAAC;YAED,uCACK,CAAC,KACJ,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAC1B,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EACtB,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,IACtB;QACJ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,cAAM,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAA,uBAAc,EAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAA,CAAC;IAEF,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,OAAO;QACL,UAAU,EAAE,CAAC,GAAiC,EAAE,EAAE,CAChD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC/C,WAAW,EAAE,CAAC,GAAiC,EAAE,EAAE;YACjD,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QAChD,CAAC;KACO,CAAC;AACb,CAAC"}

package/lib/index.mjs

@@ -4,6 +4,10 @@ import { AgenticaDefaultPrompt } from "@agentica/core/src/constants/AgenticaDefa
 
 import { AgenticaSystemPrompt } from "@agentica/core/src/constants/AgenticaSystemPrompt";
 
+import "@noble/hashes/sha2";
+
+import "@noble/hashes/utils";
+
 const Tools = {
     extract_query: {
         type: "function",
@@ -271,10 +275,7 @@ function BootAgenticaVectorSelector(props) {
             });
         }
         const queries = await extractQuery(ctx);
-        const toolList = await Promise.all(queries.map((async query => searchTool(ctx, query)))).then((res => res.flatMap((output => output.map((v => ({
-            name: v.name,
-            description: v.description
-        }))))).map((v => {
+        const toolList = await Promise.all(queries.map((async query => searchTool(ctx, query)))).then((res => res.flat().map((v => {
             const op = ctx.operations.flat.get(v.name);
             if (op === undefined || op.protocol !== "http") {
                 return v;

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/tools.ts","../src/extract_query.ts","../src/select.ts","../src/utils.ts","../src/index.ts"],"sourcesContent":[null,null,null,null,null],"names":["Tools","extract_query","type","function","name","description","parameters","properties","query_list","items","reason","query","required","select_functions","function_list","function_name","async","extractQuery","ctx","completionStream","request","messages","role","content","join","histories","map","factory","flat","prompt","text","tool_choice","tools","chunks","utils","StreamUtil","readAll","completion","ChatGptCompletionMessageUtil","merge","queries","choices","message","tool_calls","flatMap","v","arg","JSON","parse","arguments","Array","isArray","selectFunction","props","toolList","prevFailures","restRetry","selectCompletion","AgenticaDefaultPrompt","write","config","id","stringify","tool_call_id","systemPrompt","select","AgenticaSystemPrompt","SELECT","emendMessages","parallel_tool_calls","then","toolCalls","filter","length","createTextHistory","failures","reduce","acc","cur","forEach","tc","errors","push","path","expected","value","idx","validation","data","feedback","Error","prompts","collection","selections","toJSON","s","operation","operations","get","undefined","selection","createOperationSelection","stack","dispatch","createSelectEvent","catch","f","uniqBy","array","selector","seen","Set","item","key","has","add","BootAgenticaVectorSelector","isEmbedded","setEmbedded","useEmbeddedContext","searchTool","embedContext","strategy","selectorExecute","Promise","all","res","output","op","protocol","method","tags","arr","set"],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/tools.ts","../src/extract_query.ts","../src/select.ts","../src/utils.ts","../src/index.ts"],"sourcesContent":[null,null,null,null,null],"names":["Tools","extract_query","type","function","name","description","parameters","properties","query_list","items","reason","query","required","select_functions","function_list","function_name","async","extractQuery","ctx","completionStream","request","messages","role","content","join","histories","map","factory","flat","prompt","text","tool_choice","tools","chunks","utils","StreamUtil","readAll","completion","ChatGptCompletionMessageUtil","merge","queries","choices","message","tool_calls","flatMap","v","arg","JSON","parse","arguments","Array","isArray","selectFunction","props","toolList","prevFailures","restRetry","selectCompletion","AgenticaDefaultPrompt","write","config","id","stringify","tool_call_id","systemPrompt","select","AgenticaSystemPrompt","SELECT","emendMessages","parallel_tool_calls","then","toolCalls","filter","length","createTextHistory","failures","reduce","acc","cur","forEach","tc","errors","push","path","expected","value","idx","validation","data","feedback","Error","prompts","collection","selections","toJSON","s","operation","operations","get","undefined","selection","createOperationSelection","stack","dispatch","createSelectEvent","catch","f","uniqBy","array","selector","seen","Set","item","key","has","add","BootAgenticaVectorSelector","isEmbedded","setEmbedded","useEmbeddedContext","searchTool","embedContext","strategy","selectorExecute","Promise","all","res","op","protocol","method","tags","arr","set"],"mappings":"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"}

package/lib/strategy/index.d.ts

@@ -1 +1,2 @@
 export * from "./postgres.strategy";
+export { configureSqliteStrategy } from "./sqlite.strategy";

package/lib/strategy/index.js

@@ -14,5 +14,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureSqliteStrategy = void 0;
 __exportStar(require("./postgres.strategy"), exports);
+var sqlite_strategy_1 = require("./sqlite.strategy");
+Object.defineProperty(exports, "configureSqliteStrategy", { enumerable: true, get: function () { return sqlite_strategy_1.configureSqliteStrategy; } });
 //# sourceMappingURL=index.js.map

package/lib/strategy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategy/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/strategy/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,qDAA4D;AAAnD,0HAAA,uBAAuB,OAAA"}

package/lib/strategy/sqlite.strategy.d.ts

@@ -0,0 +1,8 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { Database } from "better-sqlite3";
+import type { IAgenticaVectorSelectorStrategy } from "..";
+export interface IAgenticaSqliteVectorSelectorStrategyProps {
+    db: Database;
+    cohereApiKey: string;
+}
+export declare function configureSqliteStrategy<SchemaModel extends ILlmSchema.Model>(props: IAgenticaSqliteVectorSelectorStrategyProps): IAgenticaVectorSelectorStrategy<SchemaModel>;

package/lib/strategy/sqlite.strategy.js

@@ -0,0 +1,105 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureSqliteStrategy = configureSqliteStrategy;
+const cohere_ai_1 = require("cohere-ai");
+const sqlite_vec_1 = require("sqlite-vec");
+const utils_1 = require("../utils");
+const retry = (0, utils_1.getRetry)(3);
+const hashMemo = new Map();
+function configureSqliteStrategy(props) {
+    const { db, cohereApiKey } = props;
+    (0, sqlite_vec_1.load)(db);
+    const cohere = new cohere_ai_1.CohereClientV2({
+        token: cohereApiKey,
+    });
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS _agentica_vector_selector_embeddings (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      hash TEXT NOT NULL,
+      name TEXT NOT NULL,
+      description TEXT,
+      vector BLOB NOT NULL
+    )
+  `);
+    function embed(text, inputType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield retry(() => __awaiter(this, void 0, void 0, function* () {
+                return cohere.embed({
+                    texts: [text],
+                    inputType,
+                    model: "embed-multilingual-light-v3.0",
+                    embeddingTypes: ["float"],
+                });
+            }));
+            if ((result.embeddings.float == null) || result.embeddings.float.length === 0) {
+                throw new Error("no float embeddings returned");
+            }
+            const vector = result.embeddings.float[0];
+            return vector;
+        });
+    }
+    // it's memoized to avoid generating the same hash for the same context
+    // if you know react, it's like useMemo
+    const getHash = (ctx) => {
+        if (hashMemo.has(ctx)) {
+            return hashMemo.get(ctx);
+        }
+        const hash = (0, utils_1.generateHashFromCtx)(ctx);
+        hashMemo.set(ctx, hash);
+        return hash;
+    };
+    // embed each operation in the context.opersation.array
+    function embedOperation(props) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const name = props.operation.function.name;
+            const embedding = yield retry(() => __awaiter(this, void 0, void 0, function* () { var _a; return embed((_a = props.operation.function.description) !== null && _a !== void 0 ? _a : name, "search_document"); }));
+            db
+                .prepare("INSERT INTO _agentica_vector_selector_embeddings (hash, name, description, vector) VALUES (?, ?, ?, vec_f32(?))")
+                .run(props.hash, name, props.operation.function.description, JSON.stringify(embedding));
+        });
+    }
+    function embedContext(props) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const hash = getHash(props.ctx);
+            const prepared = db.prepare(`SELECT name FROM _agentica_vector_selector_embeddings WHERE hash = ?`).all(hash);
+            if (prepared.length > 0) {
+                props.setEmbedded();
+                return;
+            }
+            yield (0, utils_1.groupByArray)(props.ctx.operations.array, 10).reduce((accPromise, cur) => __awaiter(this, void 0, void 0, function* () {
+                yield accPromise;
+                yield Promise.all(cur.map((v) => __awaiter(this, void 0, void 0, function* () { return embedOperation({ hash, operation: v }); })));
+                return Promise.resolve();
+            }), Promise.resolve());
+            props.setEmbedded();
+        });
+    }
+    function searchTool(ctx, query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const hash = getHash(ctx);
+            const vector = yield embed(query, "search_query");
+            const result = db.prepare(`
+        SELECT name, description, vec_distance_L2(vector, ?) as distance
+        FROM _agentica_vector_selector_embeddings
+        WHERE hash = ?
+        ORDER BY distance
+        LIMIT 10
+    `).all(JSON.stringify(vector), hash);
+            return result;
+        });
+    }
+    return {
+        searchTool,
+        embedContext,
+    };
+}
+//# sourceMappingURL=sqlite.strategy.js.map

package/lib/strategy/sqlite.strategy.js.map

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

package/lib/utils.d.ts

@@ -1,3 +1,5 @@
+import type { AgenticaContext } from "@agentica/core";
+import type { ILlmSchema } from "@samchon/openapi";
 import type { GreaterThan, Integer } from "type-fest";
 /** type function to check if a number is greater than 0 */
 type GreaterThanZeroInteger<T extends number> = GreaterThan<Integer<T>, 0> extends true ? T : never;
@@ -49,4 +51,11 @@ export declare function groupByArray<T, TCount extends number>(array: T[], count
  * ```
  */
 export declare function uniqBy<T, K>(array: T[], selector: (item: T) => K): T[];
+/**
+ * Generates a hash from an Agentica ctx.operations.array.
+ *
+ * @param ctx - The Agentica context to generate a hash from
+ * @returns A hash of the Agentica context
+ */
+export declare function generateHashFromCtx<SchemaModel extends ILlmSchema.Model>(ctx: AgenticaContext<SchemaModel>): string;
 export {};

package/lib/utils.js

@@ -12,6 +12,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRetry = getRetry;
 exports.groupByArray = groupByArray;
 exports.uniqBy = uniqBy;
+exports.generateHashFromCtx = generateHashFromCtx;
+const sha2_1 = require("@noble/hashes/sha2");
+const utils_1 = require("@noble/hashes/utils");
 /**
  * This function is used to get a retry function.
  *
@@ -105,4 +108,17 @@ function uniqBy(array, selector) {
         return true;
     });
 }
+/**
+ * Generates a hash from an Agentica ctx.operations.array.
+ *
+ * @param ctx - The Agentica context to generate a hash from
+ * @returns A hash of the Agentica context
+ */
+function generateHashFromCtx(ctx) {
+    const target = JSON.stringify(ctx.operations.array);
+    const bytes = (0, utils_1.utf8ToBytes)(target);
+    const hash = (0, sha2_1.sha256)(bytes);
+    const binary = String.fromCharCode(...hash);
+    return btoa(binary);
+}
 //# sourceMappingURL=utils.js.map

package/lib/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;;;;;;;;;AAkBA,4BAsBC;AAcD,oCAkBC;AAsBD,wBAUC;AAnGD;;;;;;;;;;;;GAYG;AACH,SAAgB,QAAQ,CAAwB,KAAqC;IACnF,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,CAAU,EAAoB,EAAE,EAAE;QACvC,IAAI,SAAS,GAAY,IAAI,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;YACD,OAAO,CAAU,EAAE,CAAC;gBAClB,SAAS,GAAG,CAAC,CAAC;gBACd,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC;oBACpB,MAAM,CAAC,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QACD,kCAAkC;QAClC,MAAM,SAAS,CAAC;IAClB,CAAC,CAAA,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,YAAY,CAA2B,KAAU,EAAE,KAAqC;IACtG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,MAAM,CAAO,KAAU,EAAE,QAAwB;IAC/D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;IAC1B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;;;;;;;;;AAuBA,4BAsBC;AAcD,oCAkBC;AAsBD,wBAUC;AAQD,kDAMC;AAvHD,6CAA4C;AAC5C,+CAAkD;AAKlD;;;;;;;;;;;;GAYG;AACH,SAAgB,QAAQ,CAAwB,KAAqC;IACnF,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,CAAU,EAAoB,EAAE,EAAE;QACvC,IAAI,SAAS,GAAY,IAAI,CAAC;QAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC;YACD,OAAO,CAAU,EAAE,CAAC;gBAClB,SAAS,GAAG,CAAC,CAAC;gBACd,IAAI,CAAC,KAAK,KAAK,GAAG,CAAC,EAAE,CAAC;oBACpB,MAAM,CAAC,CAAC;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QACD,kCAAkC;QAClC,MAAM,SAAS,CAAC;IAClB,CAAC,CAAA,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,YAAY,CAA2B,KAAU,EAAE,KAAqC;IACtG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,MAAM,CAAO,KAAU,EAAE,QAAwB;IAC/D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAK,CAAC;IAC1B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB,CAAuC,GAAiC;IACzG,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,MAAM,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAA,aAAM,EAAC,KAAK,CAAC,CAAC;IAC3B,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentica/vector-selector",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "author": "Wrtn Technologies",
   "license": "MIT",
   "homepage": "https://wrtnlabs.io",
@@ -47,15 +47,20 @@
     "src"
   ],
   "peerDependencies": {
-    "@agentica/core": "^0.20.0"
+    "@agentica/core": "^0.21.0"
   },
   "dependencies": {
-    "@wrtnlabs/connector-hive-api": "^1.5.0"
+    "@noble/hashes": "^1.8.0",
+    "@wrtnlabs/connector-hive-api": "^1.5.0",
+    "better-sqlite3": "^11.9.1",
+    "cohere-ai": "^7.17.1",
+    "sqlite-vec": "0.1.7-alpha.2"
   },
   "devDependencies": {
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.1",
     "@samchon/openapi": "^4.2.0",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.10.5",
     "json-schema-to-ts": "^3.1.1",
     "rimraf": "^6.0.1",
@@ -63,7 +68,7 @@
     "type-fest": "^4.37.0",
     "typescript": "~5.8.3",
     "vitest": "^3.0.9",
-    "@agentica/core": "^0.20.0"
+    "@agentica/core": "^0.21.0"
   },
   "scripts": {
     "build": "tsc -p ./tsconfig.build.json && rollup -c",

package/src/index.ts

@@ -34,26 +34,19 @@ export function BootAgenticaVectorSelector<SchemaModel extends ILlmSchema.Model>
     const queries = await extractQuery(ctx);
     const toolList = await Promise.all(
       queries.map(async query => searchTool(ctx, query)),
-    ).then(res =>
-      res.flatMap(output =>
-        output.map(v => ({
-          name: v.name,
-          description: v.description,
-        })),
-      ).map((v) => {
-        const op = ctx.operations.flat.get(v.name);
-        if (op === undefined || op.protocol !== "http") {
-          return v;
-        }
+    ).then(res => res.flat().map((v) => {
+      const op = ctx.operations.flat.get(v.name);
+      if (op === undefined || op.protocol !== "http") {
+        return v;
+      }
 
-        return {
-          ...v,
-          method: op.function.method,
-          path: op.function.path,
-          tags: op.function.tags,
-        };
-      }),
-    ).then(arr => uniqBy(arr, v => v.name));
+      return {
+        ...v,
+        method: op.function.method,
+        path: op.function.path,
+        tags: op.function.tags,
+      };
+    })).then(arr => uniqBy(arr, v => v.name));
 
     if (toolList.length === 0) {
       return [];

package/src/strategy/index.ts

@@ -1 +1,2 @@
 export * from "./postgres.strategy";
+export { configureSqliteStrategy } from "./sqlite.strategy";

package/src/strategy/sqlite.strategy.ts

@@ -0,0 +1,124 @@
+import type { AgenticaContext, AgenticaOperation } from "@agentica/core";
+import type { ILlmSchema } from "@samchon/openapi";
+import type { Database } from "better-sqlite3";
+import type { Cohere } from "cohere-ai";
+
+import { CohereClientV2 } from "cohere-ai";
+import { load } from "sqlite-vec";
+
+import type { IAgenticaVectorSelectorStrategy } from "..";
+
+import { generateHashFromCtx, getRetry, groupByArray } from "../utils";
+
+export interface IAgenticaSqliteVectorSelectorStrategyProps {
+  db: Database;
+  cohereApiKey: string;
+}
+
+const retry = getRetry(3);
+const hashMemo = new Map<object, string>();
+export function configureSqliteStrategy<SchemaModel extends ILlmSchema.Model>(props: IAgenticaSqliteVectorSelectorStrategyProps): IAgenticaVectorSelectorStrategy<SchemaModel> {
+  const { db, cohereApiKey } = props;
+  load(db);
+
+  const cohere = new CohereClientV2({
+    token: cohereApiKey,
+  });
+
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS _agentica_vector_selector_embeddings (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      hash TEXT NOT NULL,
+      name TEXT NOT NULL,
+      description TEXT,
+      vector BLOB NOT NULL
+    )
+  `);
+
+  async function embed(text: string, inputType: Cohere.EmbedInputType) {
+    const result = await retry(async () => cohere.embed({
+      texts: [text],
+      inputType,
+      model: "embed-multilingual-light-v3.0",
+      embeddingTypes: ["float"],
+    }));
+
+    if ((result.embeddings.float == null) || result.embeddings.float.length === 0) {
+      throw new Error("no float embeddings returned");
+    }
+    const vector = result.embeddings.float[0]!;
+    return vector;
+  }
+  // it's memoized to avoid generating the same hash for the same context
+  // if you know react, it's like useMemo
+  const getHash = (ctx: AgenticaContext<SchemaModel>) => {
+    if (hashMemo.has(ctx)) {
+      return hashMemo.get(ctx)!;
+    }
+    const hash = generateHashFromCtx(ctx);
+    hashMemo.set(ctx, hash);
+    return hash;
+  };
+
+  // embed each operation in the context.opersation.array
+  async function embedOperation(props: {
+    hash: string;
+    operation: AgenticaOperation<SchemaModel>;
+  }): Promise<void> {
+    const name = props.operation.function.name;
+
+    const embedding = await retry(async () => embed(props.operation.function.description ?? name, "search_document"));
+
+    db
+
+      .prepare("INSERT INTO _agentica_vector_selector_embeddings (hash, name, description, vector) VALUES (?, ?, ?, vec_f32(?))")
+
+      .run(props.hash, name, props.operation.function.description, JSON.stringify(embedding));
+  }
+
+  async function embedContext(props: {
+    ctx: AgenticaContext<SchemaModel>;
+    setEmbedded: () => void;
+  }): Promise<void> {
+    const hash = getHash(props.ctx);
+
+    const prepared = db.prepare(`SELECT name FROM _agentica_vector_selector_embeddings WHERE hash = ?`).all(hash);
+    if (prepared.length > 0) {
+      props.setEmbedded();
+      return;
+    }
+
+    await groupByArray(props.ctx.operations.array, 10).reduce(async (accPromise, cur) => {
+      await accPromise;
+      await Promise.all(cur.map(async v => embedOperation({ hash, operation: v })));
+      return Promise.resolve();
+    }, Promise.resolve());
+    props.setEmbedded();
+  }
+
+  async function searchTool(ctx: AgenticaContext<SchemaModel>, query: string): Promise<{
+    name: string;
+    description: string | undefined;
+  }[]> {
+    const hash = getHash(ctx);
+    const vector = await embed(query, "search_query");
+
+    const result = db.prepare(`
+        SELECT name, description, vec_distance_L2(vector, ?) as distance
+        FROM _agentica_vector_selector_embeddings
+        WHERE hash = ?
+        ORDER BY distance
+        LIMIT 10
+    `).all(JSON.stringify(vector), hash) as {
+      name: string;
+      description: string;
+      distance: number;
+    }[];
+    return result;
+  }
+
+  return {
+    searchTool,
+    embedContext,
+  };
+}

package/src/utils.test.ts

@@ -1,4 +1,6 @@
-import { getRetry, groupByArray } from "./utils";
+import type { AgenticaContext } from "@agentica/core";
+
+import { generateHashFromCtx, getRetry, groupByArray, uniqBy } from "./utils";
 
 describe("getRetry", () => {
   it("should throw error when count is less than 1", () => {
@@ -183,3 +185,173 @@ describe("groupByArray", () => {
     expect(result[9]?.length).toBe(100);
   });
 });
+
+describe("uniqBy", () => {
+  it("should remove duplicates based on selector function", () => {
+    const users = [
+      { id: 1, name: "John" },
+      { id: 2, name: "Jane" },
+      { id: 1, name: "John" },
+    ];
+
+    const uniqueUsers = uniqBy(users, user => user.id);
+    expect(uniqueUsers).toEqual([
+      { id: 1, name: "John" },
+      { id: 2, name: "Jane" },
+    ]);
+  });
+
+  it("should handle empty array", () => {
+    const result = uniqBy([], item => item);
+    expect(result).toEqual([]);
+  });
+
+  it("should handle array with no duplicates", () => {
+    const numbers = [1, 2, 3, 4, 5];
+    const result = uniqBy(numbers, num => num);
+    expect(result).toEqual([1, 2, 3, 4, 5]);
+  });
+
+  it("should handle complex objects with custom selector", () => {
+    const items = [
+      { id: 1, data: { value: "a" } },
+      { id: 2, data: { value: "b" } },
+      { id: 1, data: { value: "c" } },
+    ];
+
+    const result = uniqBy(items, item => item.id);
+    expect(result).toEqual([
+      { id: 1, data: { value: "a" } },
+      { id: 2, data: { value: "b" } },
+    ]);
+  });
+});
+
+describe("generateHashFromCtx", () => {
+  it("should generate consistent hash for same context", () => {
+    const ctx = {
+      operations: {
+        array: [
+          { type: "operation1", data: "test1" },
+          { type: "operation2", data: "test2" },
+        ],
+      },
+      config: {},
+      histories: [],
+      stack: [],
+      prompt: "",
+      model: {},
+      tools: [],
+      messages: [],
+      state: {},
+      ready: true,
+      dispatch: () => {},
+      request: async () => Promise.resolve({}),
+      initialize: async () => Promise.resolve(),
+    } as unknown as AgenticaContext<any>;
+
+    const hash1 = generateHashFromCtx(ctx);
+    const hash2 = generateHashFromCtx(ctx);
+    expect(hash1).toBe(hash2);
+  });
+
+  it("should generate different hashes for different contexts", () => {
+    const ctx1 = {
+      operations: {
+        array: [{ type: "operation1", data: "test1" }],
+      },
+      config: {},
+      histories: [],
+      stack: [],
+      prompt: "",
+      model: {},
+      tools: [],
+      messages: [],
+      state: {},
+      ready: true,
+      dispatch: () => {},
+      request: async () => Promise.resolve({}),
+      initialize: async () => Promise.resolve(),
+    } as unknown as AgenticaContext<any>;
+
+    const ctx2 = {
+      operations: {
+        array: [{ type: "operation1", data: "test2" }],
+      },
+      config: {},
+      histories: [],
+      stack: [],
+      prompt: "",
+      model: {},
+      tools: [],
+      messages: [],
+      state: {},
+      ready: true,
+      dispatch: () => {},
+      request: async () => Promise.resolve({}),
+      initialize: async () => Promise.resolve(),
+    } as unknown as AgenticaContext<any>;
+
+    const hash1 = generateHashFromCtx(ctx1);
+    const hash2 = generateHashFromCtx(ctx2);
+    expect(hash1).not.toBe(hash2);
+  });
+
+  it("should handle empty operations array", () => {
+    const ctx = {
+      operations: {
+        array: [],
+      },
+      config: {},
+      histories: [],
+      stack: [],
+      prompt: "",
+      model: {},
+      tools: [],
+      messages: [],
+      state: {},
+      ready: true,
+      dispatch: () => {},
+      request: async () => Promise.resolve({}),
+      initialize: async () => Promise.resolve(),
+    } as unknown as AgenticaContext<any>;
+
+    const hash = generateHashFromCtx(ctx);
+    expect(typeof hash).toBe("string");
+    expect(hash.length).toBeGreaterThan(0);
+  });
+
+  it("should handle complex operation objects", () => {
+    const ctx = {
+      operations: {
+        array: [
+          {
+            type: "complex",
+            data: {
+              nested: {
+                value: 123,
+                array: [1, 2, 3],
+              },
+            },
+          },
+        ],
+      },
+      config: {},
+      histories: [],
+      stack: [],
+      prompt: "",
+      model: {},
+      tools: [],
+      messages: [],
+      state: {},
+      ready: true,
+      dispatch: () => {},
+      request: async () => Promise.resolve({}),
+      initialize: async () => Promise.resolve(),
+    } as unknown as AgenticaContext<any>;
+
+    const hash = generateHashFromCtx(ctx);
+    expect(typeof hash).toBe("string");
+    expect(hash.length).toBeGreaterThan(0);
+  });
+});

package/src/utils.ts

@@ -1,5 +1,10 @@
+import type { AgenticaContext } from "@agentica/core";
+import type { ILlmSchema } from "@samchon/openapi";
 import type { GreaterThan, Integer } from "type-fest";
 
+import { sha256 } from "@noble/hashes/sha2";
+import { utf8ToBytes } from "@noble/hashes/utils";
+
 /** type function to check if a number is greater than 0 */
 type GreaterThanZeroInteger<T extends number> = GreaterThan<Integer<T>, 0> extends true ? T : never;
 
@@ -103,3 +108,17 @@ export function uniqBy<T, K>(array: T[], selector: (item: T) => K): T[] {
     return true;
   });
 }
+
+/**
+ * Generates a hash from an Agentica ctx.operations.array.
+ *
+ * @param ctx - The Agentica context to generate a hash from
+ * @returns A hash of the Agentica context
+ */
+export function generateHashFromCtx<SchemaModel extends ILlmSchema.Model>(ctx: AgenticaContext<SchemaModel>): string {
+  const target = JSON.stringify(ctx.operations.array);
+  const bytes = utf8ToBytes(target);
+  const hash = sha256(bytes);
+  const binary = String.fromCharCode(...hash);
+  return btoa(binary);
+}

package/lib/embed.js

@@ -1,2 +0,0 @@
-"use strict";
-//# sourceMappingURL=embed.js.map

package/lib/embed.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":""}