@mate-academy/llm-gateway 8.8.2 → 8.8.4

package/dist/utilities/schema/index.js

@@ -0,0 +1,19 @@
+"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("./LLMSchema.typedefs"), exports);
+__exportStar(require("./LLMSchema"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utilities/schema/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,8CAA4B"}

package/dist/utilities/serializeError.d.ts

@@ -0,0 +1,9 @@
+type SerializedError = {
+    name: string;
+    message: string;
+    stack?: string;
+    cause?: SerializedError;
+    [key: string]: unknown;
+};
+export declare const serializeError: (error: unknown) => SerializedError | unknown;
+export {};

package/dist/utilities/serializeError.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeError = void 0;
+const serializeNonError = (value) => {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'string') {
+        return {
+            name: 'StringError',
+            message: value,
+        };
+    }
+    if (typeof value !== 'object') {
+        return {
+            name: 'UnknownError',
+            message: String(value),
+            originalValue: value,
+        };
+    }
+    const objectValue = value;
+    const result = {
+        name: typeof objectValue.name === 'string' ? objectValue.name : 'ObjectError',
+        message: typeof objectValue.message === 'string'
+            ? objectValue.message
+            : JSON.stringify(value),
+    };
+    const knownErrorProperties = ['code', 'status', 'statusCode', 'stack', 'cause'];
+    knownErrorProperties.forEach((property) => {
+        if (property in objectValue && objectValue[property] !== undefined) {
+            result[property] = objectValue[property];
+        }
+    });
+    if (!('message' in objectValue)) {
+        result.originalValue = value;
+    }
+    return result;
+};
+const serializeError = (error) => {
+    if (!(error instanceof Error)) {
+        return serializeNonError(error);
+    }
+    const serialized = {
+        name: error.name,
+        message: error.message,
+        stack: error.stack,
+    };
+    if (error.cause) {
+        serialized.cause = (0, exports.serializeError)(error.cause);
+    }
+    const additionalProperties = Object.getOwnPropertyNames(error)
+        .filter((key) => !['name', 'message', 'stack', 'cause'].includes(key));
+    additionalProperties.forEach((key) => {
+        const value = error[key];
+        serialized[key] = value;
+    });
+    const errorWithToJSON = error;
+    if (typeof errorWithToJSON.toJSON === 'function') {
+        const jsonError = errorWithToJSON.toJSON();
+        Object.keys(jsonError).forEach((key) => {
+            if (!(key in serialized)) {
+                serialized[key] = jsonError[key];
+            }
+        });
+    }
+    return serialized;
+};
+exports.serializeError = serializeError;
+//# sourceMappingURL=serializeError.js.map

package/dist/utilities/serializeError.js.map

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

package/dist/utilities/tokenizer.d.ts

@@ -0,0 +1,4 @@
+export declare const tokenizer: {
+    countText: (text: string) => number;
+    countAudio: (durationInSeconds: number) => number;
+};

package/dist/utilities/tokenizer.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenizer = void 0;
+const APPROXIMATE_CHARS_PER_TOKEN = 4;
+const AUDIO_TOKENS_PER_SECOND_ESTIMATE = 30;
+exports.tokenizer = {
+    countText: (text) => {
+        return Math.ceil(text.length / APPROXIMATE_CHARS_PER_TOKEN);
+    },
+    countAudio: (durationInSeconds) => {
+        return durationInSeconds * AUDIO_TOKENS_PER_SECOND_ESTIMATE;
+    }
+};
+//# sourceMappingURL=tokenizer.js.map

package/dist/utilities/tokenizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenizer.js","sourceRoot":"","sources":["../../src/utilities/tokenizer.ts"],"names":[],"mappings":";;;AAAA,MAAM,2BAA2B,GAAG,CAAC,CAAC;AACtC,MAAM,gCAAgC,GAAG,EAAE,CAAC;AAE/B,QAAA,SAAS,GAAG;IACvB,SAAS,EAAE,CAAC,IAAY,EAAU,EAAE;QAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,2BAA2B,CAAC,CAAC;IAC9D,CAAC;IACD,UAAU,EAAE,CAAC,iBAAyB,EAAU,EAAE;QAChD,OAAO,iBAAiB,GAAG,gCAAgC,CAAC;IAC9D,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,5 @@
+import { type LLMToolDefinition } from '../../LLMService.typedefs';
+import { type LLMSchemaInterface } from '../../utilities/schema';
+export declare class LLMTool {
+    static create<Schema extends LLMSchemaInterface>(config: LLMToolDefinition<Schema>): 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":";;;AAGA,MAAa,OAAO;IAClB,MAAM,CAAC,MAAM,CACX,MAAiC;QAEjC,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAND,0BAMC"}

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

@@ -0,0 +1,2 @@
+export { LLMTool } from './LLMTool';
+export { normalizeToolResult, type NormalizedToolResult, } from './normalizeToolResult';

package/dist/utilities/tools/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeToolResult = exports.LLMTool = void 0;
+var LLMTool_1 = require("./LLMTool");
+Object.defineProperty(exports, "LLMTool", { enumerable: true, get: function () { return LLMTool_1.LLMTool; } });
+var normalizeToolResult_1 = require("./normalizeToolResult");
+Object.defineProperty(exports, "normalizeToolResult", { enumerable: true, get: function () { return normalizeToolResult_1.normalizeToolResult; } });
+//# 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;AAChB,6DAG+B;AAF7B,0HAAA,mBAAmB,OAAA"}

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

@@ -0,0 +1,15 @@
+import { type LLMToolResult, type LLMToolResultImage } from '../../LLMService.typedefs';
+/**
+ * The shape every provider's tool loop works with internally: a text
+ * `content` (always present) plus an `images` array (possibly empty).
+ */
+export interface NormalizedToolResult {
+    content: string;
+    images: LLMToolResultImage[];
+}
+/**
+ * Collapses the two possible tool-result shapes into a single normalized
+ * form. A plain `string` becomes text-only; a structured result keeps its
+ * text and images (defaulting `images` to an empty array).
+ */
+export declare function normalizeToolResult(raw: LLMToolResult): NormalizedToolResult;

package/dist/utilities/tools/normalizeToolResult.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeToolResult = normalizeToolResult;
+/**
+ * Collapses the two possible tool-result shapes into a single normalized
+ * form. A plain `string` becomes text-only; a structured result keeps its
+ * text and images (defaulting `images` to an empty array).
+ */
+function normalizeToolResult(raw) {
+    if (typeof raw === 'string') {
+        return { content: raw, images: [] };
+    }
+    return {
+        content: raw.content,
+        images: raw.images ?? [],
+    };
+}
+//# sourceMappingURL=normalizeToolResult.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeToolResult.js","sourceRoot":"","sources":["../../../src/utilities/tools/normalizeToolResult.ts"],"names":[],"mappings":";;AAmBA,kDAWC;AAhBD;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,GAAkB;IAElB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACtC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE;KACzB,CAAC;AACJ,CAAC"}

package/package.json

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