@mate-academy/llm-gateway 8.1.0 → 8.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mate-academy/llm-gateway",
-  "version": "8.1.0",
+  "version": "8.2.0",
   "description": "A gateway package for LLM services.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -117,6 +117,7 @@
     "mime-types": "^3.0.1",
     "music-metadata": "^11.10.1",
     "openai": "^6.27.0",
+    "ts-morph": "^28.0.0",
     "uuid": "^9.0.1",
     "zod": "^4.1.12"
   }

package/dist/client/createLLMClient.typedefs.d.ts

@@ -1,91 +0,0 @@
-import { type LLMProviders, type LLMInstanceOptions } from '../LLMService.typedefs';
-import { type LLMGateway } from '../LLMGateway';
-import { type LLMLoggerInterface } from '../utilities/logger';
-import { type LLMReporterInterface } from '../utilities/reporter';
-import { type InferSchema, type LLMSchemaInterface } from '../utilities/schema';
-import { type LLMGatewayPromptClient } from '../client/promptClientPort.typedefs';
-import { type LLMPromptBinding, type LLMPromptRegistry } from '../client/defineLLMPrompts';
-import { type LLMPromptSnapshot } from '../client/promptSnapshot.typedefs';
-import { type LLMVariableValue } from '../client/promptSnapshot.typedefs';
-export type LLMClientMode = 'production' | 'experiment';
-/**
- * The explicit opt-out for the reporter pipeline; unlike tracing/prompts,
- * reporting has no safe silent default, so tests must opt out loudly. Passed
- * where `reporting` is expected to disable the Reporter/DWHSync wiring (tests,
- * scripts).
- */
-export declare const ReportingDisabled: unique symbol;
-export type ReportingDisabledToken = typeof ReportingDisabled;
-/**
- * Resolves provider credentials for one call, scoped by provider + prompt +
- * product, preserving the existing per-feature Secrets Manager layout.
- */
-export type LLMCredentialsResolver = <Provider extends LLMProviders>(scope: {
-    provider: Provider;
-    promptName: string;
-    product?: string;
-}) => Promise<LLMInstanceOptions[Provider]>;
-export interface LLMClientStaticContext {
-    product?: string;
-    appEnvironment?: string;
-    [key: string]: string | undefined;
-}
-export interface LLMClientCallContext {
-    userId?: string | number | null;
-    [key: string]: string | number | boolean | null | undefined;
-}
-export interface LLMReportingConfig {
-    reporter: LLMReporterInterface<any>;
-}
-export interface CreateLLMClientConfig<Registry extends LLMPromptRegistry> {
-    gateway: LLMGateway;
-    registry: Registry;
-    snapshot: LLMPromptSnapshot;
-    credentials: LLMCredentialsResolver;
-    reporting: LLMReportingConfig | ReportingDisabledToken;
-    logger?: LLMLoggerInterface;
-    context?: LLMClientStaticContext;
-    mode?: LLMClientMode;
-    promptClient?: LLMGatewayPromptClient;
-    defaultLabel?: string;
-    cacheTtlSeconds?: number;
-}
-/**
- * The variables a prompt requires. Strict on required keys, tolerant of extras
- * (`& Record<string, LLMVariableValue>`) so a Langfuse edit that drops a variable
- * can never break a build — the stale extra is accepted, never rejected.
- */
-export type LLMPromptVariables<RequiredKeys extends string> = Record<RequiredKeys, LLMVariableValue> & Record<string, LLMVariableValue>;
-/**
- * The return type of `generate` for one prompt: the bound schema's inferred type
- * when a schema is present, else the raw completion string.
- */
-export type LLMGenerateResult<Binding extends LLMPromptBinding> = Binding extends {
-    schema: infer Schema;
-} ? Schema extends LLMSchemaInterface ? InferSchema<Schema> : string : string;
-export interface LLMGenerateOptions<Variables extends Record<string, LLMVariableValue>, Schema extends LLMSchemaInterface = never> {
-    variables: Variables;
-    context?: LLMClientCallContext;
-    history?: LLMPlainMessage[];
-    abortSignal?: AbortSignal;
-    overrides?: LLMCallOverrides;
-    /**
-     * Per-call structured-output schema. Overrides the registry binding's `schema`
-     * for this call and drives the return type (`InferSchema<Schema>`). Use it when
-     * the output contract is dynamic per call (e.g. a schema whose shape depends on
-     * runtime input). The schema is the code-owned output contract, not a routing
-     * control, so it is honored in every mode.
-     */
-    schema?: Schema;
-}
-export interface LLMCallOverrides {
-    model?: string;
-    provider?: LLMProviders;
-    promptVersion?: number;
-    promptLabel?: string;
-}
-export type LLMPlainMessageRole = 'user' | 'assistant';
-export interface LLMPlainMessage {
-    role: LLMPlainMessageRole;
-    text: string;
-}

