@agentica/vector-selector 0.20.0

package/lib/index.mjs.map

@@ -0,0 +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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"}

package/lib/select.d.ts

@@ -0,0 +1,17 @@
+import type { AgenticaContext, AgenticaSelectHistory } from "@agentica/core";
+import type { ILlmSchema } from "@samchon/openapi";
+interface IFailure {
+    id: string;
+    name: string;
+    validation: {
+        data: string;
+        errors: string[];
+    };
+}
+export declare function selectFunction<SchemaModel extends ILlmSchema.Model>(props: {
+    ctx: AgenticaContext<SchemaModel>;
+    toolList: object[];
+    prevFailures?: IFailure[];
+    restRetry?: number;
+}): Promise<import("@agentica/core").AgenticaTextHistory<"assistant">[] | AgenticaSelectHistory<SchemaModel>[]>;
+export {};

package/lib/select.js

@@ -0,0 +1,197 @@
+"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.selectFunction = selectFunction;
+const core_1 = require("@agentica/core");
+const AgenticaDefaultPrompt_1 = require("@agentica/core/src/constants/AgenticaDefaultPrompt");
+const AgenticaSystemPrompt_1 = require("@agentica/core/src/constants/AgenticaSystemPrompt");
+const tools_1 = require("./tools");
+function selectFunction(props) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const { ctx, toolList, prevFailures = [], restRetry = 5 } = props;
+        const selectCompletion = yield ctx.request("select", {
+            messages: [
+                {
+                    role: "system",
+                    content: AgenticaDefaultPrompt_1.AgenticaDefaultPrompt.write(ctx.config),
+                },
+                {
+                    role: "assistant",
+                    tool_calls: [
+                        {
+                            type: "function",
+                            id: "getApiFunctions",
+                            function: {
+                                name: "getApiFunctions",
+                                arguments: JSON.stringify({}),
+                            },
+                        },
+                    ],
+                },
+                {
+                    role: "tool",
+                    tool_call_id: "getApiFunctions",
+                    content: JSON.stringify(toolList),
+                },
+                ...ctx.histories.flatMap((core_1.factory.decodeHistory)),
+                {
+                    role: "user",
+                    content: ctx.prompt.text,
+                },
+                {
+                    role: "system",
+                    content: `${(_d = (_c = (_b = (_a = ctx.config) === null || _a === void 0 ? void 0 : _a.systemPrompt) === null || _b === void 0 ? void 0 : _b.select) === null || _c === void 0 ? void 0 : _c.call(_b, ctx.histories)) !== null && _d !== void 0 ? _d : AgenticaSystemPrompt_1.AgenticaSystemPrompt.SELECT}
+          
+        
+        When selecting functions, consider what the user can call from their perspective, and choose all the functions necessary to accomplish the task.
+        Select them in a logical sequence, taking into account the relationships between each function.
+        `,
+                },
+                ...emendMessages(prevFailures),
+            ],
+            tool_choice: {
+                type: "function",
+                function: {
+                    name: "select_functions",
+                },
+            },
+            parallel_tool_calls: false,
+            tools: [tools_1.Tools.select_functions],
+        })
+            .then((v) => __awaiter(this, void 0, void 0, function* () { return core_1.utils.StreamUtil.readAll(v); }))
+            .then(core_1.utils.ChatGptCompletionMessageUtil.merge);
+        const toolCalls = selectCompletion.choices
+            .filter(v => v.message.tool_calls != null);
+        if (toolCalls.length === 0) {
+            return selectCompletion.choices.flatMap((v) => {
+                if (v.message.content != null && v.message.content !== "") {
+                    return [core_1.factory.createTextHistory({ role: "assistant", text: v.message.content })];
+                }
+                return [];
+            });
+        }
+        const failures = toolCalls.reduce((acc, cur) => {
+            var _a;
+            (_a = cur.message.tool_calls) === null || _a === void 0 ? void 0 : _a.forEach((tc) => {
+                const errors = [];
+                const arg = JSON.parse(tc.function.arguments);
+                if (!Array.isArray(arg)) {
+                    errors.push(JSON.stringify({
+                        path: "$input",
+                        expected: "array",
+                        value: arg,
+                    }));
+                    return;
+                }
+                arg.forEach((v, idx) => {
+                    if (v.reason == null || typeof v.reason !== "string") {
+                        errors.push(JSON.stringify({
+                            path: `$$input[${idx}].reason`,
+                            expected: "string",
+                            value: v.reason,
+                        }));
+                    }
+                    if (v.function_name == null || typeof v.function_name !== "string") {
+                        errors.push(JSON.stringify({
+                            path: `$$input[${idx}].function_name`,
+                            expected: "string",
+                            value: v.function_name,
+                        }));
+                    }
+                });
+                if (errors.length !== 0) {
+                    acc.push({
+                        id: tc.id,
+                        name: tc.function.name,
+                        validation: { data: tc.function.arguments, errors },
+                    });
+                }
+            });
+            return acc;
+        }, []);
+        if (failures.length !== 0) {
+            const feedback = [...prevFailures, ...failures];
+            if (restRetry === 0) {
+                throw new Error(`Failed to select function after ${restRetry} retries\n${JSON.stringify(feedback)}`);
+            }
+            return selectFunction({
+                ctx,
+                toolList,
+                prevFailures: feedback,
+                restRetry: restRetry - 1,
+            });
+        }
+        const prompts = [];
+        toolCalls.forEach((v) => {
+            v.message.tool_calls.forEach((tc) => {
+                const collection = {
+                    type: "select",
+                    id: tc.id,
+                    selections: [],
+                    toJSON: () => ({
+                        type: "select",
+                        id: tc.id,
+                        selections: collection.selections.map(s => s.toJSON()),
+                    }),
+                };
+                const arg = JSON.parse(tc.function.arguments);
+                arg.function_list.forEach((v) => {
+                    const operation = ctx.operations.flat.get(v.function_name);
+                    if (operation === undefined) {
+                        return;
+                    }
+                    const selection = core_1.factory.createOperationSelection({
+                        reason: v.reason,
+                        operation,
+                    });
+                    ctx.stack.push(selection);
+                    ctx.dispatch(core_1.factory.createSelectEvent({ selection })).catch(() => { });
+                    collection.selections.push(selection);
+                });
+                prompts.push(collection);
+            });
+        });
+        return prompts;
+    });
+}
+function emendMessages(failures) {
+    return failures
+        .flatMap(f => [
+        {
+            role: "assistant",
+            tool_calls: [
+                {
+                    type: "function",
+                    id: f.id,
+                    function: {
+                        name: f.name,
+                        arguments: JSON.stringify(f.validation.data),
+                    },
+                },
+            ],
+        },
+        {
+            role: "tool",
+            content: JSON.stringify(f.validation.errors),
+            tool_call_id: f.id,
+        },
+        {
+            role: "system",
+            content: [
+                "You A.I. assistant has composed wrong typed arguments.",
+                "",
+                "Correct it at the next function calling.",
+            ].join("\n"),
+        },
+    ]);
+}
+//# sourceMappingURL=select.js.map

