@mate-academy/llm-gateway 6.0.0 → 6.2.0

package/dist/services/fileStorage/FileStorageToolExecutor.js.map

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

package/dist/services/fileStorage/InMemoryFileStorage.d.ts

@@ -0,0 +1,20 @@
+import { type LLMUploadFileMimeTypes } from '../../LLMService.typedefs';
+interface StoredFile {
+    fileId: string;
+    name: string;
+    path: string;
+    mimeType: LLMUploadFileMimeTypes;
+    content: string;
+}
+export declare class InMemoryFileStorage {
+    private files;
+    private filesByPath;
+    private storages;
+    addFile(path: string, name: string, mimeType: LLMUploadFileMimeTypes): StoredFile;
+    getFileByPath(path: string): StoredFile | null;
+    removeFile(fileId: string): void;
+    createStorage(fileIds: string[]): string;
+    removeStorage(storageId: string): void;
+    getStorageFiles(storageId: string): StoredFile[];
+}
+export {};

package/dist/services/fileStorage/InMemoryFileStorage.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryFileStorage = void 0;
+const fs_1 = require("fs");
+const uuid_1 = require("uuid");
+class InMemoryFileStorage {
+    files = new Map();
+    filesByPath = new Map();
+    storages = new Map();
+    addFile(path, name, mimeType) {
+        const existing = this.filesByPath.get(path);
+        if (existing) {
+            return existing;
+        }
+        const content = (0, fs_1.readFileSync)(path, 'utf-8');
+        const fileId = (0, uuid_1.v4)();
+        const storedFile = {
+            fileId,
+            name,
+            path,
+            mimeType,
+            content,
+        };
+        this.files.set(fileId, storedFile);
+        this.filesByPath.set(path, storedFile);
+        return storedFile;
+    }
+    getFileByPath(path) {
+        return this.filesByPath.get(path) ?? null;
+    }
+    removeFile(fileId) {
+        const file = this.files.get(fileId);
+        if (!file) {
+            return;
+        }
+        this.filesByPath.delete(file.path);
+        this.files.delete(fileId);
+    }
+    createStorage(fileIds) {
+        const storageId = (0, uuid_1.v4)();
+        this.storages.set(storageId, {
+            storageId,
+            fileIds,
+        });
+        return storageId;
+    }
+    removeStorage(storageId) {
+        const group = this.storages.get(storageId);
+        if (group) {
+            for (const fileId of group.fileIds) {
+                this.removeFile(fileId);
+            }
+        }
+        this.storages.delete(storageId);
+    }
+    getStorageFiles(storageId) {
+        const group = this.storages.get(storageId);
+        if (!group) {
+            return [];
+        }
+        return group.fileIds
+            .map((fileId) => this.files.get(fileId))
+            .filter((file) => file !== undefined);
+    }
+}
+exports.InMemoryFileStorage = InMemoryFileStorage;
+//# sourceMappingURL=InMemoryFileStorage.js.map

package/dist/services/fileStorage/InMemoryFileStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryFileStorage.js","sourceRoot":"","sources":["../../../src/services/fileStorage/InMemoryFileStorage.ts"],"names":[],"mappings":";;;AAAA,2BAAkC;AAClC,+BAAoC;AAgBpC,MAAa,mBAAmB;IACtB,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,QAAQ,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEvD,OAAO,CACL,IAAY,EACZ,IAAY,EACZ,QAAgC;QAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,IAAA,SAAM,GAAE,CAAC;QAExB,MAAM,UAAU,GAAe;YAC7B,MAAM;YACN,IAAI;YACJ,IAAI;YACJ,QAAQ;YACR,OAAO;SACR,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEvC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,aAAa,CAAC,OAAiB;QAC7B,MAAM,SAAS,GAAG,IAAA,SAAM,GAAE,CAAC;QAE3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE;YAC3B,SAAS;YACT,OAAO;SACR,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBACnC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,eAAe,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,KAAK,CAAC,OAAO;aACjB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;aACvC,MAAM,CAAC,CAAC,IAAI,EAAsB,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAlFD,kDAkFC"}

