@mate-academy/llm-gateway 8.8.0 → 8.8.2

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

@@ -1,5 +0,0 @@
-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

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

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

@@ -1,14 +0,0 @@
-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

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

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

@@ -1,42 +0,0 @@
-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>;
-}