openlit 1.13.0 → 1.14.0

package/dist/instrumentation/elevenlabs/wrapper.js

@@ -0,0 +1,280 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const api_1 = require("@opentelemetry/api");
+const config_1 = __importDefault(require("../../config"));
+const helpers_1 = __importStar(require("../../helpers"));
+const semantic_convention_1 = __importDefault(require("../../semantic-convention"));
+const base_wrapper_1 = __importDefault(require("../base-wrapper"));
+function spanCreationAttrs(operationName, requestModel, serverAddress, serverPort) {
+    return {
+        [semantic_convention_1.default.GEN_AI_OPERATION]: operationName,
+        [semantic_convention_1.default.GEN_AI_PROVIDER_NAME_OTEL]: ElevenLabsWrapper.aiSystem,
+        [semantic_convention_1.default.GEN_AI_REQUEST_MODEL]: requestModel,
+        [semantic_convention_1.default.SERVER_ADDRESS]: serverAddress,
+        [semantic_convention_1.default.SERVER_PORT]: serverPort,
+    };
+}
+class ElevenLabsWrapper extends base_wrapper_1.default {
+    static _parseAudioArgs(args) {
+        const voiceId = typeof args[0] === 'string'
+            ? args[0]
+            : (args[0]?.voice_id || args[0]?.voiceId || '');
+        const options = typeof args[0] === 'object' && args[0] !== null && typeof args[0] !== 'string'
+            ? args[0]
+            : (args[1] || {});
+        const requestModel = options.modelId || options.model_id || options.model || 'eleven_multilingual_v2';
+        const text = options.text || options.input || '';
+        const voiceSettings = options.voiceSettings ?? options.voice_settings ?? '';
+        const outputFormat = options.outputFormat || options.output_format || 'mp3_44100_128';
+        return { voiceId, options, requestModel, text, voiceSettings, outputFormat };
+    }
+    static _patchConvert(tracer, methodName, sdkVersion) {
+        const genAIEndpoint = `elevenlabs.textToSpeech.${methodName}`;
+        return (originalMethod) => {
+            return async function (...args) {
+                if ((0, helpers_1.isFrameworkLlmActive)())
+                    return originalMethod.apply(this, args);
+                const { requestModel } = ElevenLabsWrapper._parseAudioArgs(args);
+                const spanName = `${semantic_convention_1.default.GEN_AI_OPERATION_TYPE_AUDIO} ${requestModel}`;
+                const effectiveCtx = (0, helpers_1.getFrameworkParentContext)() ?? api_1.context.active();
+                const span = tracer.startSpan(spanName, {
+                    kind: api_1.SpanKind.CLIENT,
+                    attributes: spanCreationAttrs(semantic_convention_1.default.GEN_AI_OPERATION_TYPE_AUDIO, requestModel, ElevenLabsWrapper.serverAddress, ElevenLabsWrapper.serverPort),
+                }, effectiveCtx);
+                return api_1.context.with(api_1.trace.setSpan(effectiveCtx, span), async () => {
+                    let metricParams;
+                    const startTime = Date.now();
+                    try {
+                        const response = await originalMethod.apply(this, args);
+                        const ttft = (Date.now() - startTime) / 1000;
+                        metricParams = ElevenLabsWrapper._commonAudioSetter({
+                            args,
+                            genAIEndpoint,
+                            span,
+                            ttft,
+                            tbt: 0,
+                            isStream: false,
+                            sdkVersion,
+                        });
+                        return response;
+                    }
+                    catch (e) {
+                        helpers_1.default.handleException(span, e);
+                        base_wrapper_1.default.recordMetrics(span, {
+                            genAIEndpoint,
+                            model: requestModel,
+                            aiSystem: ElevenLabsWrapper.aiSystem,
+                            serverAddress: ElevenLabsWrapper.serverAddress,
+                            serverPort: ElevenLabsWrapper.serverPort,
+                            errorType: e?.constructor?.name || '_OTHER',
+                        });
+                        throw e;
+                    }
+                    finally {
+                        span.end();
+                        if (metricParams) {
+                            base_wrapper_1.default.recordMetrics(span, metricParams);
+                        }
+                    }
+                });
+            };
+        };
+    }
+    static _patchStream(tracer, methodName, sdkVersion) {
+        const genAIEndpoint = `elevenlabs.textToSpeech.${methodName}`;
+        return (originalMethod) => {
+            return async function (...args) {
+                if ((0, helpers_1.isFrameworkLlmActive)())
+                    return originalMethod.apply(this, args);
+                const { requestModel } = ElevenLabsWrapper._parseAudioArgs(args);
+                const spanName = `${semantic_convention_1.default.GEN_AI_OPERATION_TYPE_AUDIO} ${requestModel}`;
+                const effectiveCtx = (0, helpers_1.getFrameworkParentContext)() ?? api_1.context.active();
+                const span = tracer.startSpan(spanName, {
+                    kind: api_1.SpanKind.CLIENT,
+                    attributes: spanCreationAttrs(semantic_convention_1.default.GEN_AI_OPERATION_TYPE_AUDIO, requestModel, ElevenLabsWrapper.serverAddress, ElevenLabsWrapper.serverPort),
+                }, effectiveCtx);
+                return api_1.context.with(api_1.trace.setSpan(effectiveCtx, span), async () => {
+                    try {
+                        const response = await originalMethod.apply(this, args);
+                        return helpers_1.default.createStreamProxy(response, ElevenLabsWrapper._streamGenerator({
+                            args,
+                            genAIEndpoint,
+                            response,
+                            span,
+                            sdkVersion,
+                        }));
+                    }
+                    catch (e) {
+                        helpers_1.default.handleException(span, e);
+                        base_wrapper_1.default.recordMetrics(span, {
+                            genAIEndpoint,
+                            model: requestModel,
+                            aiSystem: ElevenLabsWrapper.aiSystem,
+                            serverAddress: ElevenLabsWrapper.serverAddress,
+                            serverPort: ElevenLabsWrapper.serverPort,
+                            errorType: e?.constructor?.name || '_OTHER',
+                        });
+                        span.end();
+                        throw e;
+                    }
+                });
+            };
+        };
+    }
+    static async *_streamGenerator({ args, genAIEndpoint, response, span, sdkVersion, }) {
+        let metricParams;
+        const timestamps = [];
+        const startTime = Date.now();
+        try {
+            for await (const chunk of response) {
+                timestamps.push(Date.now());
+                yield chunk;
+            }
+            const ttft = timestamps.length > 0 ? (timestamps[0] - startTime) / 1000 : 0;
+            let tbt = 0;
+            if (timestamps.length > 1) {
+                const timeDiffs = timestamps.slice(1).map((t, i) => t - timestamps[i]);
+                tbt = timeDiffs.reduce((a, b) => a + b, 0) / timeDiffs.length / 1000;
+            }
+            metricParams = ElevenLabsWrapper._commonAudioSetter({
+                args,
+                genAIEndpoint,
+                span,
+                ttft,
+                tbt,
+                isStream: true,
+                sdkVersion,
+            });
+        }
+        catch (e) {
+            helpers_1.default.handleException(span, e);
+            const { requestModel } = ElevenLabsWrapper._parseAudioArgs(args);
+            base_wrapper_1.default.recordMetrics(span, {
+                genAIEndpoint,
+                model: requestModel,
+                aiSystem: ElevenLabsWrapper.aiSystem,
+                serverAddress: ElevenLabsWrapper.serverAddress,
+                serverPort: ElevenLabsWrapper.serverPort,
+                errorType: e?.constructor?.name || '_OTHER',
+            });
+            throw e;
+        }
+        finally {
+            span.end();
+            if (metricParams) {
+                base_wrapper_1.default.recordMetrics(span, metricParams);
+            }
+        }
+    }
+    static _commonAudioSetter({ args, genAIEndpoint, span, ttft = 0, tbt = 0, isStream = false, sdkVersion, }) {
+        const captureContent = config_1.default.captureMessageContent;
+        const { voiceId, requestModel, text, voiceSettings, outputFormat, } = ElevenLabsWrapper._parseAudioArgs(args);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_REQUEST_AUDIO_VOICE, voiceId);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_REQUEST_AUDIO_SETTINGS, voiceSettings === '' || voiceSettings == null
+            ? ''
+            : typeof voiceSettings === 'object'
+                ? JSON.stringify(voiceSettings)
+                : String(voiceSettings));
+        span.setAttribute(semantic_convention_1.default.GEN_AI_OUTPUT_TYPE, outputFormat);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_REQUEST_IS_STREAM, isStream);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_USAGE_INPUT_TOKENS, 0);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_USAGE_OUTPUT_TOKENS, 0);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_CLIENT_TOKEN_USAGE, 0);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS, 0);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_USAGE_CACHE_CREATION_INPUT_TOKENS, 0);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_SERVER_TTFT, ttft);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_SERVER_TBT, tbt);
+        const pricingInfo = config_1.default.pricingInfo || {};
+        const cost = helpers_1.default.getAudioModelCost(requestModel, pricingInfo, text);
+        ElevenLabsWrapper.setBaseSpanAttributes(span, {
+            genAIEndpoint,
+            model: requestModel,
+            cost,
+            aiSystem: ElevenLabsWrapper.aiSystem,
+            serverAddress: ElevenLabsWrapper.serverAddress,
+            serverPort: ElevenLabsWrapper.serverPort,
+        });
+        // Python stamps gen_ai.system and the ElevenLabs package version (not OpenLIT's).
+        span.setAttribute(semantic_convention_1.default.GEN_AI_PROVIDER_NAME, ElevenLabsWrapper.aiSystem);
+        span.setAttribute(semantic_convention_1.default.GEN_AI_RESPONSE_MODEL, requestModel);
+        if (sdkVersion) {
+            span.setAttribute(semantic_convention_1.default.GEN_AI_SDK_VERSION, sdkVersion);
+        }
+        let inputMessagesJson;
+        let outputMessagesJson;
+        if (captureContent) {
+            inputMessagesJson = helpers_1.default.buildInputMessages([{ role: 'user', content: text }]);
+            outputMessagesJson = helpers_1.default.buildOutputMessages('[audio generated]', 'stop');
+            span.setAttribute(semantic_convention_1.default.GEN_AI_INPUT_MESSAGES, inputMessagesJson);
+            span.setAttribute(semantic_convention_1.default.GEN_AI_OUTPUT_MESSAGES, outputMessagesJson);
+        }
+        if (!config_1.default.disableEvents) {
+            const eventAttrs = {
+                [semantic_convention_1.default.GEN_AI_OPERATION]: semantic_convention_1.default.GEN_AI_OPERATION_TYPE_AUDIO,
+                [semantic_convention_1.default.GEN_AI_REQUEST_MODEL]: requestModel,
+                [semantic_convention_1.default.GEN_AI_RESPONSE_MODEL]: requestModel,
+                [semantic_convention_1.default.SERVER_ADDRESS]: ElevenLabsWrapper.serverAddress,
+                [semantic_convention_1.default.SERVER_PORT]: ElevenLabsWrapper.serverPort,
+                [semantic_convention_1.default.GEN_AI_OUTPUT_TYPE]: outputFormat,
+                [semantic_convention_1.default.GEN_AI_USAGE_INPUT_TOKENS]: 0,
+                [semantic_convention_1.default.GEN_AI_USAGE_OUTPUT_TOKENS]: 0,
+            };
+            if (captureContent) {
+                if (inputMessagesJson)
+                    eventAttrs[semantic_convention_1.default.GEN_AI_INPUT_MESSAGES] = inputMessagesJson;
+                if (outputMessagesJson)
+                    eventAttrs[semantic_convention_1.default.GEN_AI_OUTPUT_MESSAGES] = outputMessagesJson;
+            }
+            helpers_1.default.emitInferenceEvent(span, eventAttrs);
+        }
+        return {
+            genAIEndpoint,
+            model: requestModel,
+            cost,
+            aiSystem: ElevenLabsWrapper.aiSystem,
+            serverAddress: ElevenLabsWrapper.serverAddress,
+            serverPort: ElevenLabsWrapper.serverPort,
+        };
+    }
+}
+ElevenLabsWrapper.aiSystem = semantic_convention_1.default.GEN_AI_SYSTEM_ELEVENLABS;
+ElevenLabsWrapper.serverAddress = 'api.elevenlabs.io';
+ElevenLabsWrapper.serverPort = 443;
+exports.default = ElevenLabsWrapper;
+//# sourceMappingURL=wrapper.js.map