package/dist/client/createLLMClient.typedefs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"createLLMClient.typedefs.js","sourceRoot":"","sources":["../../src/client/createLLMClient.typedefs.ts"],"names":[],"mappings":";;;AAeA;;;;;GAKG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/providers/LLMAPI/utilities/LLMAPIJsonFixer.d.ts

@@ -1,24 +0,0 @@
-import type { OpenAI } from 'openai';
-import type { LLMLoggerInterface } from '../../../utilities/logger';
-import type { LLMReporterInterface } from '../../../utilities/reporter';
-import type { LLMSchemaInterface } from '../../../utilities/schema';
-import type { LLMStructuredResult } from '../../../LLMService.typedefs';
-import { type LLMModelUsage } from '../../../utilities';
-interface ParseStructuredResponseOptions {
-    content: string;
-    schema: LLMSchemaInterface;
-    jsonSchema: any;
-    reporterContext?: any;
-    abortSignal?: AbortSignal;
-    primaryUsage: LLMModelUsage;
-}
-export declare class LLMAPIJsonFixer {
-    private readonly instance;
-    private readonly logger;
-    private readonly reporter;
-    constructor(instance: OpenAI, logger: LLMLoggerInterface | undefined, reporter: LLMReporterInterface<any> | undefined);
-    parseStructuredResponse(options: ParseStructuredResponseOptions): Promise<LLMStructuredResult>;
-    private fixAndParseJson;
-}
-export declare function sanitizeJsonResponse(response: string): string;
-export {};

package/dist/providers/LLMAPI/utilities/LLMAPIJsonFixer.js