package/lib/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":";;;;;;;;;;;AAkBA,wCAsKC;AArLD,yCAAgD;AAChD,8FAA2F;AAC3F,4FAAyF;AAEzF,mCAAgC;AAWhC,SAAsB,cAAc,CAAuC,KAK1E;;;QACC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,GAAG,EAAE,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,KAAK,CAAC;QAClE,MAAM,gBAAgB,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;YACnD,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,6CAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;iBACjD;gBACD;oBACE,IAAI,EAAE,WAAW;oBACjB,UAAU,EAAE;wBACV;4BACE,IAAI,EAAE,UAAU;4BAChB,EAAE,EAAE,iBAAiB;4BACrB,QAAQ,EAAE;gCACR,IAAI,EAAE,iBAAiB;gCACvB,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;6BAC9B;yBACF;qBACF;iBACF;gBACD;oBACE,IAAI,EAAE,MAAM;oBACZ,YAAY,EAAE,iBAAiB;oBAC/B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;iBAClC;gBACD,GAAG,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA,cAAO,CAAC,aAA0B,CAAA,CAAC;gBAC5D;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI;iBACzB;gBACD;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,GAAG,MAAA,MAAA,MAAA,MAAA,GAAG,CAAC,MAAM,0CAAE,YAAY,0CAAE,MAAM,mDAAG,GAAG,CAAC,SAAS,CAAC,mCAC1D,2CAAoB,CAAC,MAAM;;;;;SAK7B;iBACF;gBACD,GAAG,aAAa,CAAC,YAAY,CAAC;aAC/B;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,UAAU;gBAChB,QAAQ,EAAE;oBACR,IAAI,EAAE,kBAAkB;iBACzB;aACF;YACD,mBAAmB,EAAE,KAAK;YAC1B,KAAK,EAAE,CAAC,aAAK,CAAC,gBAAgB,CAAC;SAChC,CAAC;aACC,IAAI,CAAC,CAAM,CAAC,EAAC,EAAE,gDAAC,OAAA,YAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA,GAAA,CAAC;aAC5C,IAAI,CAAC,YAAK,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;QAElD,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO;aACvC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;QAE7C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC5C,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;oBAC1D,OAAO,CAAC,cAAO,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACrF,CAAC;gBACD,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAa,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;;YACzD,MAAA,GAAG,CAAC,OAAO,CAAC,UAAU,0CAAE,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;gBACrC,MAAM,MAAM,GAAa,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAyD,CAAC;gBACtG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;wBACzB,IAAI,EAAE,QAAQ;wBACd,QAAQ,EAAE,OAAO;wBACjB,KAAK,EAAE,GAAG;qBACX,CAAC,CAAC,CAAC;oBACJ,OAAO;gBACT,CAAC;gBACD,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;oBACrB,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;wBACrD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;4BACzB,IAAI,EAAE,WAAW,GAAG,UAAU;4BAC9B,QAAQ,EAAE,QAAQ;4BAClB,KAAK,EAAE,CAAC,CAAC,MAAM;yBAChB,CAAC,CAAC,CAAC;oBACN,CAAC;oBAED,IAAI,CAAC,CAAC,aAAa,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;wBACnE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;4BACzB,IAAI,EAAE,WAAW,GAAG,iBAAiB;4BACrC,QAAQ,EAAE,QAAQ;4BAClB,KAAK,EAAE,CAAC,CAAC,aAAa;yBACvB,CAAC,CAAC,CAAC;oBACN,CAAC;gBACH,CAAC,CAAC,CAAC;gBAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,GAAG,CAAC,IAAI,CAAC;wBACP,EAAE,EAAE,EAAE,CAAC,EAAE;wBACT,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI;wBACtB,UAAU,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE;qBACpD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,QAAQ,CAAC,CAAC;YAChD,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,mCAAmC,SAAS,aAAa,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACvG,CAAC;YAED,OAAO,cAAc,CAAC;gBACpB,GAAG;gBACH,QAAQ;gBACR,YAAY,EAAE,QAAQ;gBACtB,SAAS,EAAE,SAAS,GAAG,CAAC;aACzB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,OAAO,GAAyC,EAAE,CAAC;QACzD,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,CAAC,CAAC,OAAO,CAAC,UAAW,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;gBACnC,MAAM,UAAU,GAAuC;oBACrD,IAAI,EAAE,QAAQ;oBACd,EAAE,EAAE,EAAE,CAAC,EAAE;oBACT,UAAU,EAAE,EAAE;oBACd,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;wBACb,IAAI,EAAE,QAAQ;wBACd,EAAE,EAAE,EAAE,CAAC,EAAE;wBACT,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;qBACvD,CAAC;iBACH,CAAC;gBACF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAK3C,CAAC;gBACF,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;oBAE3D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;wBAC5B,OAAO;oBACT,CAAC;oBACD,MAAM,SAAS,GACX,cAAO,CAAC,wBAAwB,CAAC;wBACjC,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,SAAS;qBACV,CAAC,CAAC;oBACL,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBAC1B,GAAG,CAAC,QAAQ,CAAC,cAAO,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACvE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxC,CAAC,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;CAAA;AAED,SAAS,aAAa,CAAuC,QAAoB;IAC/E,OAAO,QAAQ;SACZ,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACZ;YACE,IAAI,EAAE,WAAW;YACjB,UAAU,EAAE;gBACV;oBACE,IAAI,EAAE,UAAU;oBAChB,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,QAAQ,EAAE;wBACR,IAAI,EAAE,CAAC,CAAC,IAAI;wBACZ,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;qBAC7C;iBACF;aACF;SACF;QACD;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;YAC5C,YAAY,EAAE,CAAC,CAAC,EAAE;SACnB;QACD;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,wDAAwD;gBACxD,EAAE;gBACF,0CAA0C;aAC3C,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;KACF,CAAiE,CAAC;AACvE,CAAC"}