package/dist/instrumentation/elevenlabs/wrapper.js.map

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

package/dist/instrumentation/firecrawl/index.d.ts

@@ -0,0 +1,13 @@
+import { InstrumentationBase, InstrumentationModuleDefinition } from '@opentelemetry/instrumentation';
+import { InstrumentationConfig } from '@opentelemetry/instrumentation';
+export interface FirecrawlInstrumentationConfig extends InstrumentationConfig {
+}
+export default class OpenlitFirecrawlInstrumentation extends InstrumentationBase {
+    constructor(config?: FirecrawlInstrumentationConfig);
+    protected init(): void | InstrumentationModuleDefinition | InstrumentationModuleDefinition[];
+    manualPatch(firecrawl: any): void;
+    protected _patch(moduleExports: any, moduleVersion?: string): void;
+    private _resolveClasses;
+    private _patchClass;
+    protected _unpatch(moduleExports: any): void;
+}

package/dist/instrumentation/firecrawl/index.js

@@ -0,0 +1,115 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const instrumentation_1 = require("@opentelemetry/instrumentation");
+const api_1 = require("@opentelemetry/api");
+const constant_1 = require("../../constant");
+const wrapper_1 = __importDefault(require("./wrapper"));
+/**
+ * Firecrawl JS method name -> Python endpoint identifier.
+ *
+ * The endpoint string drives the operation name and span name so TS and Python
+ * emit aligned telemetry. The JS SDK (`@mendable/firecrawl-js` v1) exposes a
+ * single Promise-returning `FirecrawlApp` class, so Python's sync/async pairs
+ * collapse onto their camelCase JS equivalents here.
+ *
+ * Intentionally not wrapped:
+ * - `crawlUrlAndWatch` / `batchScrapeUrlsAndWatch` — they call
+ *   `asyncCrawlUrl` / `asyncBatchScrapeUrls`, which are already instrumented.
+ * - Internal helpers (`prepareHeaders`, `postRequest`, `getRequest`, …).
+ * - Newer product surfaces (deepResearch, generateLLMsText) — no Python parity yet.
+ */
+const FIRECRAWL_METHODS = [
+    ['scrapeUrl', 'firecrawl.scrape_url'],
+    ['crawlUrl', 'firecrawl.crawl_url'],
+    ['asyncCrawlUrl', 'firecrawl.async_crawl_url'],
+    ['mapUrl', 'firecrawl.map_url'],
+    ['search', 'firecrawl.search'],
+    ['extract', 'firecrawl.extract'],
+    ['asyncExtract', 'firecrawl.async_extract'],
+    ['getExtractStatus', 'firecrawl.get_extract_status'],
+    ['batchScrapeUrls', 'firecrawl.batch_scrape_urls'],
+    ['asyncBatchScrapeUrls', 'firecrawl.async_batch_scrape_urls'],
+    ['checkCrawlStatus', 'firecrawl.crawl_status'],
+    ['checkBatchScrapeStatus', 'firecrawl.get_scrape_status'],
+    ['cancelCrawl', 'firecrawl.cancel_crawl'],
+];
+class OpenlitFirecrawlInstrumentation extends instrumentation_1.InstrumentationBase {
+    constructor(config = {}) {
+        super(`${constant_1.INSTRUMENTATION_PREFIX}/instrumentation-firecrawl`, '1.0.0', config);
+    }
+    init() {
+        const module = new instrumentation_1.InstrumentationNodeModuleDefinition('@mendable/firecrawl-js', ['>=1.0.0 <4'], (moduleExports, moduleVersion) => {
+            this._patch(moduleExports, moduleVersion);
+            return moduleExports;
+        }, (moduleExports) => {
+            if (moduleExports !== undefined)
+                this._unpatch(moduleExports);
+        });
+        return [module];
+    }
+    manualPatch(firecrawl) {
+        this._patch(firecrawl);
+    }
+    _patch(moduleExports, moduleVersion) {
+        try {
+            const sdkVersion = moduleVersion ? String(moduleVersion) : undefined;
+            for (const target of this._resolveClasses(moduleExports)) {
+                this._patchClass(target, sdkVersion);
+            }
+        }
+        catch (e) {
+            api_1.diag.error('firecrawl instrumentation: error in _patch method', e);
+        }
+    }
+    _resolveClasses(moduleExports) {
+        const candidates = [
+            moduleExports?.FirecrawlApp,
+            moduleExports?.AsyncFirecrawlApp,
+            moduleExports?.Firecrawl,
+            moduleExports?.default,
+            moduleExports,
+        ];
+        const seen = new Set();
+        return candidates.filter((cls) => {
+            if (typeof cls !== 'function' || seen.has(cls))
+                return false;
+            seen.add(cls);
+            return true;
+        });
+    }
+    _patchClass(target, sdkVersion) {
+        const proto = target?.prototype;
+        if (!proto)
+            return;
+        for (const [method, endpoint] of FIRECRAWL_METHODS) {
+            if (typeof proto[method] !== 'function')
+                continue;
+            // Already wrapped — skip to avoid unwrap/rewrap churn on re-patch.
+            if ((0, instrumentation_1.isWrapped)(proto[method]))
+                continue;
+            this._wrap(proto, method, wrapper_1.default._patchOperation(this.tracer, endpoint, sdkVersion));
+        }
+    }
+    _unpatch(moduleExports) {
+        try {
+            for (const target of this._resolveClasses(moduleExports)) {
+                const proto = target?.prototype;
+                if (!proto)
+                    continue;
+                for (const [method] of FIRECRAWL_METHODS) {
+                    if (typeof proto[method] === 'function' && (0, instrumentation_1.isWrapped)(proto[method])) {
+                        this._unwrap(proto, method);
+                    }
+                }
+            }
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+exports.default = OpenlitFirecrawlInstrumentation;
+//# sourceMappingURL=index.js.map

package/dist/instrumentation/firecrawl/index.js.map

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

package/dist/instrumentation/firecrawl/wrapper.d.ts

@@ -0,0 +1,22 @@
+import { Span, Tracer } from '@opentelemetry/api';
+declare class FirecrawlWrapper {
+    static aiSystem: string;
+    /**
+     * Wraps a Promise-returning Firecrawl method into a CLIENT span named
+     * `{operation} {target}`. `endpoint` is the Python-style endpoint id that
+     * drives the operation name.
+     */
+    static _patchOperation(tracer: Tracer, endpoint: string, version?: string): any;
+    /** Framework + request attributes (Python `set_span_attributes` parity). */
+    static _setSpanAttributes(span: Span, operation: string, sdkVersion: string, url: string, urls: string[], isMultiUrl: boolean): void;
+    /** Response business-intelligence attributes (Python `process_response` parity). */
+    static _processResponse(span: Span, response: any, url: string): void;
+    private static _processSingleResponse;
+    private static _captureContentSummary;
+    /**
+     * Firecrawl-specific error attributes. `OpenLitHelper.handleException` still
+     * records the exception, ERROR status, and `error.type`.
+     */
+    static _handleError(span: Span, error: any): void;
+}
+export default FirecrawlWrapper;