@rudderhq/server 0.1.0-canary.0

package/dist/langfuse.js

@@ -0,0 +1,412 @@
+import { createHash } from "node:crypto";
+import { LangfuseClient } from "@langfuse/client";
+import { LangfuseSpanProcessor } from "@langfuse/otel";
+import { createTraceId, getActiveTraceId, LangfuseOtelSpanAttributes, propagateAttributes, setLangfuseTracerProvider, startActiveObservation, startObservation, } from "@langfuse/tracing";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { logger } from "./middleware/logger.js";
+const traceIdCache = new Map();
+const traceUrlCache = new Map();
+let runtimeConfig = null;
+let client = null;
+let provider = null;
+function stableHex(seed, length) {
+    return createHash("sha256").update(seed).digest("hex").slice(0, length);
+}
+export function createStableUuid(seed) {
+    const hex = stableHex(seed, 32).split("");
+    hex[12] = "4";
+    hex[16] = ["8", "9", "a", "b"][Number.parseInt(hex[16] ?? "0", 16) % 4] ?? "8";
+    return `${hex.slice(0, 8).join("")}-${hex.slice(8, 12).join("")}-${hex.slice(12, 16).join("")}-${hex.slice(16, 20).join("")}-${hex.slice(20, 32).join("")}`;
+}
+export function createExecutionScoreId(rootExecutionId, scoreName) {
+    return createStableUuid(`langfuse-score:${rootExecutionId}:${scoreName}`);
+}
+function coerceString(value) {
+    if (typeof value === "string" && value.trim().length > 0)
+        return value.trim();
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    return null;
+}
+export function redactLangfuseValue(value) {
+    if (value == null)
+        return value;
+    if (typeof value === "string") {
+        if (/sk-[a-z0-9]/i.test(value) || /api[_-]?key/i.test(value))
+            return "***REDACTED***";
+        return value;
+    }
+    if (typeof value === "number" || typeof value === "boolean")
+        return value;
+    if (Array.isArray(value))
+        return value.map((item) => redactLangfuseValue(item));
+    if (typeof value === "object") {
+        return Object.fromEntries(Object.entries(value).map(([key, nested]) => {
+            const lowered = key.toLowerCase();
+            if (lowered.includes("secret") ||
+                lowered.includes("token") ||
+                lowered.includes("password") ||
+                lowered.includes("apikey") ||
+                lowered.includes("api_key")) {
+                if (typeof nested === "number" || typeof nested === "boolean" || nested == null) {
+                    return [key, nested];
+                }
+                return [key, "***REDACTED***"];
+            }
+            return [key, redactLangfuseValue(nested)];
+        }));
+    }
+    return String(value);
+}
+function buildTags(context) {
+    const tags = new Set(context.tags ?? []);
+    const identity = resolveLangfuseTraceIdentity(context);
+    tags.add(`surface:${context.surface}`);
+    if (context.runtime)
+        tags.add(`runtime:${context.runtime}`);
+    if (context.trigger)
+        tags.add(`trigger:${context.trigger}`);
+    if (context.status)
+        tags.add(`status:${context.status}`);
+    if (context.localEnv)
+        tags.add(`localEnv:${context.localEnv}`);
+    if (context.deploymentMode)
+        tags.add(`deploymentMode:${context.deploymentMode}`);
+    if (identity.environment)
+        tags.add(`environment:${identity.environment}`);
+    if (identity.instanceId)
+        tags.add(`instance:${identity.instanceId}`);
+    if (identity.release)
+        tags.add(`release:${identity.release}`);
+    return [...tags];
+}
+export function resolveLangfuseTraceIdentity(context = {}, config = runtimeConfig) {
+    return {
+        environment: coerceString(context.environment ?? config?.environment),
+        instanceId: coerceString(context.instanceId ?? config?.instanceId),
+        release: coerceString(context.release ?? config?.release),
+    };
+}
+function buildPropagatedMetadata(context) {
+    const identity = resolveLangfuseTraceIdentity(context);
+    const propagated = {
+        surface: context.surface,
+        rootExecutionId: context.rootExecutionId,
+    };
+    for (const [key, value] of Object.entries({
+        orgId: context.orgId,
+        agentId: context.agentId,
+        issueId: context.issueId,
+        pluginId: context.pluginId,
+        sessionKey: context.sessionKey,
+        runtime: context.runtime,
+        trigger: context.trigger,
+        status: context.status,
+        environment: identity.environment,
+        release: identity.release,
+        instanceId: identity.instanceId,
+        deploymentMode: context.deploymentMode ?? runtimeConfig?.deploymentMode,
+        localEnv: context.localEnv ?? runtimeConfig?.localEnv,
+    })) {
+        const next = coerceString(value);
+        if (next)
+            propagated[key] = next;
+    }
+    for (const [key, value] of Object.entries(context.metadata ?? {})) {
+        const next = coerceString(value);
+        if (next)
+            propagated[key] = next;
+    }
+    return propagated;
+}
+function buildObservationMetadata(context, metadata) {
+    const identity = resolveLangfuseTraceIdentity(context);
+    return {
+        surface: context.surface,
+        rootExecutionId: context.rootExecutionId,
+        orgId: context.orgId ?? null,
+        agentId: context.agentId ?? null,
+        issueId: context.issueId ?? null,
+        pluginId: context.pluginId ?? null,
+        sessionKey: context.sessionKey ?? null,
+        runtime: context.runtime ?? null,
+        trigger: context.trigger ?? null,
+        status: context.status ?? null,
+        environment: identity.environment ?? null,
+        release: identity.release ?? null,
+        instanceId: identity.instanceId ?? null,
+        deploymentMode: context.deploymentMode ?? runtimeConfig?.deploymentMode ?? null,
+        localEnv: context.localEnv ?? runtimeConfig?.localEnv ?? null,
+        ...redactLangfuseValue(context.metadata ?? {}),
+        ...redactLangfuseValue(metadata ?? {}),
+    };
+}
+function buildExecutionObservationAttributes(context, attributes) {
+    const identity = resolveLangfuseTraceIdentity(context);
+    return {
+        ...attributes,
+        input: redactLangfuseValue(attributes.input),
+        output: redactLangfuseValue(attributes.output),
+        metadata: buildObservationMetadata(context, attributes.metadata),
+        environment: identity.environment ?? undefined,
+        version: identity.release ?? undefined,
+    };
+}
+function buildTraceIoAttributes(attributes) {
+    const traceIo = {};
+    if (attributes.input !== undefined)
+        traceIo.input = redactLangfuseValue(attributes.input);
+    if (attributes.output !== undefined)
+        traceIo.output = redactLangfuseValue(attributes.output);
+    return traceIo;
+}
+export async function getExecutionTraceId(rootExecutionId) {
+    const cached = traceIdCache.get(rootExecutionId);
+    if (cached)
+        return cached;
+    const traceId = await createTraceId(rootExecutionId);
+    traceIdCache.set(rootExecutionId, traceId);
+    return traceId;
+}
+async function createDetachedParentSpanContext(rootExecutionId) {
+    return {
+        traceId: await getExecutionTraceId(rootExecutionId),
+        spanId: stableHex(`rudder:${rootExecutionId}`, 16),
+        traceFlags: 1,
+    };
+}
+function withPropagatedContext(context, opts, fn) {
+    return propagateAttributes({
+        sessionId: context.sessionKey ?? context.rootExecutionId,
+        version: context.release ?? runtimeConfig?.release,
+        traceName: opts.includeTraceAttributes ? `${context.surface}:${context.rootExecutionId}` : undefined,
+        tags: opts.includeTraceAttributes ? buildTags(context) : undefined,
+        metadata: opts.includeTraceAttributes ? buildPropagatedMetadata(context) : undefined,
+    }, fn);
+}
+export function isLangfuseEnabled() {
+    return Boolean(runtimeConfig?.enabled && client && provider);
+}
+export function initializeLangfuse(config) {
+    runtimeConfig = config;
+    if (!config.enabled) {
+        logger.info("Langfuse integration disabled");
+        return;
+    }
+    if (!config.publicKey || !config.secretKey) {
+        logger.warn("Langfuse enabled but credentials are missing; integration disabled");
+        return;
+    }
+    provider = new NodeTracerProvider({
+        spanProcessors: [
+            new LangfuseSpanProcessor({
+                publicKey: config.publicKey,
+                secretKey: config.secretKey,
+                baseUrl: config.baseUrl,
+                environment: config.environment,
+                release: config.release,
+            }),
+        ],
+    });
+    provider.register();
+    setLangfuseTracerProvider(provider);
+    client = new LangfuseClient({
+        publicKey: config.publicKey,
+        secretKey: config.secretKey,
+        baseUrl: config.baseUrl,
+    });
+    logger.info({
+        baseUrl: config.baseUrl,
+        environment: config.environment ?? null,
+        instanceId: config.instanceId,
+        release: config.release,
+    }, "Langfuse integration initialized");
+}
+export async function shutdownLangfuse() {
+    await client?.shutdown().catch((error) => {
+        logger.warn({ err: error instanceof Error ? error.message : String(error) }, "Langfuse client shutdown failed");
+    });
+    await provider?.shutdown().catch((error) => {
+        logger.warn({ err: error instanceof Error ? error.message : String(error) }, "Langfuse tracer shutdown failed");
+    });
+    setLangfuseTracerProvider(null);
+    client = null;
+    provider = null;
+}
+async function startActiveTypedObservation(name, asType, fn, options) {
+    switch (asType) {
+        case "agent":
+            return startActiveObservation(name, fn, { ...options, asType: "agent" });
+        case "generation":
+            return startActiveObservation(name, fn, { ...options, asType: "generation" });
+        case "tool":
+            return startActiveObservation(name, fn, { ...options, asType: "tool" });
+        case "chain":
+            return startActiveObservation(name, fn, { ...options, asType: "chain" });
+        case "retriever":
+            return startActiveObservation(name, fn, { ...options, asType: "retriever" });
+        case "evaluator":
+            return startActiveObservation(name, fn, { ...options, asType: "evaluator" });
+        case "guardrail":
+            return startActiveObservation(name, fn, { ...options, asType: "guardrail" });
+        case "embedding":
+            return startActiveObservation(name, fn, { ...options, asType: "embedding" });
+        default:
+            return startActiveObservation(name, fn, options);
+    }
+}
+function startTypedObservation(name, asType, attributes, options) {
+    switch (asType) {
+        case "event":
+            return startObservation(name, attributes, { ...options, asType: "event" });
+        case "agent":
+            return startObservation(name, attributes, { ...options, asType: "agent" });
+        case "generation":
+            return startObservation(name, attributes, { ...options, asType: "generation" });
+        case "tool":
+            return startObservation(name, attributes, { ...options, asType: "tool" });
+        case "chain":
+            return startObservation(name, attributes, { ...options, asType: "chain" });
+        case "retriever":
+            return startObservation(name, attributes, { ...options, asType: "retriever" });
+        case "evaluator":
+            return startObservation(name, attributes, { ...options, asType: "evaluator" });
+        case "guardrail":
+            return startObservation(name, attributes, { ...options, asType: "guardrail" });
+        case "embedding":
+            return startObservation(name, attributes, { ...options, asType: "embedding" });
+        default:
+            return startObservation(name, attributes, options);
+    }
+}
+export async function withExecutionObservation(context, input, fn) {
+    if (!isLangfuseEnabled())
+        return fn(null);
+    const activeTraceId = getActiveTraceId();
+    const options = activeTraceId
+        ? {}
+        : { parentSpanContext: await createDetachedParentSpanContext(context.rootExecutionId) };
+    return withPropagatedContext(context, { includeTraceAttributes: !activeTraceId }, () => startActiveTypedObservation(input.name, input.asType ?? "span", async (observation) => {
+        observation.updateOtelSpanAttributes(buildExecutionObservationAttributes(context, {
+            input: input.input,
+            metadata: input.metadata,
+        }));
+        if (input.input !== undefined) {
+            observation.setTraceIO(buildTraceIoAttributes({ input: input.input }));
+        }
+        return fn(observation);
+    }, options));
+}
+export async function observeExecutionEvent(context, input) {
+    if (!isLangfuseEnabled())
+        return null;
+    const activeTraceId = getActiveTraceId();
+    const options = activeTraceId
+        ? {}
+        : { parentSpanContext: await createDetachedParentSpanContext(context.rootExecutionId) };
+    return withPropagatedContext(context, { includeTraceAttributes: false }, () => {
+        const observation = startTypedObservation(input.name, input.asType ?? "event", buildExecutionObservationAttributes(context, input), options);
+        observation.end();
+        return {
+            traceId: observation.traceId,
+            traceUrl: null,
+        };
+    });
+}
+export function startExecutionChildObservation(parentObservation, context, input) {
+    if (!isLangfuseEnabled() || !parentObservation)
+        return null;
+    const { name, asType, startTime, ...attributes } = input;
+    return withPropagatedContext(context, { includeTraceAttributes: false }, () => startTypedObservation(name, asType ?? "span", buildExecutionObservationAttributes(context, attributes), {
+        parentSpanContext: parentObservation.otelSpan.spanContext(),
+        startTime,
+    }));
+}
+export function updateExecutionObservation(observation, context, attributes) {
+    if (!observation)
+        return;
+    observation.updateOtelSpanAttributes(buildExecutionObservationAttributes(context, attributes));
+}
+export function updateExecutionTraceIO(observation, attributes) {
+    if (!observation)
+        return;
+    const traceIo = buildTraceIoAttributes(attributes);
+    if (Object.keys(traceIo).length === 0)
+        return;
+    observation.setTraceIO(traceIo);
+}
+export function updateExecutionTraceSession(observation, sessionId) {
+    const next = coerceString(sessionId);
+    if (!observation || !next)
+        return;
+    observation.otelSpan.setAttributes({
+        [LangfuseOtelSpanAttributes.TRACE_SESSION_ID]: next,
+    });
+}
+export function updateExecutionTraceName(observation, traceName) {
+    const next = coerceString(traceName);
+    if (!observation || !next)
+        return;
+    observation.otelSpan.setAttributes({
+        [LangfuseOtelSpanAttributes.TRACE_NAME]: next,
+    });
+}
+export async function getExecutionLangfuseLink(rootExecutionId) {
+    if (!isLangfuseEnabled() || !client)
+        return null;
+    const traceId = await getExecutionTraceId(rootExecutionId);
+    const cachedUrl = traceUrlCache.get(traceId);
+    if (cachedUrl) {
+        return { traceId, traceUrl: cachedUrl };
+    }
+    try {
+        const traceUrl = await client.getTraceUrl(traceId);
+        traceUrlCache.set(traceId, traceUrl);
+        return { traceId, traceUrl };
+    }
+    catch (error) {
+        logger.warn({
+            rootExecutionId,
+            traceId,
+            err: error instanceof Error ? error.message : String(error),
+        }, "Failed to resolve Langfuse trace URL");
+        return { traceId, traceUrl: null };
+    }
+}
+export function normalizeLangfuseScoreValue(value) {
+    if (typeof value === "boolean") {
+        return { value: value ? 1 : 0, dataType: "BOOLEAN" };
+    }
+    if (typeof value === "number") {
+        return { value, dataType: "NUMERIC" };
+    }
+    return { value, dataType: "CATEGORICAL" };
+}
+export async function createExecutionScores(context, scores) {
+    if (!isLangfuseEnabled() || !client)
+        return;
+    const traceId = await getExecutionTraceId(context.rootExecutionId);
+    for (const score of scores) {
+        try {
+            const normalized = normalizeLangfuseScoreValue(score.value);
+            client.score.create({
+                id: score.id ?? createExecutionScoreId(context.rootExecutionId, score.name),
+                traceId,
+                name: score.name,
+                value: normalized.value,
+                comment: score.comment,
+                metadata: buildObservationMetadata(context, score.metadata),
+                environment: runtimeConfig?.environment,
+                dataType: normalized.dataType,
+            });
+        }
+        catch (error) {
+            logger.warn({
+                rootExecutionId: context.rootExecutionId,
+                scoreName: score.name,
+                err: error instanceof Error ? error.message : String(error),
+            }, "Failed to enqueue Langfuse score");
+        }
+    }
+}
+//# sourceMappingURL=langfuse.js.map