package/lib/strategy/index.d.ts

@@ -0,0 +1 @@
+export * from "./postgres.strategy";

package/lib/strategy/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./postgres.strategy"), exports);
+//# sourceMappingURL=index.js.map

package/lib/strategy/index.js.map

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

package/lib/strategy/postgres.strategy.d.ts

@@ -0,0 +1,4 @@
+import type { ILlmSchema } from "@samchon/openapi";
+import type { IConnection } from "@wrtnlabs/connector-hive-api";
+import type { IAgenticaVectorSelectorStrategy } from "..";
+export declare function configurePostgresStrategy<SchemaModel extends ILlmSchema.Model>(connection: IConnection<object | undefined>): IAgenticaVectorSelectorStrategy<SchemaModel>;

package/lib/strategy/postgres.strategy.js

@@ -0,0 +1,87 @@
+"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.configurePostgresStrategy = configurePostgresStrategy;
+const connector_hive_api_1 = require("@wrtnlabs/connector-hive-api");
+const utils_1 = require("../utils");
+const retry = (0, utils_1.getRetry)(3);
+const filterMap = new Map();
+function searchTool(connection) {
+    return (ctx, query) => __awaiter(this, void 0, void 0, function* () {
+        const filter = filterMap.get(JSON.stringify(ctx.operations.array));
+        return retry(() => __awaiter(this, void 0, void 0, function* () {
+            return connector_hive_api_1.functional.connector_retrievals.createRetrievalRequest(connection, {
+                query,
+                limit: 10,
+                filter,
+            });
+        }));
+    });
+}
+function embedOperation(connection) {
+    return (controllerName, opList) => __awaiter(this, void 0, void 0, function* () {
+        const application = yield retry(() => __awaiter(this, void 0, void 0, function* () {
+            return connector_hive_api_1.functional.applications.create(connection, {
+                name: controllerName,
+                description: undefined,
+            });
+        })).catch((e) => __awaiter(this, void 0, void 0, function* () {
+            if (!(e instanceof connector_hive_api_1.HttpError)) {
+                throw e;
+            }
+            if (e.status !== 409) {
+                throw e;
+            }
+            return retry(() => __awaiter(this, void 0, void 0, function* () {
+                return connector_hive_api_1.functional.applications.by_names.getByName(connection, controllerName);
+            }));
+        }));
+        const version = yield retry(() => __awaiter(this, void 0, void 0, function* () {
+            return connector_hive_api_1.functional.applications.by_ids.versions.create(connection, application.id, {});
+        }));
+        // concurrency request count
+        yield (0, utils_1.groupByArray)(opList, 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 retry(() => __awaiter(this, void 0, void 0, function* () {
+                    var _a;
+                    return connector_hive_api_1.functional.application_versions.by_ids.connectors.create(connection, version.id, { name: v.name, description: (_a = v.function.description) !== null && _a !== void 0 ? _a : "" });
+                }));
+            })));
+            return Promise.resolve();
+        }), Promise.resolve());
+        return { version, applicationId: application.id };
+    });
+}
+function embedContext(connection) {
+    return (props) => __awaiter(this, void 0, void 0, function* () {
+        const { ctx, setEmbedded } = props;
+        const filter = yield Promise.all(Array.from(ctx.operations.group.entries()).map((_a) => __awaiter(this, [_a], void 0, function* ([key, value]) {
+            const result = yield embedOperation(connection)(key, Array.from(value.values()));
+            return {
+                id: result.applicationId,
+                version: result.version.version,
+                type: "byId",
+            };
+        })));
+        filterMap.set(JSON.stringify(ctx.operations.array), {
+            applications: filter,
+        });
+        setEmbedded();
+    });
+}
+function configurePostgresStrategy(connection) {
+    return {
+        searchTool: searchTool(connection),
+        embedContext: embedContext(connection),
+    };
+}
+//# sourceMappingURL=postgres.strategy.js.map

