@mate-academy/llm-gateway 7.7.0 → 7.8.0

package/dist/utilities/llmTracing/activeLLMTracer.js

@@ -1,37 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.noopLLMGatewayTracer = void 0;
-exports.getActiveLLMTracer = getActiveLLMTracer;
-exports.setActiveLLMTracer = setActiveLLMTracer;
-class NoopLLMGatewayTracer {
-    isEnabled = false;
-    async withTrace(_name, _context, fn) {
-        return fn();
-    }
-    recordGeneration() {
-        // no-op when disabled
-    }
-    async withToolObservation(_name, _input, fn) {
-        return fn();
-    }
-    async flush() {
-        // no-op when disabled
-    }
-}
-exports.noopLLMGatewayTracer = new NoopLLMGatewayTracer();
-let activeTracer = exports.noopLLMGatewayTracer;
-/**
- * The active gateway tracer. The base service and `withLLMTrace` reach it here
- * so feature code never threads a tracer through call sites.
- */
-function getActiveLLMTracer() {
-    return activeTracer;
-}
-/**
- * Registers the active gateway tracer. Not exported from the package barrel —
- * only `initLLMGateway` (the composition-root entry point) may call it.
- */
-function setActiveLLMTracer(tracer) {
-    activeTracer = tracer;
-}
-//# sourceMappingURL=activeLLMTracer.js.map

package/dist/utilities/llmTracing/activeLLMTracer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"activeLLMTracer.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/activeLLMTracer.ts"],"names":[],"mappings":";;;AAyCA,gDAEC;AAMD,gDAEC;AA9CD,MAAM,oBAAoB;IACf,SAAS,GAAG,KAAK,CAAC;IAE3B,KAAK,CAAC,SAAS,CACb,KAAa,EACb,QAAyB,EACzB,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,gBAAgB;QACd,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,KAAa,EACb,MAAe,EACf,EAAyB;QAEzB,OAAO,EAAE,EAAE,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK;QACT,sBAAsB;IACxB,CAAC;CACF;AAEY,QAAA,oBAAoB,GAAqB,IAAI,oBAAoB,EAAE,CAAC;AAEjF,IAAI,YAAY,GAAqB,4BAAoB,CAAC;AAE1D;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,SAAgB,kBAAkB,CAAC,MAAwB;IACzD,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC"}

package/dist/utilities/llmTracing/fallbackMetric.d.ts

@@ -1,21 +0,0 @@
-/**
- * CloudWatch namespace + metric name for the fallback-serving alarm. PR2's
- * runtime gate calls the emitter when it serves the fallback prompt snapshot; a
- * CloudWatch alarm on this metric routes to the standard alerting path.
- */
-export declare const LANGFUSE_METRIC_NAMESPACE = "LLMGateway";
-export declare const LANGFUSE_FALLBACK_SERVED_METRIC = "LangfuseFallbackServed";
-export interface LangfuseFallbackMetricDimensions {
-    feature?: string;
-    promptName?: string;
-    reason?: string;
-}
-/**
- * Emits a single fallback-served data point. Consumers inject a real CloudWatch
- * implementation at the composition root; the default is a no-op so the gateway
- * carries no AWS dependency and tracing stays fire-and-forget.
- */
-export type LangfuseFallbackMetricEmitter = (dimensions: LangfuseFallbackMetricDimensions) => void;
-export declare const noopFallbackMetricEmitter: LangfuseFallbackMetricEmitter;
-export declare function setFallbackMetricEmitter(emitter: LangfuseFallbackMetricEmitter): void;
-export declare function emitLangfuseFallbackServed(dimensions: LangfuseFallbackMetricDimensions): void;