package/dist/langfuse.js.map

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

package/dist/local-runtime.d.ts

@@ -0,0 +1,67 @@
+export declare const LOCAL_RUNTIME_OWNER_KINDS: readonly ["cli", "desktop", "dev_runner", "server"];
+export type LocalRuntimeOwnerKind = (typeof LOCAL_RUNTIME_OWNER_KINDS)[number];
+export type LocalRuntimeDescriptor = {
+    instanceId: string;
+    localEnv: string | null;
+    pid: number;
+    listenPort: number;
+    apiUrl: string;
+    version: string;
+    ownerKind: LocalRuntimeOwnerKind;
+    startedAt: string;
+};
+export type RuntimeHealthSnapshot = {
+    status: "ok";
+    version?: string;
+    instanceId?: string;
+    localEnv?: string | null;
+    runtimeOwnerKind?: LocalRuntimeOwnerKind | null;
+};
+export type LocalRuntimePaths = {
+    runtimeDir: string;
+    descriptorPath: string;
+    lockPath: string;
+};
+export type LocalRuntimeProbe = {
+    kind: "missing";
+} | {
+    kind: "unusable";
+    reason: "invalid_descriptor" | "pid_dead" | "health_unreachable" | "health_mismatch";
+    descriptor?: LocalRuntimeDescriptor;
+    health?: RuntimeHealthSnapshot | null;
+} | {
+    kind: "healthy";
+    descriptor: LocalRuntimeDescriptor;
+    health: RuntimeHealthSnapshot;
+    versionMatches: boolean;
+};
+export declare function parseRuntimeOwnerKind(value: string | null | undefined): LocalRuntimeOwnerKind | null;
+export declare function resolveRuntimeOwnerKind(value?: string | null | undefined): LocalRuntimeOwnerKind | null;
+export declare function inferLocalEnvFromInstanceId(instanceId: string): string | null;
+export declare function resolveEffectiveLocalEnvName(instanceId?: string, value?: string | null | undefined): string | null;
+export declare function normalizeLangfuseEnvironmentName(value: string | null | undefined): string | null;
+export declare function resolveCanonicalStageName(value: string | null | undefined): string | null;
+export declare function resolveLangfuseEnvironmentName(value: string | null | undefined, fallbackLocalEnv?: string | null | undefined): string | null;
+export declare function resolveLocalRuntimePaths(instanceId?: string): LocalRuntimePaths;
+export declare function readLocalRuntimeDescriptor(instanceId?: string): Promise<LocalRuntimeDescriptor | null>;
+export declare function writeLocalRuntimeDescriptor(descriptor: LocalRuntimeDescriptor): Promise<void>;
+export declare function removeLocalRuntimeDescriptorIfOwned(input?: {
+    instanceId?: string;
+    pid?: number;
+    apiUrl?: string;
+}): Promise<void>;
+export declare function isPidRunning(pid: number): boolean;
+export declare function withRuntimeStartLock<T>(input: {
+    instanceId?: string;
+    ownerKind?: LocalRuntimeOwnerKind | null;
+    timeoutMs?: number;
+}, fn: () => Promise<T>): Promise<T>;
+export declare function fetchRuntimeHealth(apiUrl: string, timeoutMs?: number): Promise<RuntimeHealthSnapshot | null>;
+export declare function probeLocalRuntime(input?: {
+    instanceId?: string;
+    localEnv?: string | null;
+    expectedVersion?: string | null;
+}): Promise<LocalRuntimeProbe>;
+export declare function gracefullyStopRuntime(descriptor: Pick<LocalRuntimeDescriptor, "pid" | "instanceId" | "apiUrl">, timeoutMs?: number): Promise<boolean>;
+export declare function localRuntimeDescriptorExists(instanceId?: string): boolean;
+//# sourceMappingURL=local-runtime.d.ts.map

package/dist/local-runtime.d.ts.map

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