package/lib/strategy/postgres.strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.strategy.js","sourceRoot":"","sources":["../../src/strategy/postgres.strategy.ts"],"names":[],"mappings":";;;;;;;;;;;AA+GA,8DAKC;AA/GD,qEAAqE;AAIrE,oCAAkD;AAElD,MAAM,KAAK,GAAG,IAAA,gBAAQ,EAAC,CAAC,CAAC,CAAC;AAE1B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkD,CAAC;AAC5E,SAAS,UAAU,CAAuC,UAA2C;IACnG,OAAO,CAAO,GAAiC,EAAE,KAAa,EAAE,EAAE;QAChE,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,OAAO,KAAK,CAAC,GAAS,EAAE;YACtB,OAAA,+BAAU,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,UAAU,EAAE;gBACjE,KAAK;gBACL,KAAK,EAAE,EAAE;gBACT,MAAM;aACP,CAAC,CAAA;UAAA,CACH,CAAC;IACJ,CAAC,CAAA,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,UAA2C;IACjE,OAAO,CACL,cAAsB,EACtB,MAAwC,EACxC,EAAE;QACF,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,GAAS,EAAE;YACzC,OAAA,+BAAU,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,EAAE;gBACzC,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,SAAS;aACvB,CAAC,CAAA;UAAA,CACH,CAAC,KAAK,CAAC,CAAO,CAAC,EAAE,EAAE;YAClB,IAAI,CAAC,CAAC,CAAC,YAAY,8BAAS,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,CAAC;YACV,CAAC;YACD,IAAI,CAAC,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrB,MAAM,CAAC,CAAC;YACV,CAAC;YAED,OAAO,KAAK,CAAC,GAAS,EAAE;gBACtB,OAAA,+BAAU,CAAC,YAAY,CAAC,QAAQ,CAAC,SAAS,CACxC,UAAU,EACV,cAAc,CACf,CAAA;cAAA,CACF,CAAC;QACJ,CAAC,CAAA,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,GAAS,EAAE;YACrC,OAAA,+BAAU,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC5C,UAAU,EACV,WAAW,CAAC,EAAE,EACd,EAAE,CACH,CAAA;UAAA,CACF,CAAC;QAEF,4BAA4B;QAC5B,MAAM,IAAA,oBAAY,EAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAO,UAAU,EAAE,GAAG,EAAE,EAAE;YAC9D,MAAM,UAAU,CAAC;YACjB,MAAM,OAAO,CAAC,GAAG,CACf,GAAG,CAAC,GAAG,CAAC,CAAM,CAAC,EAAC,EAAE;gBAChB,OAAA,KAAK,CAAC,GAAS,EAAE;;oBACf,OAAA,+BAAU,CAAC,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CACtD,UAAU,EACV,OAAO,CAAC,EAAE,EACV,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,MAAA,CAAC,CAAC,QAAQ,CAAC,WAAW,mCAAI,EAAE,EAAE,CAC5D,CAAA;kBAAA,CACF,CAAA;cAAA,CACF,CACF,CAAC;YACF,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC,CAAA,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAEtB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC;IACpD,CAAC,CAAA,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAuC,UAA2C;IACrG,OAAO,CAAO,KAAqE,EAAE,EAAE;QACrF,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAC5C,KAGG,EAAE,0CAHE,CAAC,GAAG,EAAE,KAAK,CAGjB;YACC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC,CAC7C,GAAG,EACH,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAC3B,CAAC;YAEF,OAAO;gBACL,EAAE,EAAE,MAAM,CAAC,aAAa;gBACxB,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO;gBAC/B,IAAI,EAAE,MAAM;aACmD,CAAC;QACpE,CAAC,CAAA,CACF,CACF,CAAC;QACF,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YAClD,YAAY,EAAE,MAAM;SACrB,CAAC,CAAC;QACH,WAAW,EAAE,CAAC;IAChB,CAAC,CAAA,CAAC;AACJ,CAAC;AAED,SAAgB,yBAAyB,CAAuC,UAA2C;IACzH,OAAO;QACL,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;QAClC,YAAY,EAAE,YAAY,CAAC,UAAU,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/lib/tools.d.ts

