@mate-academy/llm-gateway 8.9.0 → 8.11.0

package/dist/providers/OpenAICompatible/OpenAICompatibleSpeechToText.service.js

@@ -51,7 +51,7 @@ class OpenAICompatibleSpeechToTextService extends services_1.LLMSpeechToTextServ
                 signal: abortSignal,
             });
             abortSignal?.throwIfAborted();
-            const usage = this.extractUsage(response, fileSize);
+            const usage = await this.extractUsage(response, pathToAudio);
             await this.writeSuccessMetrics({
                 method,
                 model,

package/dist/providers/OpenAICompatible/OpenAICompatibleSpeechToText.service.js.map

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

package/dist/utilities/audio.d.ts

@@ -0,0 +1 @@
+export declare const getAudioDuration: (pathToAudio: string) => Promise<number>;

package/dist/utilities/audio.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAudioDuration = void 0;
+const load_esm_1 = require("load-esm");
+const musicMetadataModule = (0, load_esm_1.loadEsm)('music-metadata');
+const getAudioDuration = async (pathToAudio) => {
+    const { parseFile } = await musicMetadataModule;
+    const metadata = await parseFile(pathToAudio);
+    return metadata.format.duration ?? 0;
+};
+exports.getAudioDuration = getAudioDuration;
+//# sourceMappingURL=audio.js.map

package/dist/utilities/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/utilities/audio.ts"],"names":[],"mappings":";;;AAAA,uCAAmC;AAEnC,MAAM,mBAAmB,GAAG,IAAA,kBAAO,EACjC,gBAAgB,CACjB,CAAC;AAEK,MAAM,gBAAgB,GAAG,KAAK,EAAE,WAAmB,EAAmB,EAAE;IAC7E,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,mBAAmB,CAAC;IAChD,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAE9C,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;AACvC,CAAC,CAAC;AALW,QAAA,gBAAgB,oBAK3B"}

package/dist/utilities/history/LLMHistoryEntries.d.ts

@@ -0,0 +1,34 @@
+import { type LLMHistoryContextEntry, type LLMHistoryEntry, type LLMHistoryToolCallEntry, type LLMHistoryToolResultEntry, type LLMAssistanceMessage, type LLMToolResult } from '../../LLMService.typedefs';
+/**
+ * The history invariants every provider mapping relies on, established once
+ * here instead of in each provider: a tool call is answered exactly once, a
+ * result answers a call that was actually made, and an assistant round that
+ * called nothing is not a tool round at all.
+ */
+export declare class LLMHistoryEntries {
+    static isToolCall(entry: LLMHistoryEntry): entry is LLMHistoryToolCallEntry;
+    static isToolResult(entry: LLMHistoryEntry): entry is LLMHistoryToolResultEntry;
+    static isContext(entry: LLMHistoryEntry): entry is LLMHistoryContextEntry;
+    static isMessage(entry: LLMHistoryEntry): entry is LLMAssistanceMessage;
+    /**
+     * Repairs a restored history into one every provider accepts: an empty tool
+     * round is dropped, a result answering no preceding call is dropped, a
+     * second result for an already-answered call is dropped, and a call left
+     * unanswered gets `LLM_UNANSWERED_TOOL_CALL_RESULT` as a real tool result.
+     * Order is preserved; a synthesized result lands directly after the round
+     * that needed it.
+     */
+    static normalize(entries: LLMHistoryEntry[]): LLMHistoryEntry[];
+    /**
+     * Indexes the repaired history by call id, so a provider mapping emits each
+     * call together with its result instead of walking the array twice.
+     */
+    static indexResultsByCallId(entries: LLMHistoryEntry[]): Map<string, LLMToolResult>;
+    /**
+     * A result answers a call only when it comes after it: a result standing
+     * before the call it names is as unusable to a provider as one naming no
+     * call at all, so the call still counts as unanswered.
+     */
+    private static collectAnsweredCallIds;
+    private static buildUnansweredResult;
+}

package/dist/utilities/history/LLMHistoryEntries.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMHistoryEntries = void 0;
+const LLMService_typedefs_1 = require("../../LLMService.typedefs");
+const history_constants_1 = require("../../utilities/history/history.constants");
+/**
+ * The history invariants every provider mapping relies on, established once
+ * here instead of in each provider: a tool call is answered exactly once, a
+ * result answers a call that was actually made, and an assistant round that
+ * called nothing is not a tool round at all.
+ */
+class LLMHistoryEntries {
+    static isToolCall(entry) {
+        return entry.type === LLMService_typedefs_1.LLMHistoryEntryTypes.ToolCall;
+    }
+    static isToolResult(entry) {
+        return entry.type === LLMService_typedefs_1.LLMHistoryEntryTypes.ToolResult;
+    }
+    static isContext(entry) {
+        return entry.type === LLMService_typedefs_1.LLMHistoryEntryTypes.Context;
+    }
+    static isMessage(entry) {
+        return !LLMHistoryEntries.isToolCall(entry)
+            && !LLMHistoryEntries.isToolResult(entry)
+            && !LLMHistoryEntries.isContext(entry);
+    }
+    /**
+     * Repairs a restored history into one every provider accepts: an empty tool
+     * round is dropped, a result answering no preceding call is dropped, a
+     * second result for an already-answered call is dropped, and a call left
+     * unanswered gets `LLM_UNANSWERED_TOOL_CALL_RESULT` as a real tool result.
+     * Order is preserved; a synthesized result lands directly after the round
+     * that needed it.
+     */
+    static normalize(entries) {
+        const answeredCallIds = LLMHistoryEntries.collectAnsweredCallIds(entries);
+        const calledIds = new Set();
+        const emittedResultIds = new Set();
+        return entries.flatMap((entry) => {
+            if (LLMHistoryEntries.isToolCall(entry)) {
+                if (entry.calls.length === 0) {
+                    return [];
+                }
+                entry.calls.forEach((call) => calledIds.add(call.id));
+                const unanswered = entry.calls.filter((call) => !answeredCallIds.has(call.id));
+                unanswered.forEach((call) => emittedResultIds.add(call.id));
+                return [
+                    entry,
+                    ...unanswered.map((call) => LLMHistoryEntries.buildUnansweredResult(call.id)),
+                ];
+            }
+            if (!LLMHistoryEntries.isToolResult(entry)) {
+                return [entry];
+            }
+            if (!calledIds.has(entry.toolCallId)
+                || emittedResultIds.has(entry.toolCallId)) {
+                return [];
+            }
+            emittedResultIds.add(entry.toolCallId);
+            return [entry];
+        });
+    }
+    /**
+     * Indexes the repaired history by call id, so a provider mapping emits each
+     * call together with its result instead of walking the array twice.
+     */
+    static indexResultsByCallId(entries) {
+        const pairs = entries
+            .filter(LLMHistoryEntries.isToolResult)
+            .map((entry) => [
+            entry.toolCallId,
+            entry.result,
+        ]);
+        return new Map(pairs);
+    }
+    /**
+     * A result answers a call only when it comes after it: a result standing
+     * before the call it names is as unusable to a provider as one naming no
+     * call at all, so the call still counts as unanswered.
+     */
+    static collectAnsweredCallIds(entries) {
+        const callIndexById = new Map();
+        entries.forEach((entry, index) => {
+            if (!LLMHistoryEntries.isToolCall(entry)) {
+                return;
+            }
+            entry.calls.forEach((call) => {
+                if (!callIndexById.has(call.id)) {
+                    callIndexById.set(call.id, index);
+                }
+            });
+        });
+        const answeredIds = entries.flatMap((entry, index) => {
+            if (!LLMHistoryEntries.isToolResult(entry)) {
+                return [];
+            }
+            const callIndex = callIndexById.get(entry.toolCallId);
+            return callIndex !== undefined && callIndex < index
+                ? [entry.toolCallId]
+                : [];
+        });
+        return new Set(answeredIds);
+    }
+    static buildUnansweredResult(toolCallId) {
+        return {
+            type: LLMService_typedefs_1.LLMHistoryEntryTypes.ToolResult,
+            toolCallId,
+            result: history_constants_1.LLM_UNANSWERED_TOOL_CALL_RESULT,
+        };
+    }
+}
+exports.LLMHistoryEntries = LLMHistoryEntries;
+//# sourceMappingURL=LLMHistoryEntries.js.map

package/dist/utilities/history/LLMHistoryEntries.js.map

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

package/dist/utilities/history/history.constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The result a tool call is replayed with when the restored history holds no
+ * result for it. Every provider rejects an assistant tool call that no result
+ * answers, so the pairing is repaired natively — as a real tool result — rather
+ * than left to the caller to fake in prose.
+ */
+export declare const LLM_UNANSWERED_TOOL_CALL_RESULT: string;

package/dist/utilities/history/history.constants.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLM_UNANSWERED_TOOL_CALL_RESULT = void 0;
+/**
+ * The result a tool call is replayed with when the restored history holds no
+ * result for it. Every provider rejects an assistant tool call that no result
+ * answers, so the pairing is repaired natively — as a real tool result — rather
+ * than left to the caller to fake in prose.
+ */
+exports.LLM_UNANSWERED_TOOL_CALL_RESULT = 'No result was recorded for this tool call: the run ended before it'
+    + ' completed.';
+//# sourceMappingURL=history.constants.js.map

package/dist/utilities/history/history.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.constants.js","sourceRoot":"","sources":["../../../src/utilities/history/history.constants.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,+BAA+B,GAC1C,oEAAoE;MAClE,aAAa,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from './history.constants';
+export * from './LLMHistoryEntries';

package/dist/utilities/history/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("./history.constants"), exports);
+__exportStar(require("./LLMHistoryEntries"), exports);
+//# sourceMappingURL=index.js.map

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

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

package/dist/utilities/index.d.ts

@@ -1,4 +1,5 @@
 export * from './functional.utils';
+export * from './history';
 export * from './llmTracing';
 export * from './promptBuilder';
 export * from './calculateCosts';

package/dist/utilities/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./functional.utils"), exports);
+__exportStar(require("./history"), exports);
 __exportStar(require("./llmTracing"), exports);
 __exportStar(require("./promptBuilder"), exports);
 __exportStar(require("./calculateCosts"), exports);

package/dist/utilities/index.js.map

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

package/package.json

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