package/dist/services/fileStorage/fileStorageTools.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { ChatCompletionTool } from 'openai/resources/chat';
+export declare enum FileStorageToolName {
+    ListFiles = "list_files",
+    SearchFiles = "search_files",
+    ReadFile = "read_file",
+    ReadFileLines = "read_file_lines"
+}
+declare const searchFilesParameters: z.ZodObject<{
+    query: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    context_lines: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const readFileParameters: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+declare const readFileLinesParameters: z.ZodObject<{
+    path: z.ZodString;
+    start_line: z.ZodOptional<z.ZodNumber>;
+    end_line: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type SearchFilesArgs = z.infer<typeof searchFilesParameters>;
+export type ReadFileArgs = z.infer<typeof readFileParameters>;
+export type ReadFileLinesArgs = z.infer<typeof readFileLinesParameters>;
+export declare function getFileStorageToolsForChatCompletions(): ChatCompletionTool[];
+export {};

package/dist/services/fileStorage/fileStorageTools.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageToolName = void 0;
+exports.getFileStorageToolsForChatCompletions = getFileStorageToolsForChatCompletions;
+const zod_1 = require("zod");
+var FileStorageToolName;
+(function (FileStorageToolName) {
+    FileStorageToolName["ListFiles"] = "list_files";
+    FileStorageToolName["SearchFiles"] = "search_files";
+    FileStorageToolName["ReadFile"] = "read_file";
+    FileStorageToolName["ReadFileLines"] = "read_file_lines";
+})(FileStorageToolName || (exports.FileStorageToolName = FileStorageToolName = {}));
+const listFilesParameters = zod_1.z.object({});
+const searchFilesParameters = zod_1.z.object({
+    query: zod_1.z.string().describe('The search query string to find in file contents'),
+    path: zod_1.z.string().optional().describe('Optional file path filter to narrow the search scope'),
+    context_lines: zod_1.z.number().optional().describe('Number of context lines to show around each match (default: 3)'),
+});
+const readFileParameters = zod_1.z.object({
+    path: zod_1.z.string().describe('The path of the file to read'),
+});
+const readFileLinesParameters = zod_1.z.object({
+    path: zod_1.z.string().describe('The path of the file to read'),
+    start_line: zod_1.z.number().optional().describe('The 1-based starting line number to read from'),
+    end_line: zod_1.z.number().optional().describe('The 1-based ending line number to read to (inclusive). '
+        + 'Negative values read from end of file.'),
+});
+const FILE_STORAGE_TOOLS = [
+    {
+        name: FileStorageToolName.ListFiles,
+        description: 'List all files available in the file storage with their '
+            + 'names, paths, and line counts.',
+        parametersSchema: listFilesParameters,
+    },
+    {
+        name: FileStorageToolName.SearchFiles,
+        description: 'Search for a query string across all files in the storage. '
+            + 'Returns matching lines with surrounding context.',
+        parametersSchema: searchFilesParameters,
+    },
+    {
+        name: FileStorageToolName.ReadFile,
+        description: 'Read the entire contents of a file from the storage.',
+        parametersSchema: readFileParameters,
+    },
+    {
+        name: FileStorageToolName.ReadFileLines,
+        description: 'Read specific lines from a file in the storage. '
+            + 'Supports line ranges and reading from end of file.',
+        parametersSchema: readFileLinesParameters,
+    },
+];
+const FILE_STORAGE_CHAT_COMPLETION_TOOLS = FILE_STORAGE_TOOLS.map((tool) => ({
+    type: 'function',
+    function: {
+        name: tool.name,
+        description: tool.description,
+        parameters: zod_1.z.toJSONSchema(tool.parametersSchema, {
+            target: 'draft-7',
+            reused: 'inline',
+        }),
+    },
+}));
+function getFileStorageToolsForChatCompletions() {
+    return FILE_STORAGE_CHAT_COMPLETION_TOOLS;
+}
+//# sourceMappingURL=fileStorageTools.js.map

package/dist/services/fileStorage/fileStorageTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileStorageTools.js","sourceRoot":"","sources":["../../../src/services/fileStorage/fileStorageTools.ts"],"names":[],"mappings":";;;AAsFA,sFAGC;AAzFD,6BAAwB;AAGxB,IAAY,mBAKX;AALD,WAAY,mBAAmB;IAC7B,+CAAwB,CAAA;IACxB,mDAA4B,CAAA;IAC5B,6CAAsB,CAAA;IACtB,wDAAiC,CAAA;AACnC,CAAC,EALW,mBAAmB,mCAAnB,mBAAmB,QAK9B;AAED,MAAM,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEzC,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACxB,kDAAkD,CACnD;IACD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAClC,sDAAsD,CACvD;IACD,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAC3C,gEAAgE,CACjE;CACF,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACvB,8BAA8B,CAC/B;CACF,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACvB,8BAA8B,CAC/B;IACD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACxC,+CAA+C,CAChD;IACD,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CACtC,yDAAyD;UACvD,wCAAwC,CAC3C;CACF,CAAC,CAAC;AAMH,MAAM,kBAAkB,GAAG;IACzB;QACE,IAAI,EAAE,mBAAmB,CAAC,SAAS;QACnC,WAAW,EAAE,0DAA0D;cACnE,gCAAgC;QACpC,gBAAgB,EAAE,mBAAmB;KACtC;IACD;QACE,IAAI,EAAE,mBAAmB,CAAC,WAAW;QACrC,WAAW,EAAE,6DAA6D;cACtE,kDAAkD;QACtD,gBAAgB,EAAE,qBAAqB;KACxC;IACD;QACE,IAAI,EAAE,mBAAmB,CAAC,QAAQ;QAClC,WAAW,EAAE,sDAAsD;QACnE,gBAAgB,EAAE,kBAAkB;KACrC;IACD;QACE,IAAI,EAAE,mBAAmB,CAAC,aAAa;QACvC,WAAW,EAAE,kDAAkD;cAC3D,oDAAoD;QACxD,gBAAgB,EAAE,uBAAuB;KAC1C;CACO,CAAC;AAEX,MAAM,kCAAkC,GACpC,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAClC,IAAI,EAAE,UAAmB;IACzB,QAAQ,EAAE;QACR,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,OAAC,CAAC,YAAY,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAChD,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,QAAQ;SACjB,CAAC;KACH;CACF,CAAC,CAAC,CAAC;AAEN,SAAgB,qCAAqC;IAEnD,OAAO,kCAAkC,CAAC;AAC5C,CAAC"}

package/dist/services/fileStorage/index.d.ts

@@ -0,0 +1,4 @@
+export { InMemoryFileStorage } from './InMemoryFileStorage';
+export { FileStorageToolExecutor } from './FileStorageToolExecutor';
+export { getFileStorageToolsForChatCompletions, FileStorageToolName, } from './fileStorageTools';
+export type { SearchFilesArgs, ReadFileArgs, ReadFileLinesArgs, } from './fileStorageTools';

package/dist/services/fileStorage/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileStorageToolName = exports.getFileStorageToolsForChatCompletions = exports.FileStorageToolExecutor = exports.InMemoryFileStorage = void 0;
+var InMemoryFileStorage_1 = require("./InMemoryFileStorage");
+Object.defineProperty(exports, "InMemoryFileStorage", { enumerable: true, get: function () { return InMemoryFileStorage_1.InMemoryFileStorage; } });
+var FileStorageToolExecutor_1 = require("./FileStorageToolExecutor");
+Object.defineProperty(exports, "FileStorageToolExecutor", { enumerable: true, get: function () { return FileStorageToolExecutor_1.FileStorageToolExecutor; } });
+var fileStorageTools_1 = require("./fileStorageTools");
+Object.defineProperty(exports, "getFileStorageToolsForChatCompletions", { enumerable: true, get: function () { return fileStorageTools_1.getFileStorageToolsForChatCompletions; } });
+Object.defineProperty(exports, "FileStorageToolName", { enumerable: true, get: function () { return fileStorageTools_1.FileStorageToolName; } });
+//# sourceMappingURL=index.js.map

package/dist/services/fileStorage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/fileStorage/index.ts"],"names":[],"mappings":";;;AAAA,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA;AAChC,uDAG4B;AAF1B,yIAAA,qCAAqC,OAAA;AACrC,uHAAA,mBAAmB,OAAA"}

package/dist/utilities/index.d.ts

@@ -5,3 +5,4 @@ export * from './logger';
 export * from './reporter';
 export * from './schema';
 export * from './serializeError';
+export * from './tools';

package/dist/utilities/index.js

@@ -21,4 +21,5 @@ __exportStar(require("./logger"), exports);
 __exportStar(require("./reporter"), exports);
 __exportStar(require("./schema"), exports);
 __exportStar(require("./serializeError"), exports);
+__exportStar(require("./tools"), exports);
 //# sourceMappingURL=index.js.map

package/dist/utilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,kDAAgC;AAChC,mDAAiC;AACjC,2CAAyB;AACzB,6CAA2B;AAC3B,2CAAyB;AACzB,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utilities/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,kDAAgC;AAChC,mDAAiC;AACjC,2CAAyB;AACzB,6CAA2B;AAC3B,2CAAyB;AACzB,mDAAiC;AACjC,0CAAwB"}

package/dist/utilities/schema/SchemaAdapterRegistry.d.ts

@@ -2,6 +2,7 @@ import { LLMProviders } from '../../LLMService.typedefs';
 import type { SchemaAdapterInterface } from '../../utilities/schema/LLMSchema.typedefs';
 import { OpenAISchemaAdapter } from '../../providers/OpenAI/schemas/OpenAISchemaAdapter';
 import { GoogleSchemaAdapter } from '../../providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter';
+import { LLMAPISchemaAdapter } from '../../providers/LLMAPI/schemas/LLMAPISchemaAdapter';
 /**
  * Type-safe registry of schema adapters for all supported providers.
  *
@@ -16,6 +17,7 @@ import { GoogleSchemaAdapter } from '../../providers/GoogleGenerativeAI/schemas/
 export declare const SCHEMA_ADAPTER_REGISTRY: {
     readonly OpenAI: OpenAISchemaAdapter;
     readonly GoogleGenerativeAI: GoogleSchemaAdapter;
+    readonly LLMAPI: LLMAPISchemaAdapter;
 };
 /**
  * Type-safe helper to get a schema adapter for a provider.

package/dist/utilities/schema/SchemaAdapterRegistry.js

@@ -5,6 +5,7 @@ exports.getSchemaAdapter = getSchemaAdapter;
 const LLMService_typedefs_1 = require("../../LLMService.typedefs");
 const OpenAISchemaAdapter_1 = require("../../providers/OpenAI/schemas/OpenAISchemaAdapter");
 const GoogleSchemaAdapter_1 = require("../../providers/GoogleGenerativeAI/schemas/GoogleSchemaAdapter");
+const LLMAPISchemaAdapter_1 = require("../../providers/LLMAPI/schemas/LLMAPISchemaAdapter");
 /**
  * Type-safe registry of schema adapters for all supported providers.
  *
@@ -19,6 +20,7 @@ const GoogleSchemaAdapter_1 = require("../../providers/GoogleGenerativeAI/schema
 exports.SCHEMA_ADAPTER_REGISTRY = {
     [LLMService_typedefs_1.LLMProviders.OpenAI]: new OpenAISchemaAdapter_1.OpenAISchemaAdapter(),
     [LLMService_typedefs_1.LLMProviders.GoogleGenerativeAI]: new GoogleSchemaAdapter_1.GoogleSchemaAdapter(),
+    [LLMService_typedefs_1.LLMProviders.LLMAPI]: new LLMAPISchemaAdapter_1.LLMAPISchemaAdapter(),
 };
 /**
  * Type-safe helper to get a schema adapter for a provider.

package/dist/utilities/schema/SchemaAdapterRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaAdapterRegistry.js","sourceRoot":"","sources":["../../../src/utilities/schema/SchemaAdapterRegistry.ts"],"names":[],"mappings":";;;AAyBA,4CAEC;AA3BD,+DAAqD;AAErD,wFAAqF;AACrF,oGAAiG;AAEjG;;;;;;;;;;GAUG;AACU,QAAA,uBAAuB,GAAG;IACrC,CAAC,kCAAY,CAAC,MAAM,CAAC,EAAE,IAAI,yCAAmB,EAAE;IAChD,CAAC,kCAAY,CAAC,kBAAkB,CAAC,EAAE,IAAI,yCAAmB,EAAE;CACU,CAAC;AAEzE;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,QAAsB;IACrD,OAAO,+BAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"SchemaAdapterRegistry.js","sourceRoot":"","sources":["../../../src/utilities/schema/SchemaAdapterRegistry.ts"],"names":[],"mappings":";;;AA2BA,4CAEC;AA7BD,+DAAqD;AAErD,wFAAqF;AACrF,oGAAiG;AACjG,wFAAqF;AAErF;;;;;;;;;;GAUG;AACU,QAAA,uBAAuB,GAAG;IACrC,CAAC,kCAAY,CAAC,MAAM,CAAC,EAAE,IAAI,yCAAmB,EAAE;IAChD,CAAC,kCAAY,CAAC,kBAAkB,CAAC,EAAE,IAAI,yCAAmB,EAAE;IAC5D,CAAC,kCAAY,CAAC,MAAM,CAAC,EAAE,IAAI,yCAAmB,EAAE;CACsB,CAAC;AAEzE;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,QAAsB;IACrD,OAAO,+BAAuB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/dist/utilities/tools/LLMTool.d.ts

@@ -0,0 +1,10 @@
+import { type LLMToolDefinition } from '../../LLMService.typedefs';
+import { type LLMSchemaInterface, type InferSchema } from '../../utilities/schema';
+export declare class LLMTool {
+    static create<Schema extends LLMSchemaInterface>(config: {
+        name: string;
+        description: string;
+        parameters: Schema;
+        execute: (args: InferSchema<Schema>) => Promise<string> | string;
+    }): LLMToolDefinition<Schema>;
+}

package/dist/utilities/tools/LLMTool.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMTool = void 0;
+class LLMTool {
+    static create(config) {
+        return config;
+    }
+}
+exports.LLMTool = LLMTool;
+//# sourceMappingURL=LLMTool.js.map

package/dist/utilities/tools/LLMTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMTool.js","sourceRoot":"","sources":["../../../src/utilities/tools/LLMTool.ts"],"names":[],"mappings":";;;AAQA,MAAa,OAAO;IAClB,MAAM,CAAC,MAAM,CAAoC,MAKhD;QACC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AATD,0BASC"}

package/dist/utilities/tools/index.d.ts

@@ -0,0 +1 @@
+export { LLMTool } from './LLMTool';

package/dist/utilities/tools/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMTool = void 0;
+var LLMTool_1 = require("./LLMTool");
+Object.defineProperty(exports, "LLMTool", { enumerable: true, get: function () { return LLMTool_1.LLMTool; } });
+//# sourceMappingURL=index.js.map

package/dist/utilities/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/tools/index.ts"],"names":[],"mappings":";;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mate-academy/llm-gateway",
-  "version": "6.0.0",
+  "version": "6.2.0",
   "description": "A gateway package for LLM services.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",