@@ -1,237 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LLMAPIJsonFixer = void 0;
-exports.sanitizeJsonResponse = sanitizeJsonResponse;
-const serializeError_1 = require("../../../utilities/serializeError");
-const LLMAPI_typedefs_1 = require("../../../providers/LLMAPI/LLMAPI.typedefs");
-const utilities_1 = require("../../../utilities");
-class LLMAPIJsonFixer {
-    instance;
-    logger;
-    reporter;
-    constructor(instance, logger, reporter) {
-        this.instance = instance;
-        this.logger = logger;
-        this.reporter = reporter;
-    }
-    async parseStructuredResponse(options) {
-        const { content, schema, jsonSchema, reporterContext, abortSignal, primaryUsage, } = options;
-        const sanitized = sanitizeJsonResponse(content);
-        try {
-            const parsed = JSON.parse(sanitized);
-            const validation = schema._parse(parsed);
-            if (validation.error) {
-                this.logger
-                    ?.child('parseStructuredResponse')
-                    .warn('Schema validation failed, attempting fix', { validationError: validation.error });
-                return this.fixAndParseJson({
-                    rawResponse: sanitized,
-                    parsingError: validation.error,
-                    schema,
-                    jsonSchema,
-                    reporterContext,
-                    abortSignal,
-                    primaryUsage,
-                });
-            }
-            return {
-                text: sanitized,
-                data: validation.data,
-                usage: primaryUsage,
-            };
-        }
-        catch (parseError) {
-            this.logger
-                ?.child('parseStructuredResponse')
-                .warn('Failed to parse JSON response, attempting fix', {
-                content: sanitized,
-                parseError: parseError.message,
-            });
-            return this.fixAndParseJson({
-                rawResponse: sanitized,
-                parsingError: parseError.message,
-                schema,
-                jsonSchema,
-                reporterContext,
-                abortSignal,
-                primaryUsage,
-            });
-        }
-    }
-    async fixAndParseJson(options) {
-        const { rawResponse, parsingError, schema, jsonSchema, reporterContext, abortSignal, primaryUsage, } = options;
-        const fixWriteMetrics = this.reporter?.initWriter(reporterContext);
-        try {
-            abortSignal?.throwIfAborted();
-            const fixCompletion = await this.instance.chat.completions.create({
-                model: LLMAPI_typedefs_1.LLMAPI_JSON_FIX_MODEL.name,
-                messages: [
-                    {
-                        role: 'system',
-                        content: 'You are a JSON fixer.'
-                            + ' Fix the provided broken or invalid JSON'
-                            + ' so it matches the expected schema.'
-                            + ' Return ONLY the corrected JSON'
-                            + ' without any explanations or formatting.',
-                    },
-                    {
-                        role: 'user',
-                        content: buildFixJsonPrompt({
-                            rawResponse,
-                            parsingError,
-                            jsonSchema,
-                        }),
-                    },
-                ],
-                n: 1,
-                ...LLMAPI_typedefs_1.LLMAPI_JSON_FIX_MODEL.config,
-                response_format: { type: 'json_object' },
-            }, {
-                signal: abortSignal,
-            });
-            const fixedContent = sanitizeJsonResponse(fixCompletion.choices[0]?.message.content ?? '');
-            const fixPromptTokens = fixCompletion.usage?.prompt_tokens ?? 0;
-            const fixCachedTokens = fixCompletion.usage?.prompt_tokens_details
-                ?.cached_tokens ?? 0;
-            const fixOutputTokens = fixCompletion.usage?.completion_tokens ?? 0;
-            const fixUsage = {
-                inputTextTokens: fixPromptTokens - fixCachedTokens,
-                inputCachedTextTokens: fixCachedTokens,
-                outputTextTokens: fixOutputTokens,
-            };
-            await writeSuccessMetrics({
-                model: LLMAPI_typedefs_1.LLMAPI_JSON_FIX_MODEL,
-                usage: fixUsage,
-                writeMetrics: fixWriteMetrics,
-            });
-            const combinedUsage = (0, utilities_1.addUsage)(primaryUsage, fixUsage);
-            const parsed = JSON.parse(fixedContent);
-            const validation = schema._parse(parsed);
-            if (validation.error) {
-                this.logger
-                    ?.child('fixAndParseJson')
-                    .error('JSON fix attempt failed schema validation', {
-                    fixedContent,
-                    validationError: validation.error,
-                });
-                return {
-                    text: fixedContent,
-                    parseError: validation.error,
-                    usage: combinedUsage,
-                };
-            }
-            this.logger
-                ?.child('fixAndParseJson')
-                .info('JSON fix succeeded');
-            return {
-                text: fixedContent,
-                data: validation.data,
-                usage: combinedUsage,
-            };
-        }
-        catch (fixError) {
-            await writeErrorMetrics({
-                model: LLMAPI_typedefs_1.LLMAPI_JSON_FIX_MODEL,
-                isAborted: abortSignal?.aborted,
-                writeMetrics: fixWriteMetrics,
-            });
-            const fixLogger = this.logger?.child('fixAndParseJson');
-            const fixErrorPayload = { error: (0, serializeError_1.serializeError)(fixError) };
-            if (abortSignal?.aborted) {
-                fixLogger?.warn('JSON fix request failed', fixErrorPayload);
-            }
-            else {
-                fixLogger?.error('JSON fix request failed', fixErrorPayload);
-            }
-            return {
-                text: rawResponse,
-                error: fixError,
-                parseError: 'Failed to fix structured response from LLMAPI',
-                usage: primaryUsage,
-            };
-        }
-    }
-}
-exports.LLMAPIJsonFixer = LLMAPIJsonFixer;
-function sanitizeJsonResponse(response) {
-    return response
-        .replace(/^```(?:json)?/, '')
-        .replace(/```$/, '')
-        .trim();
-}
-function buildFixJsonPrompt(options) {
-    const { rawResponse, parsingError, jsonSchema } = options;
-    return [
-        'Fix the following JSON response'
-            + ' so it matches the expected schema.',
-        '',
-        'Expected JSON Schema:',
-        JSON.stringify(jsonSchema, null, 2),
-        '',
-        'Broken JSON response:',
-        rawResponse,
-        '',
-        'Parsing error:',
-        parsingError,
-        '',
-        'Common issues to fix:',
-        '- Missing or extra commas',
-        '- Unescaped special characters in strings',
-        '- Missing quotes around keys or values',
-        '- Wrong field names (rename to match schema)',
-        '- Wrong field types (convert to match schema)',
-        '- Truncated JSON (complete it logically)',
-        '',
-        'Return ONLY the corrected JSON.',
-    ].join('\n');
-}
-async function writeSuccessMetrics(params) {
-    const { model, usage: { inputTextTokens = 0, outputTextTokens = 0, inputAudioTokens = 0, outputAudioTokens = 0, }, writeMetrics, } = params;
-    if (!writeMetrics) {
-        return;
-    }
-    const costs = (0, utilities_1.calculateCosts)(model, {
-        inputTextTokens,
-        outputTextTokens,
-        inputAudioTokens,
-        outputAudioTokens,
-    });
-    const input = inputTextTokens + inputAudioTokens;
-    const output = outputTextTokens + outputAudioTokens;
-    return writeMetrics({
-        provider: 'LLMAPI',
-        purpose: 'Completion',
-        model: model.name,
-        modelConfig: model.config ?? null,
-        method: 'fixAndParseJson',
-        status: 'success',
-        tokens: {
-            input,
-            output,
-            total: input + output,
-        },
-        costs,
-    });
-}
-async function writeErrorMetrics(params) {
-    const { model, isAborted = false, writeMetrics } = params;
-    if (!writeMetrics) {
-        return;
-    }
-    return writeMetrics({
-        provider: 'LLMAPI',
-        purpose: 'Completion',
-        model: model.name,
-        modelConfig: model.config ?? null,
-        method: 'fixAndParseJson',
-        status: isAborted ? 'cancelled' : 'error',
-        tokens: { input: 0, output: 0, total: 0 },
-        costs: {
-            total: 0,
-            input: 0,
-            output: 0,
-            currency: 'USD',
-        },
-    });
-}
-//# sourceMappingURL=LLMAPIJsonFixer.js.map