@@ -0,0 +1,62 @@
+export declare const Tools: {
+    readonly extract_query: {
+        readonly type: "function";
+        readonly function: {
+            readonly name: "extract_search_query";
+            readonly description: "extract search query from user message\n";
+            readonly parameters: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly query_list: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly reason: {
+                                    readonly type: "string";
+                                    readonly description: "The reason of the query selection.\n\nJust write the reason why you've determined to select this query.";
+                                };
+                                readonly query: {
+                                    readonly type: "string";
+                                    readonly description: "the search query";
+                                };
+                            };
+                            readonly required: readonly ["reason", "query"];
+                        };
+                    };
+                };
+                readonly required: readonly ["query_list"];
+            };
+        };
+    };
+    readonly select_functions: {
+        readonly type: "function";
+        readonly function: {
+            readonly name: "select_functions";
+            readonly description: "Select proper API functions to call.\n\nIf you A.I. agent has found some proper API functions to call\nfrom the conversation with user, please select the API functions\njust by calling this function.\n\nWhen user wants to call a same function multiply, you A.I. agent must\nlist up it multiply in the `functions` property. Otherwise the user has\nrequested to call many different functions, you A.I. agent have to assign\nthem all into the `functions` property.\n\nAlso, if you A.I. agent can't specify a specific function to call due to lack\nof specificity or homogeneity of candidate functions, just assign all of them\nby in the `functions` property too. Instead, when you A.I. agent can specify\na specific function to call, the others would be eliminated.\n\n@example\n```json\n[\n  {\n    \"reason\": \"The user wants to call the function multiply.\",\n    \"function_name\": \"get_user_info\"\n  },\n  {\n    \"reason\": \"The user wants to modify the user info.\",\n    \"function_name\": \"modify_user_info\"\n  }\n]\n```\n";
+            readonly parameters: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly function_list: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly reason: {
+                                    readonly type: "string";
+                                    readonly description: "The reason of the function selection.\n\nJust write the reason why you've determined to select this function.";
+                                };
+                                readonly function_name: {
+                                    readonly type: "string";
+                                    readonly description: "Name of the target function to call.";
+                                };
+                            };
+                            readonly required: readonly ["reason", "function_name"];
+                        };
+                    };
+                };
+                readonly required: readonly ["function_list"];
+            };
+        };
+    };
+};

