@mate-academy/llm-gateway 8.8.2 → 8.8.3

package/dist/providers/OpenAI/index.d.ts

@@ -0,0 +1,5 @@
+export * from './OpenAI.constants';
+export * from './OpenAI.typedefs';
+export * from './OpenAI.entity';
+export * from './OpenAIService.factory';
+export * from './services';

package/dist/providers/OpenAI/index.js

@@ -0,0 +1,22 @@
+"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("./OpenAI.constants"), exports);
+__exportStar(require("./OpenAI.typedefs"), exports);
+__exportStar(require("./OpenAI.entity"), exports);
+__exportStar(require("./OpenAIService.factory"), exports);
+__exportStar(require("./services"), exports);
+//# sourceMappingURL=index.js.map

package/dist/providers/OpenAI/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/OpenAI/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,oDAAkC;AAClC,kDAAgC;AAChC,0DAAwC;AACxC,6CAA2B"}

package/dist/providers/OpenAI/schemas/OpenAISchemaAdapter.d.ts

@@ -0,0 +1,14 @@
+import type { SchemaAdapterInterface } from '../../../utilities/schema';
+/**
+ * Schema adapter for OpenAI provider.
+ * Converts JSON Schema to OpenAI's structured output format.
+ */
+export declare class OpenAISchemaAdapter implements SchemaAdapterInterface {
+    convertSchema(jsonSchema: any): any;
+    /**
+     * Normalizes JSON Schema for OpenAI structured_response:
+     * - For each object, sets required to all property keys.
+     * - Any property that was optional becomes nullable.
+     */
+    private normalizeForOpenAIStructuredResponse;
+}

package/dist/providers/OpenAI/schemas/OpenAISchemaAdapter.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAISchemaAdapter = void 0;
+/**
+ * Schema adapter for OpenAI provider.
+ * Converts JSON Schema to OpenAI's structured output format.
+ */
+class OpenAISchemaAdapter {
+    convertSchema(jsonSchema) {
+        return this.normalizeForOpenAIStructuredResponse(jsonSchema);
+    }
+    /**
+     * Normalizes JSON Schema for OpenAI structured_response:
+     * - For each object, sets required to all property keys.
+     * - Any property that was optional becomes nullable.
+     */
+    normalizeForOpenAIStructuredResponse(schema) {
+        const copy = JSON.parse(JSON.stringify(schema));
+        const allowsNull = (node) => {
+            if (!node || typeof node !== 'object') {
+                return false;
+            }
+            if (node.nullable === true) {
+                return true;
+            }
+            if (node.type === 'null') {
+                return true;
+            }
+            if (Array.isArray(node.type) && node.type.includes('null')) {
+                return true;
+            }
+            const list = node.anyOf || node.oneOf;
+            return Array.isArray(list)
+                ? list.some((node) => node?.type === 'null' || node?.nullable === true)
+                : false;
+        };
+        const makeNullable = (node) => {
+            if (!node
+                || typeof node !== 'object'
+                || allowsNull(node)) {
+                return;
+            }
+            if (node.anyOf) {
+                node.anyOf = [...node.anyOf, { type: 'null' }];
+            }
+            else if (node.oneOf) {
+                node.oneOf = [...node.oneOf, { type: 'null' }];
+            }
+            else {
+                node.nullable = true; // OpenAPI 3 nullable flag
+            }
+        };
+        const visit = (node) => {
+            if (!node || typeof node !== 'object') {
+                return;
+            }
+            // Handle composition
+            for (const key of ['anyOf', 'oneOf', 'allOf']) {
+                if (Array.isArray(node[key])) {
+                    node[key].forEach(visit);
+                }
+            }
+            // Recurse arrays
+            if (node.type === 'array' && node.items) {
+                visit(node.items);
+            }
+            // Objects: enforce required includes all properties
+            if (node.type === 'object' && node.properties) {
+                const props = node.properties;
+                const originalRequired = new Set(node.required || []);
+                const keys = Object.keys(props);
+                // Previously optional -> make nullable
+                for (const key of keys) {
+                    if (!originalRequired.has(key)) {
+                        makeNullable(props[key]);
+                    }
+                    visit(props[key]);
+                }
+                node.required = keys; // all properties required
+            }
+        };
+        visit(copy);
+        return copy;
+    }
+}
+exports.OpenAISchemaAdapter = OpenAISchemaAdapter;
+//# sourceMappingURL=OpenAISchemaAdapter.js.map

package/dist/providers/OpenAI/schemas/OpenAISchemaAdapter.js.map

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

package/dist/providers/OpenAI/services/OpenAIAssistance.service.d.ts

@@ -0,0 +1,42 @@
+import { OpenAI } from 'openai';
+import { type LLMAssistanceOptions, type LLMAssistanceResult, type LLMAssistanceMessage, type LLMCreateChatOptions, type LLMCreateChatResult, type LLMCreateFileStorageOptions, type LLMCreateFileStorageResult, type LLMInstanceOptions, LLMProviders, type LLMUploadFileOptions, type LLMUploadFileResult, type LLMStructuredResult, type LLMUploadedFile } from '../../../LLMService.typedefs';
+import { type LLMLoggerInterface } from '../../../utilities/logger';
+import { type LLMReporterInterface } from '../../../utilities/reporter';
+import { LLMAssistanceService } from '../../../services';
+import { type LLMSchemaInterface } from '../../../utilities/schema';
+export declare class OpenAIAssistanceService<Reporter extends LLMReporterInterface<any> | undefined> extends LLMAssistanceService<LLMProviders.OpenAI, Reporter> {
+    private uploadedFiles;
+    private responseHistory;
+    private chatInstructions;
+    constructor(logger: LLMLoggerInterface | undefined, reporter: Reporter, options?: LLMInstanceOptions[LLMProviders.OpenAI]);
+    get instance(): OpenAI;
+    uploadFile(fileOptions: LLMUploadFileOptions<Reporter>): Promise<LLMUploadFileResult>;
+    getFile(path: string): Promise<LLMUploadedFile | null>;
+    deleteFile(fileId: string): Promise<void>;
+    createFileStorage(options: LLMCreateFileStorageOptions<LLMProviders.OpenAI, Reporter>): Promise<LLMCreateFileStorageResult>;
+    deleteFileStorage(fileStorageId: string): Promise<void>;
+    createChat(options: LLMCreateChatOptions<LLMProviders.OpenAI, Reporter>): Promise<LLMCreateChatResult>;
+    deleteChat(chatId: string): Promise<void>;
+    private prepareAssistTools;
+    private extractUsageFromResponse;
+    private buildUsageMetrics;
+    private readonly buildRoundOutcome;
+    /**
+     * The transcript a traced round of this turn shows. The Responses API keeps
+     * earlier turns of the chat server-side and refers to them by
+     * `previous_response_id`, so what a round can honestly show is what this call
+     * put on the wire: the chat's instructions, this turn's input items, and
+     * everything the tool loop appends to them afterwards.
+     */
+    private startTracedConversation;
+    protected assistInChatText(options: LLMAssistanceOptions<LLMProviders.OpenAI, Reporter>): Promise<LLMAssistanceResult>;
+    protected assistInChatStructured(options: LLMAssistanceOptions<LLMProviders.OpenAI, Reporter> & {
+        schema: LLMSchemaInterface;
+    }): Promise<LLMStructuredResult>;
+    private convertCustomToolsToResponsesAPI;
+    private executeFunctionCall;
+    private executeToolLoop;
+    private getFunctionCallsFromResponse;
+    private convertLLMMessageToResponsesInput;
+    countTokens(messages: LLMAssistanceMessage[]): Promise<number>;
+}