package/dist/providers/LLMAPI/utilities/LLMAPIJsonFixer.js.map

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

package/dist/utilities/traceIO.d.ts

@@ -1,17 +0,0 @@
-export interface TruncateTraceIOOptions {
-    maxChars?: number;
-}
-/**
- * Caps a single trace/observation IO value so a large prompt or completion
- * cannot inflate trace payloads (the PR1 carry-over: `withTrace` serialized full
- * results). Strings over the limit are sliced with a notice; objects are
- * serialized first, then capped; non-serializable values fall back to `String`.
- * Returns the value unchanged when it is already within budget so small payloads
- * keep their original type in the UI.
- *
- * Applied by `LLMBaseService` to every generation it records, so each tracing
- * path (completion, assistance, speech-to-text) is capped at the single point
- * that stamps the observation rather than per call site.
- */
-export declare function truncateTraceIO(value: unknown, options?: TruncateTraceIOOptions): unknown;
-export declare const TRACE_IO_MAX_CHARS = 16384;

package/dist/utilities/traceIO.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TRACE_IO_MAX_CHARS = void 0;
-exports.truncateTraceIO = truncateTraceIO;
-const DEFAULT_MAX_TRACE_IO_CHARS = 16_384;
-const TRUNCATION_NOTICE = '…[truncated]';
-/**
- * Caps a single trace/observation IO value so a large prompt or completion
- * cannot inflate trace payloads (the PR1 carry-over: `withTrace` serialized full
- * results). Strings over the limit are sliced with a notice; objects are
- * serialized first, then capped; non-serializable values fall back to `String`.
- * Returns the value unchanged when it is already within budget so small payloads
- * keep their original type in the UI.
- *
- * Applied by `LLMBaseService` to every generation it records, so each tracing
- * path (completion, assistance, speech-to-text) is capped at the single point
- * that stamps the observation rather than per call site.
- */
-function truncateTraceIO(value, options = {}) {
-    const maxChars = options.maxChars ?? DEFAULT_MAX_TRACE_IO_CHARS;
-    if (value === undefined || value === null) {
-        return value;
-    }
-    if (typeof value === 'string') {
-        return capString(value, maxChars);
-    }
-    const serialized = safeSerialize(value);
-    if (serialized.length <= maxChars) {
-        return value;
-    }
-    return capString(serialized, maxChars);
-}
-function capString(text, maxChars) {
-    if (text.length <= maxChars) {
-        return text;
-    }
-    return `${text.slice(0, maxChars)}${TRUNCATION_NOTICE}`;
-}
-function safeSerialize(value) {
-    try {
-        return JSON.stringify(value) ?? String(value);
-    }
-    catch {
-        return String(value);
-    }
-}
-exports.TRACE_IO_MAX_CHARS = DEFAULT_MAX_TRACE_IO_CHARS;
-//# sourceMappingURL=traceIO.js.map

package/dist/utilities/traceIO.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"traceIO.js","sourceRoot":"","sources":["../../src/utilities/traceIO.ts"],"names":[],"mappings":";;;AAoBA,0CAqBC;AAzCD,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAE1C,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAMzC;;;;;;;;;;;GAWG;AACH,SAAgB,eAAe,CAC7B,KAAc,EACd,UAAkC,EAAE;IAEpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,0BAA0B,CAAC;IAEhE,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAExC,IAAI,UAAU,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,SAAS,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,QAAgB;IAC/C,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,iBAAiB,EAAE,CAAC;AAC1D,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAEY,QAAA,kBAAkB,GAAG,0BAA0B,CAAC"}