package/lib/tools.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tools = void 0;
+exports.Tools = {
+    extract_query: {
+        type: "function",
+        function: {
+            name: "extract_search_query",
+            description: "extract search query from user message\n",
+            parameters: {
+                type: "object",
+                properties: {
+                    query_list: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                reason: {
+                                    type: "string",
+                                    description: "The reason of the query selection.\n\nJust write the reason why you've determined to select this query.",
+                                },
+                                query: {
+                                    type: "string",
+                                    description: "the search query",
+                                },
+                            },
+                            required: ["reason", "query"],
+                        },
+                    },
+                },
+                required: ["query_list"],
+            },
+        },
+    },
+    select_functions: {
+        type: "function",
+        function: {
+            name: "select_functions",
+            description: `Select proper API functions to call.
+
+If you A.I. agent has found some proper API functions to call
+from the conversation with user, please select the API functions
+just by calling this function.
+
+When user wants to call a same function multiply, you A.I. agent must
+list up it multiply in the \`functions\` property. Otherwise the user has
+requested to call many different functions, you A.I. agent have to assign
+them all into the \`functions\` property.
+
+Also, if you A.I. agent can't specify a specific function to call due to lack
+of specificity or homogeneity of candidate functions, just assign all of them
+by in the \`functions\` property too. Instead, when you A.I. agent can specify
+a specific function to call, the others would be eliminated.
+
+@example
+\`\`\`json
+[
+  {
+    "reason": "The user wants to call the function multiply.",
+    "function_name": "get_user_info"
+  },
+  {
+    "reason": "The user wants to modify the user info.",
+    "function_name": "modify_user_info"
+  }
+]
+\`\`\`
+`,
+            parameters: {
+                type: "object",
+                properties: {
+                    function_list: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            properties: {
+                                reason: {
+                                    type: "string",
+                                    description: "The reason of the function selection.\n\nJust write the reason why you've determined to select this function.",
+                                },
+                                function_name: {
+                                    type: "string",
+                                    description: "Name of the target function to call.",
+                                },
+                            },
+                            required: ["reason", "function_name"],
+                        },
+                    },
+                },
+                required: ["function_list"],
+            },
+        },
+    },
+};
+//# sourceMappingURL=tools.js.map