package/dist/utilities/llmTracing/fallbackMetric.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.noopFallbackMetricEmitter = exports.LANGFUSE_FALLBACK_SERVED_METRIC = exports.LANGFUSE_METRIC_NAMESPACE = void 0;
-exports.setFallbackMetricEmitter = setFallbackMetricEmitter;
-exports.emitLangfuseFallbackServed = emitLangfuseFallbackServed;
-/**
- * CloudWatch namespace + metric name for the fallback-serving alarm. PR2's
- * runtime gate calls the emitter when it serves the fallback prompt snapshot; a
- * CloudWatch alarm on this metric routes to the standard alerting path.
- */
-exports.LANGFUSE_METRIC_NAMESPACE = 'LLMGateway';
-exports.LANGFUSE_FALLBACK_SERVED_METRIC = 'LangfuseFallbackServed';
-const noopFallbackMetricEmitter = () => {
-    // no-op default; PR2 injects the CloudWatch emitter at the composition root.
-};
-exports.noopFallbackMetricEmitter = noopFallbackMetricEmitter;
-let activeFallbackMetricEmitter = exports.noopFallbackMetricEmitter;
-function setFallbackMetricEmitter(emitter) {
-    activeFallbackMetricEmitter = emitter;
-}
-function emitLangfuseFallbackServed(dimensions) {
-    activeFallbackMetricEmitter(dimensions);
-}
-//# sourceMappingURL=fallbackMetric.js.map

package/dist/utilities/llmTracing/fallbackMetric.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fallbackMetric.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/fallbackMetric.ts"],"names":[],"mappings":";;;AA+BA,4DAIC;AAED,gEAIC;AAzCD;;;;GAIG;AACU,QAAA,yBAAyB,GAAG,YAAY,CAAC;AAEzC,QAAA,+BAA+B,GAAG,wBAAwB,CAAC;AAiBjE,MAAM,yBAAyB,GAAkC,GAAG,EAAE;IAC3E,6EAA6E;AAC/E,CAAC,CAAC;AAFW,QAAA,yBAAyB,6BAEpC;AAEF,IAAI,2BAA2B,GAC3B,iCAAyB,CAAC;AAE9B,SAAgB,wBAAwB,CACtC,OAAsC;IAEtC,2BAA2B,GAAG,OAAO,CAAC;AACxC,CAAC;AAED,SAAgB,0BAA0B,CACxC,UAA4C;IAE5C,2BAA2B,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC"}

package/dist/utilities/llmTracing/withLLMTrace.d.ts

@@ -1,12 +0,0 @@
-import { type LLMTraceMetadata } from '../../utilities/llmTracing/llmTracing.typedefs';
-/**
- * Low-level trace wrapper for code outside the UseCase / Service base classes.
- * Starts a trace named `name`; any gateway calls inside nest automatically via
- * OTel context. A no-op when tracing is disabled.
- */
-export declare function withLLMTrace<Result>(name: string, metadata: LLMTraceMetadata, fn: () => Promise<Result>): Promise<Result>;
-/**
- * Flushes buffered traces. Serverless handlers call this on completion; the
- * long-running API calls it from its shutdown hook only.
- */
-export declare function flushLLMTraces(): Promise<void>;

package/dist/utilities/llmTracing/withLLMTrace.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withLLMTrace = withLLMTrace;
-exports.flushLLMTraces = flushLLMTraces;
-const activeLLMTracer_1 = require("../../utilities/llmTracing/activeLLMTracer");
-/**
- * Low-level trace wrapper for code outside the UseCase / Service base classes.
- * Starts a trace named `name`; any gateway calls inside nest automatically via
- * OTel context. A no-op when tracing is disabled.
- */
-function withLLMTrace(name, metadata, fn) {
-    return (0, activeLLMTracer_1.getActiveLLMTracer)().withTrace(name, { metadata }, fn);
-}
-/**
- * Flushes buffered traces. Serverless handlers call this on completion; the
- * long-running API calls it from its shutdown hook only.
- */
-function flushLLMTraces() {
-    return (0, activeLLMTracer_1.getActiveLLMTracer)().flush();
-}
-//# sourceMappingURL=withLLMTrace.js.map

package/dist/utilities/llmTracing/withLLMTrace.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"withLLMTrace.js","sourceRoot":"","sources":["../../../src/utilities/llmTracing/withLLMTrace.ts"],"names":[],"mappings":";;AAQA,oCAMC;AAMD,wCAEC;AAtBD,4EAA4E;AAG5E;;;;GAIG;AACH,SAAgB,YAAY,CAC1B,IAAY,EACZ,QAA0B,EAC1B,EAAyB;IAEzB,OAAO,IAAA,oCAAkB,GAAE,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,SAAgB,cAAc;IAC5B,OAAO,IAAA,oCAAkB,GAAE,CAAC,KAAK,EAAE,CAAC;AACtC,CAAC"}