@mate-academy/llm-gateway 8.8.2 → 8.8.3

package/dist/services/LLMBaseService.abstract.js

@@ -0,0 +1,392 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMBaseService = void 0;
+const crypto_1 = require("crypto");
+const serializeError_1 = require("../utilities/serializeError");
+const LLMService_constants_1 = require("../LLMService.constants");
+const utilities_1 = require("../utilities");
+const agentRounds_1 = require("./agentRounds");
+class LLMBaseService {
+    provider;
+    serviceName;
+    purpose;
+    logger;
+    reporter;
+    options;
+    static sharedInstanceCache = new Map();
+    tracer = utilities_1.noopLLMGatewayTracer;
+    constructor(provider, serviceName, purpose, logger, reporter, options) {
+        this.provider = provider;
+        this.serviceName = serviceName;
+        this.purpose = purpose;
+        this.logger = logger;
+        this.reporter = reporter;
+        this.options = options;
+        this.injectMethodNames();
+        this.initLogger();
+    }
+    /**
+     * Wires the tracer the service reports generations and tool calls to. Called
+     * by `LLMGateway` right after construction; services built through
+     * `LLMServiceFactory` keep the no-op tracer.
+     */
+    initTracer(tracer) {
+        this.tracer = tracer;
+    }
+    getTracer() {
+        return this.tracer;
+    }
+    /**
+     * Available models for the current provider and purpose.
+     */
+    get models() {
+        return LLMService_constants_1.LLM_SERVICE_MODELS[this.provider][this.purpose];
+    }
+    /**
+     * Initialize the logger by creating a child logger with the provider and service name.
+     */
+    initLogger() {
+        this.logger = this.logger?.child(`${this.provider}:${this.serviceName}`);
+    }
+    /**
+     * Inject method names into class methods for better logging and reporting.
+     */
+    injectMethodNames() {
+        let proto = Object.getPrototypeOf(this);
+        while (proto && proto !== Object.prototype) {
+            Object.getOwnPropertyNames(proto).forEach(name => {
+                const descriptor = Object.getOwnPropertyDescriptor(proto, name);
+                if (descriptor && typeof descriptor.value === 'function' && name !== 'constructor') {
+                    descriptor.value.methodName = name;
+                }
+            });
+            proto = Object.getPrototypeOf(proto);
+        }
+    }
+    /**
+     * Get the method name from a function.
+     * If the method name is not available, return 'unknown'.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type
+    getMethodName(func) {
+        return func.methodName || 'unknown';
+    }
+    /**
+     * Generate a cache key from credentials/options.
+     * Includes provider to ensure cache isolation between different providers.
+     * Note: Different purposes (Completion, Assistance, etc.) for the same provider
+     * share the same underlying client instance.
+     */
+    getCredentialsCacheKey(options) {
+        if (!options) {
+            return `${this.provider}:default`;
+        }
+        const serialized = JSON.stringify(options);
+        const hash = (0, crypto_1.createHash)('sha256').update(serialized).digest('hex');
+        return `${this.provider}:${hash}`;
+    }
+    /**
+     * Get or create cached instance for current credentials.
+     * This method implements LRU caching to bound memory usage across all service types.
+     * @throws {Error} If options are not provided (required for instance creation)
+     */
+    getOrCreateInstance(factory) {
+        if (!this.options) {
+            throw new Error(`Cannot create ${this.provider} instance: options are required`);
+        }
+        const cacheKey = this.getCredentialsCacheKey(this.options);
+        const cached = LLMBaseService.sharedInstanceCache.get(cacheKey);
+        if (cached) {
+            cached.lastUsed = Date.now();
+            return cached.instance;
+        }
+        if (LLMBaseService.sharedInstanceCache.size >= LLMService_constants_1.MAX_CACHED_INSTANCES) {
+            this.evictLeastRecentlyUsed();
+        }
+        const instance = factory();
+        LLMBaseService.sharedInstanceCache.set(cacheKey, {
+            instance,
+            lastUsed: Date.now(),
+        });
+        return instance;
+    }
+    /**
+     * Evict least recently used instance from the shared cache.
+     */
+    evictLeastRecentlyUsed() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [key, value] of LLMBaseService.sharedInstanceCache.entries()) {
+            if (value.lastUsed < oldestTime) {
+                oldestTime = value.lastUsed;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey) {
+            LLMBaseService.sharedInstanceCache.delete(oldestKey);
+        }
+    }
+    /**
+     * Set new options for the LLM service instance.
+     * The instance will be lazily recreated with new credentials on next access.
+     */
+    setOptions(options) {
+        this.options = options;
+    }
+    /**
+     * Get the current options for the LLM service instance.
+     */
+    getOptions() {
+        return this.options;
+    }
+    /**
+     * Clear all cached instances from the shared cache.
+     * Useful for testing and manual resource cleanup.
+     */
+    clearInstanceCache() {
+        LLMBaseService.sharedInstanceCache.clear();
+    }
+    getDefaultTraceName(method) {
+        return `${this.serviceName}/${method}`;
+    }
+    /**
+     * Builds the per-call generation trace from the standard method options.
+     * Returns `undefined` when tracing is disabled, so providers skip the work.
+     */
+    buildGenerationTrace(params) {
+        if (!this.tracer.isEnabled) {
+            return undefined;
+        }
+        const { method, traceContext, input, output, modelParameters, startedAt, } = params;
+        return {
+            name: traceContext?.name
+                ?? traceContext?.prompt?.name
+                ?? traceContext?.promptName
+                ?? this.getDefaultTraceName(method),
+            prompt: traceContext?.prompt,
+            input,
+            output,
+            modelParameters,
+            metadata: traceContext?.metadata,
+            userId: traceContext?.userId,
+            sessionId: traceContext?.sessionId,
+            tags: traceContext?.tags,
+            startedAt,
+        };
+    }
+    /**
+     * Opens the per-round generation stream of an agent tool loop. Every model
+     * round the loop runs is traced through the returned recorder, so the run
+     * renders as one role-labelled transcript per round instead of a single
+     * generation covering the whole loop. The run's aggregate metrics point is
+     * written separately by `writeSuccessMetrics` and is unaffected.
+     */
+    openAgentRounds(params) {
+        const { method, model, traceContext, modelParameters, } = params;
+        return new agentRounds_1.LLMAgentRounds((round) => {
+            const generationTrace = this.buildGenerationTrace({
+                method,
+                traceContext,
+                input: round.input,
+                output: round.isError
+                    ? this.describeError(round.error)
+                    : round.output,
+                modelParameters,
+                startedAt: round.startedAt,
+            });
+            if (round.isError) {
+                this.recordGenerationTrace({
+                    method,
+                    model,
+                    generationTrace,
+                    isError: true,
+                });
+                return;
+            }
+            const { tokens, costs } = this.buildGenerationAccounting({
+                model,
+                usage: round.usage ?? {},
+            });
+            this.recordGenerationTrace({
+                method,
+                model,
+                generationTrace,
+                usageDetails: tokens,
+                costDetails: {
+                    input: costs.input,
+                    output: costs.output,
+                    total: costs.total,
+                },
+            });
+        });
+    }
+    /**
+     * The generation a failed agent run falls back to when it never reached its
+     * first model round: a run that throws while assembling the request would
+     * otherwise trace nothing at all. Once a round has been recorded the
+     * transcript is already there, and no second observation is emitted for it.
+     */
+    buildUnstartedRunTrace(params) {
+        const { rounds, method, traceContext, input, modelParameters, startedAt, } = params;
+        if (rounds.hasRecordedRound) {
+            return undefined;
+        }
+        return this.buildGenerationTrace({
+            method,
+            traceContext,
+            input,
+            modelParameters,
+            startedAt,
+        });
+    }
+    /**
+     * Write success metrics for a specific method, and emit the matching
+     * generation observation when per-call trace context is provided.
+     */
+    writeSuccessMetrics(params) {
+        const { method, model, usage, writeMetrics, generationTrace, } = params;
+        const { tokens, costs } = this.buildGenerationAccounting({ model, usage });
+        this.recordGenerationTrace({
+            method,
+            model,
+            generationTrace,
+            usageDetails: tokens,
+            costDetails: {
+                input: costs.input,
+                output: costs.output,
+                total: costs.total,
+            },
+        });
+        if (!writeMetrics) {
+            return Promise.resolve();
+        }
+        return writeMetrics({
+            provider: this.provider,
+            purpose: this.purpose,
+            model: model?.name || null,
+            modelConfig: model?.config || null,
+            method,
+            status: 'success',
+            tokens,
+            costs,
+        });
+    }
+    /**
+     * Token totals and costs of one accounted call, in the shape both the metrics
+     * writer and a generation observation take.
+     */
+    buildGenerationAccounting(params) {
+        const { model, usage, } = params;
+        const { inputTextTokens = 0, outputTextTokens = 0, inputAudioTokens = 0, outputAudioTokens = 0, inputCachedTextTokens = 0, inputCachedAudioTokens = 0, } = usage;
+        const costs = (0, utilities_1.calculateCosts)(model, {
+            inputTextTokens,
+            outputTextTokens,
+            inputAudioTokens,
+            outputAudioTokens,
+            inputCachedTextTokens,
+            inputCachedAudioTokens,
+        });
+        const input = (inputTextTokens
+            + inputAudioTokens
+            + inputCachedTextTokens
+            + inputCachedAudioTokens);
+        const output = outputTextTokens + outputAudioTokens;
+        return {
+            tokens: {
+                input,
+                output,
+                total: input + output,
+            },
+            costs,
+        };
+    }
+    /**
+     * Write error metrics for a specific method, and emit the matching generation
+     * observation (level ERROR) when per-call trace context is given.
+     */
+    writeErrorMetrics(params) {
+        const { method, model, isAborted = false, writeMetrics, generationTrace, error, } = params;
+        const errorGenerationTrace = generationTrace
+            ? {
+                ...generationTrace,
+                output: generationTrace.output ?? this.describeError(error),
+            }
+            : undefined;
+        this.recordGenerationTrace({
+            method,
+            model,
+            generationTrace: errorGenerationTrace,
+            isError: true,
+        });
+        if (!writeMetrics) {
+            return Promise.resolve();
+        }
+        return writeMetrics({
+            provider: this.provider,
+            purpose: this.purpose,
+            model: model?.name || null,
+            modelConfig: model?.config || null,
+            method,
+            status: isAborted ? 'cancelled' : 'error',
+            tokens: {
+                input: 0,
+                output: 0,
+                total: 0,
+            },
+            costs: {
+                total: 0,
+                input: 0,
+                output: 0,
+                currency: 'USD',
+            },
+        });
+    }
+    /**
+     * Log a request failure at a severity matching whether it was an
+     * intentional cancellation (isAborted) or a genuine provider/network error.
+     * An aborted request is expected behaviour, not an operational failure, so
+     * it is logged as a warning rather than an error.
+     */
+    logRequestFailure(params) {
+        const { method, message, error, isAborted = false, meta, } = params;
+        const logger = this.logger?.child(method);
+        const payload = { error: (0, serializeError_1.serializeError)(error), ...meta };
+        if (isAborted) {
+            logger?.warn(message, payload);
+            return;
+        }
+        logger?.error(message, payload);
+    }
+    recordGenerationTrace(params) {
+        const { method, model, generationTrace, usageDetails, costDetails, isError, } = params;
+        if (!generationTrace) {
+            return;
+        }
+        const generationTraceRecord = {
+            name: generationTrace.name ?? this.getDefaultTraceName(method),
+            prompt: generationTrace.prompt,
+            input: generationTrace.input,
+            output: generationTrace.output,
+            model: model?.name ?? null,
+            modelParameters: generationTrace.modelParameters,
+            metadata: generationTrace.metadata,
+            userId: generationTrace.userId,
+            sessionId: generationTrace.sessionId,
+            tags: generationTrace.tags,
+            usageDetails,
+            costDetails,
+            isError,
+            startedAt: generationTrace.startedAt,
+            endedAt: Date.now(),
+        };
+        this.tracer.recordGeneration(generationTraceRecord);
+    }
+    describeError(error) {
+        if (error === undefined) {
+            return undefined;
+        }
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+exports.LLMBaseService = LLMBaseService;
+//# sourceMappingURL=LLMBaseService.abstract.js.map

package/dist/services/LLMBaseService.abstract.js.map

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

package/dist/services/LLMCompletionService.abstract.d.ts

@@ -0,0 +1,16 @@
+import { LLMPurposes, type LLMProviders, type LLMCompletionMessage, type LLMSendMessageOptions, type LLMCompletionResult, type LLMInstanceOptions, type LLMModel, type LLMStructuredResult } from '../LLMService.typedefs';
+import { type LLMLoggerInterface } from '../utilities/logger';
+import { type LLMReporterInterface } from '../utilities/reporter';
+import { LLMBaseService } from '../services';
+import { type LLMSchemaInterface, type InferSchema } from '../utilities/schema';
+export declare abstract class LLMCompletionService<Provider extends LLMProviders, Reporter extends LLMReporterInterface<any> | undefined> extends LLMBaseService<LLMPurposes.Completion, Provider, Reporter> {
+    constructor(provider: Provider, logger: LLMLoggerInterface | undefined, reporter: Reporter, options?: LLMInstanceOptions[Provider]);
+    abstract sendMessage<Schema extends LLMSchemaInterface>(options: LLMSendMessageOptions<Provider, Reporter> & {
+        schema: Schema;
+    }): Promise<LLMStructuredResult<InferSchema<Schema>>>;
+    abstract sendMessage(options: LLMSendMessageOptions<Provider, Reporter>): Promise<LLMCompletionResult>;
+    abstract sendMessage(options: LLMSendMessageOptions<Provider, Reporter> & {
+        schema?: LLMSchemaInterface;
+    }): Promise<LLMCompletionResult | LLMStructuredResult>;
+    abstract countTokens(messages: LLMCompletionMessage[], model: LLMModel<Provider>): Promise<number>;
+}

package/dist/services/LLMCompletionService.abstract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMCompletionService = void 0;
+const LLMService_typedefs_1 = require("../LLMService.typedefs");
+const services_1 = require("../services");
+class LLMCompletionService extends services_1.LLMBaseService {
+    constructor(provider, logger, reporter, options) {
+        super(provider, 'CompletionService', LLMService_typedefs_1.LLMPurposes.Completion, logger, reporter, options);
+    }
+}
+exports.LLMCompletionService = LLMCompletionService;
+//# sourceMappingURL=LLMCompletionService.abstract.js.map

package/dist/services/LLMCompletionService.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMCompletionService.abstract.js","sourceRoot":"","sources":["../../src/services/LLMCompletionService.abstract.ts"],"names":[],"mappings":";;;AAAA,+DAS+B;AAG/B,yCAA4C;AAG5C,MAAsB,oBAIpB,SAAQ,yBAA0D;IAClE,YACE,QAAkB,EAClB,MAAsC,EACtC,QAAkB,EAClB,OAAsC;QAEtC,KAAK,CACH,QAAQ,EACR,mBAAmB,EACnB,iCAAW,CAAC,UAAU,EACtB,MAAM,EACN,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC;CAkBF;AArCD,oDAqCC"}

package/dist/services/LLMServicePurposeFactory.abstract.d.ts

@@ -0,0 +1,12 @@
+import { type LLMInstanceOptions, type LLMProviders, type LLMPurposes, type LLMServiceByPurpose } from '../LLMService.typedefs';
+import { type LLMLoggerInterface } from '../utilities/logger';
+import { type LLMReporterInterface } from '../utilities/reporter';
+export interface LLMCreateServiceOptions<Provider extends LLMProviders, Purpose extends LLMPurposes, Reporter extends LLMReporterInterface<any> | undefined> {
+    purpose: Purpose;
+    logger?: LLMLoggerInterface;
+    reporter?: Reporter;
+    options?: LLMInstanceOptions[Provider];
+}
+export declare abstract class LLMServicePurposeFactory<Provider extends LLMProviders> {
+    abstract createService<Purpose extends LLMPurposes, Reporter extends LLMReporterInterface<any> | undefined>(options: LLMCreateServiceOptions<Provider, Purpose, Reporter>): LLMServiceByPurpose<Provider, Reporter>[Purpose];
+}

package/dist/services/LLMServicePurposeFactory.abstract.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMServicePurposeFactory = void 0;
+class LLMServicePurposeFactory {
+}
+exports.LLMServicePurposeFactory = LLMServicePurposeFactory;
+//# sourceMappingURL=LLMServicePurposeFactory.abstract.js.map

package/dist/services/LLMServicePurposeFactory.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMServicePurposeFactory.abstract.js","sourceRoot":"","sources":["../../src/services/LLMServicePurposeFactory.abstract.ts"],"names":[],"mappings":";;;AAoBA,MAAsB,wBAAwB;CAO7C;AAPD,4DAOC"}

package/dist/services/LLMSpeechToTextService.abstract.d.ts

@@ -0,0 +1,8 @@
+import { LLMPurposes, type LLMProviders, type LLMTranscribeOptions, type LLMTranscribeResult, type LLMInstanceOptions } from '../LLMService.typedefs';
+import { type LLMLoggerInterface } from '../utilities/logger';
+import { type LLMReporterInterface } from '../utilities/reporter';
+import { LLMBaseService } from '../services';
+export declare abstract class LLMSpeechToTextService<Provider extends LLMProviders, Reporter extends LLMReporterInterface<any> | undefined> extends LLMBaseService<LLMPurposes.SpeechToText, Provider, Reporter> {
+    constructor(provider: Provider, logger: LLMLoggerInterface | undefined, reporter: Reporter, options?: LLMInstanceOptions[Provider]);
+    abstract transcribe(options: LLMTranscribeOptions<Provider, Reporter>): Promise<LLMTranscribeResult>;
+}

package/dist/services/LLMSpeechToTextService.abstract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMSpeechToTextService = void 0;
+const LLMService_typedefs_1 = require("../LLMService.typedefs");
+const services_1 = require("../services");
+class LLMSpeechToTextService extends services_1.LLMBaseService {
+    constructor(provider, logger, reporter, options) {
+        super(provider, 'SpeechToTextService', LLMService_typedefs_1.LLMPurposes.SpeechToText, logger, reporter, options);
+    }
+}
+exports.LLMSpeechToTextService = LLMSpeechToTextService;
+//# sourceMappingURL=LLMSpeechToTextService.abstract.js.map

package/dist/services/LLMSpeechToTextService.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMSpeechToTextService.abstract.js","sourceRoot":"","sources":["../../src/services/LLMSpeechToTextService.abstract.ts"],"names":[],"mappings":";;;AAAA,+DAM+B;AAG/B,yCAA4C;AAE5C,MAAsB,sBAGpB,SAAQ,yBAA4D;IACpE,YACE,QAAkB,EAClB,MAAsC,EACtC,QAAkB,EAClB,OAAsC;QAEtC,KAAK,CACH,QAAQ,EACR,qBAAqB,EACrB,iCAAW,CAAC,YAAY,EACxB,MAAM,EACN,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC;CAKF;AAvBD,wDAuBC"}

package/dist/services/LLMTextToSpeechService.abstract.d.ts

@@ -0,0 +1,8 @@
+import { LLMPurposes, type LLMProviders, type LLMCreateSpeechOptions, type LLMCreateSpeechResult, type LLMInstanceOptions } from '../LLMService.typedefs';
+import { type LLMLoggerInterface } from '../utilities/logger';
+import { type LLMReporterInterface } from '../utilities/reporter';
+import { LLMBaseService } from '../services';
+export declare abstract class LLMTextToSpeechService<Provider extends LLMProviders, Reporter extends LLMReporterInterface<any> | undefined> extends LLMBaseService<LLMPurposes.TextToSpeech, Provider, Reporter> {
+    constructor(provider: Provider, logger: LLMLoggerInterface | undefined, reporter: Reporter, options?: LLMInstanceOptions[Provider]);
+    abstract createSpeech(options: LLMCreateSpeechOptions<Provider, Reporter>): Promise<LLMCreateSpeechResult>;
+}

package/dist/services/LLMTextToSpeechService.abstract.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMTextToSpeechService = void 0;
+const LLMService_typedefs_1 = require("../LLMService.typedefs");
+const services_1 = require("../services");
+class LLMTextToSpeechService extends services_1.LLMBaseService {
+    constructor(provider, logger, reporter, options) {
+        super(provider, 'TextToSpeechService', LLMService_typedefs_1.LLMPurposes.TextToSpeech, logger, reporter, options);
+    }
+}
+exports.LLMTextToSpeechService = LLMTextToSpeechService;
+//# sourceMappingURL=LLMTextToSpeechService.abstract.js.map

package/dist/services/LLMTextToSpeechService.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMTextToSpeechService.abstract.js","sourceRoot":"","sources":["../../src/services/LLMTextToSpeechService.abstract.ts"],"names":[],"mappings":";;;AAAA,+DAM+B;AAG/B,yCAA4C;AAE5C,MAAsB,sBAGpB,SAAQ,yBAA4D;IACpE,YACE,QAAkB,EAClB,MAAsC,EACtC,QAAkB,EAClB,OAAsC;QAEtC,KAAK,CACH,QAAQ,EACR,qBAAqB,EACrB,iCAAW,CAAC,YAAY,EACxB,MAAM,EACN,QAAQ,EACR,OAAO,CACR,CAAC;IACJ,CAAC;CAKF;AAvBD,wDAuBC"}

package/dist/services/agentRounds/LLMAgentRounds.d.ts

@@ -0,0 +1,32 @@
+import { type LLMAgentRoundSpec, type LLMAgentRoundWriter } from './agentRounds.typedefs';
+/**
+ * The per-round generation stream of a single agent run.
+ *
+ * A tool loop is a sequence of model rounds, and each of them is a generation
+ * in its own right: the conversation as it stood when the request went out, and
+ * what the model answered with. Providers put every provider call through
+ * `run`, which is what guarantees a round that throws is traced exactly like a
+ * round that succeeds, and that no round of the loop goes unrecorded.
+ *
+ * The recorder deliberately knows nothing about messages — the provider hands
+ * over its own native array as the round's input.
+ */
+export declare class LLMAgentRounds {
+    private readonly writeRound;
+    private didRecordRound;
+    constructor(writeRound: LLMAgentRoundWriter);
+    /**
+     * Whether any model round reached the tracer. A run that fails while still
+     * preparing its first request has no transcript to show, and its caller falls
+     * back to tracing the failure on its own.
+     */
+    get hasRecordedRound(): boolean;
+    /**
+     * Runs one provider call as a traced round. The provider's response is
+     * returned untouched and its failure rethrown unchanged: tracing never alters
+     * what the loop, or the caller, sees.
+     */
+    run<ProviderResponse>(round: LLMAgentRoundSpec<ProviderResponse>): Promise<ProviderResponse>;
+    private callProvider;
+    private recordSafely;
+}

package/dist/services/agentRounds/LLMAgentRounds.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMAgentRounds = void 0;
+/**
+ * The per-round generation stream of a single agent run.
+ *
+ * A tool loop is a sequence of model rounds, and each of them is a generation
+ * in its own right: the conversation as it stood when the request went out, and
+ * what the model answered with. Providers put every provider call through
+ * `run`, which is what guarantees a round that throws is traced exactly like a
+ * round that succeeds, and that no round of the loop goes unrecorded.
+ *
+ * The recorder deliberately knows nothing about messages — the provider hands
+ * over its own native array as the round's input.
+ */
+class LLMAgentRounds {
+    writeRound;
+    didRecordRound = false;
+    constructor(writeRound) {
+        this.writeRound = writeRound;
+    }
+    /**
+     * Whether any model round reached the tracer. A run that fails while still
+     * preparing its first request has no transcript to show, and its caller falls
+     * back to tracing the failure on its own.
+     */
+    get hasRecordedRound() {
+        return this.didRecordRound;
+    }
+    /**
+     * Runs one provider call as a traced round. The provider's response is
+     * returned untouched and its failure rethrown unchanged: tracing never alters
+     * what the loop, or the caller, sees.
+     */
+    async run(round) {
+        const startedAt = Date.now();
+        const response = await this.callProvider(round, startedAt);
+        try {
+            const { output, usage } = round.describeOutcome(response);
+            this.recordSafely({
+                input: round.input,
+                output,
+                usage,
+                startedAt,
+            });
+        }
+        catch {
+            return response;
+        }
+        return response;
+    }
+    async callProvider(round, startedAt) {
+        try {
+            return await round.call();
+        }
+        catch (error) {
+            this.recordSafely({
+                input: round.input,
+                startedAt,
+                error,
+                isError: true,
+            });
+            throw error;
+        }
+    }
+    recordSafely(round) {
+        try {
+            this.writeRound(round);
+            this.didRecordRound = true;
+        }
+        catch {
+            return;
+        }
+    }
+}
+exports.LLMAgentRounds = LLMAgentRounds;
+//# sourceMappingURL=LLMAgentRounds.js.map

package/dist/services/agentRounds/LLMAgentRounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMAgentRounds.js","sourceRoot":"","sources":["../../../src/services/agentRounds/LLMAgentRounds.ts"],"names":[],"mappings":";;;AAMA;;;;;;;;;;;GAWG;AACH,MAAa,cAAc;IAGI;IAFrB,cAAc,GAAG,KAAK,CAAC;IAE/B,YAA6B,UAA+B;QAA/B,eAAU,GAAV,UAAU,CAAqB;IAAG,CAAC;IAEhE;;;;OAIG;IACH,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CACP,KAA0C;QAE1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAE3D,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;YAE1D,IAAI,CAAC,YAAY,CAAC;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM;gBACN,KAAK;gBACL,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,YAAY,CACxB,KAA0C,EAC1C,SAAiB;QAEjB,IAAI,CAAC;YACH,OAAO,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,CAAC;gBAChB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,SAAS;gBACT,KAAK;gBACL,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,KAAoB;QACvC,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;CACF;AAnED,wCAmEC"}