package/lib/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":";;;AAEa,QAAA,KAAK,GAAG;IACnB,aAAa,EAAE;QACb,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,sBAAsB;YAC5B,WAAW,EAAE,0CAA0C;YACvD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,UAAU,EAAE;wBACV,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ;oCACd,WAAW,EAAE,yGAAyG;iCACvH;gCACD,KAAK,EAAE;oCACL,IAAI,EAAE,QAAQ;oCACd,WAAW,EAAE,kBAAkB;iCAChC;6BACF;4BACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;yBAC9B;qBACF;iBACF;gBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;aACzB;SACF;KACF;IAED,gBAAgB,EAAE;QAChB,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACR,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BlB;YACK,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACV,aAAa,EAAE;wBACb,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE;gCACV,MAAM,EAAE;oCACN,IAAI,EAAE,QAAQ;oCACd,WAAW,EAAE,+GAA+G;iCAC7H;gCACD,aAAa,EAAE;oCACb,IAAI,EAAE,QAAQ;oCACd,WAAW,EAAE,sCAAsC;iCACpD;6BACF;4BACD,QAAQ,EAAE,CAAC,QAAQ,EAAE,eAAe,CAAC;yBACtC;qBACF;iBACF;gBACD,QAAQ,EAAE,CAAC,eAAe,CAAC;aAC5B;SACF;KACF;CAMF,CAAC"}

package/lib/utils.d.ts

@@ -0,0 +1,52 @@
+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;
+/**
+ * This function is used to get a retry function.
+ *
+ * It will throw an error if the count is not a number,
+ * or if the count is not a finite number,
+ * or if the count is not an integer,
+ * or if the count is less than 1.
+ *
+ * @param count - The number of times to retry the function.
+ * @returns A retry function.
+ * @throws {TypeError} If the count is not a number, or if the count is not a finite number, or if the count is not an integer, or if the count is less than 1.
+ * @throws {Error} If the function fails to return a value after the specified number of retries.
+ */
+export declare function getRetry<TCount extends number>(count: GreaterThanZeroInteger<TCount>): <T>(fn: () => Promise<T>) => Promise<T>;
+/**
+ * This function is used to group an array into a 2-dimensional array.
+ *
+ * It will throw an error if the count is not a number,
+ * or if the count is not a finite number,
+ * or if the count is not an integer,
+ * or if the count is less than 1.
+ *
+ * @param array - The array to group.
+ * @param count - The number of elements in each group.
+ * @returns A 2-dimensional array.
+ */
+export declare function groupByArray<T, TCount extends number>(array: T[], count: GreaterThanZeroInteger<TCount>): T[][];
+/**
+ * Removes duplicates from an array.
+ * You can specify which value to compare using a property selector function.
+ *
+ * @param array - Array to remove duplicates from
+ * @param selector - Function that selects the value to compare
+ * @returns New array with duplicates removed
+ *
+ * @example
+ * ```typescript
+ * const users = [
+ *   { id: 1, name: 'John' },
+ *   { id: 2, name: 'Jane' },
+ *   { id: 1, name: 'John' }
+ * ];
+ *
+ * const uniqueUsers = uniqBy(users, user => user.id);
+ * // Result: [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]
+ * ```
+ */
+export declare function uniqBy<T, K>(array: T[], selector: (item: T) => K): T[];
+export {};