@anvia/langfuse 1.0.0-rc.1 → 1.0.0-rc.2

package/dist/index.js

@@ -1,116 +1,155 @@
-// src/helpers.ts
-function modelInputMessage(message) {
-  const { metadata: _metadata, ...result } = message;
-  return result;
-}
-function modelInputMessages(messages) {
-  return messages.map(modelInputMessage);
-}
-function modelParameters(request) {
-  const params = {};
-  if (request.temperature !== void 0) params.temperature = request.temperature;
-  if (request.maxTokens !== void 0) params.maxTokens = request.maxTokens;
-  if (request.toolChoice !== void 0) {
-    params.toolChoice = typeof request.toolChoice === "string" ? request.toolChoice : request.toolChoice.name;
+// src/redaction.ts
+var DEFAULT_REPLACEMENT = "[REDACTED]";
+var MAX_DEPTH = 16;
+function createPiiRedactor(options = {}) {
+  const patterns = options.patterns ?? DEFAULT_PATTERNS;
+  const replacement = options.replacement ?? DEFAULT_REPLACEMENT;
+  const compiled = patterns.map((p) => ({
+    name: p.name,
+    regex: cloneRegex(p.regex, "g")
+  }));
+  const patternNamesList = patterns.map((p) => p.name);
+  function redactString(input) {
+    if (typeof input !== "string") return input;
+    let out = input;
+    for (const { name, regex } of compiled) {
+      out = applyPattern(out, name, regex, replacement);
+    }
+    return out;
   }
-  return params;
+  function redactObject(input) {
+    return redactValue(input, 0, redactString);
+  }
+  function redactMessages(input) {
+    return input.map((message) => redactMessage(message, redactString));
+  }
+  function patternNames() {
+    return patternNamesList;
+  }
+  return { redactString, redactObject, redactMessages, patternNames };
 }
-function usageDetails(usage) {
-  if (usage.details !== void 0 && Object.keys(usage.details).length > 0) {
-    return { ...usage.details };
+var DEFAULT_PATTERNS = [
+  { name: "email", regex: /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g },
+  { name: "creditCard", regex: /\b(?:\d[ -]?){13,19}\b/g },
+  { name: "ipv4", regex: /\b(?:\d{1,3}\.){3}\d{1,3}\b/g },
+  {
+    name: "phone",
+    regex: /(?<!\d)(?:\+\d{1,3}[\s.-]?)?(?:\(\d{2,4}\)[\s.-]?)?\d{3,4}[\s.-]?\d{3,4}(?:[\s.-]?\d{3,4})?(?!\d)/g
+  },
+  { name: "jwt", regex: /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g },
+  {
+    name: "apiKey",
+    regex: /\b(?:sk|pk|api|key|token)[-_][A-Za-z0-9]{16,}\b/gi
   }
-  return {
-    input: usage.inputTokens,
-    output: usage.outputTokens,
-    total: usage.totalTokens
-  };
+];
+function applyPattern(input, name, regex, replacement) {
+  if (name === "creditCard") {
+    return redactCreditCards(input, replacement);
+  }
+  return input.replace(regex, replacement);
 }
-function usageDetailsFromRecord(usage) {
-  if (isRecord(usage.details)) {
-    const details = Object.fromEntries(
-      Object.entries(usage.details).filter(
-        (entry) => typeof entry[1] === "number" && Number.isFinite(entry[1]) && entry[1] >= 0
-      )
-    );
-    if (Object.keys(details).length > 0) {
-      return details;
+function redactCreditCards(input, replacement) {
+  let out = "";
+  let i = 0;
+  while (i < input.length) {
+    const ch = input.charAt(i);
+    if (/\d/.test(ch)) {
+      const { length, valid } = longestLuhnChunk(input.slice(i));
+      if (valid) {
+        out += replacement;
+        i += length;
+        continue;
+      }
     }
+    out += ch;
+    i += 1;
   }
-  return {
-    input: numberValue(usage.inputTokens) ?? 0,
-    output: numberValue(usage.outputTokens) ?? 0,
-    total: numberValue(usage.totalTokens) ?? (numberValue(usage.inputTokens) ?? 0) + (numberValue(usage.outputTokens) ?? 0)
-  };
-}
-function childMetadata(args, agentId, agentName, childTurn) {
-  return {
-    source: "agent_tool_event",
-    childAgentId: agentId,
-    childAgentName: agentName,
-    childTurn,
-    parentToolName: args.toolName,
-    parentInternalCallId: args.internalCallId,
-    parentToolCallId: args.toolCallId
-  };
-}
-function generationKey(agentId, turn) {
-  return `${agentId}:${turn}`;
+  return out;
 }
-function agentLabel(agentId, agentName) {
-  return (agentName ?? agentId).replaceAll(/\s+/g, "_");
+function longestLuhnChunk(s) {
+  let length = 0;
+  let bestValid = 0;
+  while (length < s.length && length < 40) {
+    const ch = s.charAt(length);
+    if (!/\d/.test(ch) && ch !== "-") break;
+    length += 1;
+    const candidate = s.slice(0, length).replace(/\D/g, "");
+    if (candidate.length >= 13 && candidate.length <= 19) {
+      if (startsWithKnownPrefix(candidate) && passesLuhn(candidate)) {
+        bestValid = length;
+      }
+    }
+  }
+  return { length: bestValid, valid: bestValid > 0 };
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+function startsWithKnownPrefix(digits) {
+  if (digits.startsWith("4")) return true;
+  const two = digits.slice(0, 2);
+  if (two === "51" || two === "52" || two === "53" || two === "54" || two === "55") return true;
+  const four = digits.slice(0, 4);
+  if (four === "2221" || four === "2720") return true;
+  const twoAgain = digits.slice(0, 2);
+  if (twoAgain === "34" || twoAgain === "37") return true;
+  if (four === "6011" || twoAgain === "65") return true;
+  return digits.startsWith("35");
 }
-function numberValue(value) {
-  return typeof value === "number" ? value : void 0;
+function passesLuhn(digits) {
+  if (!/^\d+$/.test(digits)) return false;
+  let sum = 0;
+  let alt = false;
+  for (let i = digits.length - 1; i >= 0; i -= 1) {
+    const raw = digits.charCodeAt(i) - 48;
+    let value = raw;
+    if (alt) {
+      value *= 2;
+      if (value > 9) value -= 9;
+    }
+    sum += value;
+    alt = !alt;
+  }
+  return sum % 10 === 0;
 }
-function emptyToUndefined(value) {
-  return value === void 0 || value.length === 0 ? void 0 : value;
+function cloneRegex(source, flags) {
+  return new RegExp(source.source, flags + source.flags.replace(/g/g, ""));
 }
-function errorMessage(error) {
-  return error instanceof Error ? error.message : String(error);
+function redactValue(value, depth, redactStringFn) {
+  if (depth > MAX_DEPTH) return value;
+  if (typeof value === "string") {
+    return isBase64DataUrl(value) ? value : redactStringFn(value);
+  }
+  if (Array.isArray(value))
+    return value.map((entry) => redactValue(entry, depth + 1, redactStringFn));
+  if (value !== null && typeof value === "object") {
+    if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
+      return value;
+    }
+    const record = value;
+    const out = {};
+    for (const [key, entry] of Object.entries(record)) {
+      if (key === "data" && typeof entry === "string" && (record.type === "base64" || record.type === "image" || record.type === "encrypted" || record.type === "redacted")) {
+        out[key] = entry;
+      } else {
+        out[key] = redactValue(entry, depth + 1, redactStringFn);
+      }
+    }
+    return out;
+  }
+  return value;
 }
-
-// src/config.ts
-var langfuseResolvedConfigSymbol = /* @__PURE__ */ Symbol.for(
-  "@anvia/langfuse.resolvedConfig"
-);
-function resolveLangfuseConfig(options = {}, fallback) {
+function redactMessage(message, redactStringFn) {
+  if (message.role === "system") {
+    return { ...message, content: redactStringFn(message.content) };
+  }
   return {
-    publicKey: resolveStringOption(
-      options.publicKey,
-      fallback?.publicKey,
-      process.env.LANGFUSE_PUBLIC_KEY
-    ),
-    secretKey: resolveStringOption(
-      options.secretKey,
-      fallback?.secretKey,
-      process.env.LANGFUSE_SECRET_KEY
-    ),
-    baseUrl: resolveStringOption(options.baseUrl, fallback?.baseUrl, process.env.LANGFUSE_BASE_URL) ?? "https://cloud.langfuse.com",
-    environment: resolveStringOption(
-      options.environment,
-      fallback?.environment,
-      process.env.LANGFUSE_TRACING_ENVIRONMENT
-    ),
-    release: resolveStringOption(options.release, fallback?.release, process.env.LANGFUSE_RELEASE),
-    serviceName: resolveStringOption(
-      options.serviceName,
-      fallback?.serviceName,
-      process.env.LANGFUSE_SERVICE_NAME
-    ),
-    timeoutMs: options.timeoutMs ?? fallback?.timeoutMs ?? 3e4
+    ...message,
+    content: redactMessageContent(message.content, redactStringFn)
   };
 }
-function getResolvedLangfuseConfig(value) {
-  if (typeof value !== "object" || value === null) {
-    return void 0;
-  }
-  return value[langfuseResolvedConfigSymbol];
+function redactMessageContent(value, redactStringFn) {
+  return redactValue(value, 0, redactStringFn);
 }
-function resolveStringOption(option, fallback, envVar) {
-  return emptyToUndefined(option) ?? emptyToUndefined(fallback) ?? emptyToUndefined(envVar);
+function isBase64DataUrl(value) {
+  return /^data:[^;,]+;base64,/i.test(value);
 }
 
 // src/scoring.ts
@@ -153,7 +192,7 @@ var ScoreQueue = class {
   timeoutMs;
   batchSize;
   flushIntervalMs;
-  maxRetries;
+  maxAttempts;
   fetchImpl;
   sleep;
   setTimer;
@@ -165,7 +204,7 @@ var ScoreQueue = class {
     this.timeoutMs = options.timeoutMs;
     this.batchSize = options.batchSize;
     this.flushIntervalMs = options.flushIntervalMs;
-    this.maxRetries = options.maxRetries;
+    this.maxAttempts = options.maxAttempts;
     this.fetchImpl = options.fetchImpl ?? fetch;
     this.sleep = options.sleep ?? defaultSleep;
     this.setTimer = options.setTimer ?? defaultSetTimer;
@@ -212,10 +251,7 @@ var ScoreQueue = class {
   async shutdown() {
     this.closed = true;
     this.clearScheduledTimer();
-    try {
-      await this.flush();
-    } catch {
-    }
+    await this.flush();
   }
   scheduleTimer() {
     if (this.timer !== null) {
@@ -239,7 +275,7 @@ var ScoreQueue = class {
   async sendBatch(scores) {
     const body = scores.map((score) => buildScoreBody(score));
     let lastError;
-    for (let attempt = 0; attempt < this.maxRetries; attempt += 1) {
+    for (let attempt = 0; attempt < this.maxAttempts; attempt += 1) {
       try {
         const response = await this.fetchImpl(`${this.baseUrl}/api/public/scores`, {
           method: "POST",
@@ -268,12 +304,12 @@ var ScoreQueue = class {
         }
         lastError = error;
       }
-      if (attempt < this.maxRetries - 1) {
+      if (attempt < this.maxAttempts - 1) {
         await this.sleep(computeBackoff(attempt));
       }
     }
     throw new RetryableLangfuseScoreError(
-      `Langfuse score batch failed after ${this.maxRetries} attempts`,
+      `Langfuse score batch failed after ${this.maxAttempts} attempts`,
       scores,
       lastError
     );
@@ -308,17 +344,251 @@ function buildScoreBody(score) {
     name: score.name,
     value: score.value
   };
-  if (score.observationId !== void 0) body.observationId = score.observationId;
-  if (score.dataType !== void 0) body.dataType = score.dataType;
-  if (score.comment !== void 0) body.comment = score.comment;
-  if (score.metadata !== void 0) body.metadata = score.metadata;
-  const configId = score.configId ?? score.scoreConfigId;
-  if (configId !== void 0) body.configId = configId;
-  if (score.environment !== void 0) body.environment = score.environment;
-  if (score.timestamp !== void 0) {
-    body.timestamp = score.timestamp instanceof Date ? score.timestamp.toISOString() : score.timestamp;
+  if (score.observationId !== void 0) body.observationId = score.observationId;
+  if (score.dataType !== void 0) body.dataType = score.dataType;
+  if (score.comment !== void 0) body.comment = score.comment;
+  if (score.metadata !== void 0) body.metadata = score.metadata;
+  const configId = score.configId ?? score.scoreConfigId;
+  if (configId !== void 0) body.configId = configId;
+  if (score.environment !== void 0) body.environment = score.environment;
+  if (score.timestamp !== void 0) {
+    body.timestamp = score.timestamp instanceof Date ? score.timestamp.toISOString() : score.timestamp;
+  }
+  return body;
+}
+
+// src/tracing.ts
+import { LangfuseSpanProcessor } from "@langfuse/otel";
+import {
+  LangfuseAgent,
+  LangfuseEvent,
+  LangfuseGeneration,
+  LangfuseGuardrail,
+  LangfuseOtelSpanAttributes,
+  LangfuseSpan,
+  LangfuseTool
+} from "@langfuse/tracing";
+import {
+  ROOT_CONTEXT,
+  TraceFlags,
+  trace
+} from "@opentelemetry/api";
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
+import { SEMRESATTRS_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
+
+// src/capture.ts
+var DEFAULT_CAPTURE_MAX_BYTES = 262144;
+var MIN_CAPTURE_MAX_BYTES = 96;
+function validateCaptureMaxBytes(value) {
+  const resolved = value ?? DEFAULT_CAPTURE_MAX_BYTES;
+  if (!Number.isInteger(resolved) || resolved < MIN_CAPTURE_MAX_BYTES) {
+    throw new TypeError(
+      `Langfuse captureMaxBytes must be an integer of at least ${MIN_CAPTURE_MAX_BYTES}`
+    );
+  }
+  return resolved;
+}
+function sanitizeTraceValue(value, maxBytes) {
+  validateCaptureMaxBytes(maxBytes);
+  const sanitized = sanitizeValue(value, 0, /* @__PURE__ */ new WeakSet());
+  let serialized;
+  try {
+    serialized = JSON.stringify(sanitized) ?? String(sanitized);
+  } catch {
+    return omitted("unserializable");
+  }
+  const originalBytes = utf8Bytes(serialized);
+  if (originalBytes <= maxBytes) {
+    return sanitized;
+  }
+  const preview = boundedPreview(serialized, originalBytes, maxBytes);
+  return {
+    anviaTraceValue: "truncated",
+    originalBytes,
+    preview
+  };
+}
+function sanitizeValue(value, depth, seen) {
+  if (depth > 16) {
+    return omitted("depth");
+  }
+  if (typeof value === "string") {
+    if (/^data:[^;,]+;base64,/i.test(value)) {
+      return omitted("base64", utf8Bytes(value));
+    }
+    return value;
+  }
+  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
+    const byteLength = value.byteLength;
+    return omitted("binary", byteLength);
+  }
+  if (value === null || typeof value !== "object") {
+    return value;
+  }
+  if (seen.has(value)) {
+    return omitted("circular");
+  }
+  seen.add(value);
+  if (Array.isArray(value)) {
+    const result2 = value.map((entry) => sanitizeValue(entry, depth + 1, seen));
+    seen.delete(value);
+    return result2;
+  }
+  const record = value;
+  const result = {};
+  for (const [key, entry] of Object.entries(record)) {
+    if (key === "data" && typeof entry === "string" && (record.type === "base64" || record.type === "image" && typeof record.mediaType === "string")) {
+      result[key] = omitted("base64", utf8Bytes(entry));
+      continue;
+    }
+    result[key] = sanitizeValue(entry, depth + 1, seen);
+  }
+  seen.delete(value);
+  return result;
+}
+function omitted(reason, originalBytes) {
+  return {
+    anviaTraceValue: "omitted",
+    reason,
+    ...originalBytes === void 0 ? {} : { originalBytes }
+  };
+}
+function boundedPreview(value, originalBytes, maxBytes) {
+  let low = 0;
+  let high = value.length;
+  while (low < high) {
+    const middle = Math.ceil((low + high) / 2);
+    const candidate = {
+      anviaTraceValue: "truncated",
+      originalBytes,
+      preview: value.slice(0, middle)
+    };
+    if (utf8Bytes(JSON.stringify(candidate)) <= maxBytes) {
+      low = middle;
+    } else {
+      high = middle - 1;
+    }
+  }
+  return value.slice(0, low);
+}
+function utf8Bytes(value) {
+  return typeof Buffer === "undefined" ? new TextEncoder().encode(value).byteLength : Buffer.byteLength(value, "utf8");
+}
+
+// src/helpers.ts
+function modelInputMessage(message) {
+  const { metadata: _metadata, ...result } = message;
+  return result;
+}
+function modelInputMessages(messages) {
+  return messages.map(modelInputMessage);
+}
+function modelParameters(request) {
+  const params = {};
+  if (request.temperature !== void 0) params.temperature = request.temperature;
+  if (request.maxTokens !== void 0) params.maxTokens = request.maxTokens;
+  if (request.toolChoice !== void 0) {
+    params.toolChoice = typeof request.toolChoice === "string" ? request.toolChoice : request.toolChoice.name;
+  }
+  return params;
+}
+function usageDetails(usage) {
+  if (usage.details !== void 0 && Object.keys(usage.details).length > 0) {
+    return { ...usage.details };
+  }
+  return {
+    input: usage.inputTokens,
+    output: usage.outputTokens,
+    total: usage.totalTokens
+  };
+}
+function usageDetailsFromRecord(usage) {
+  if (isRecord(usage.details)) {
+    const details = Object.fromEntries(
+      Object.entries(usage.details).filter(
+        (entry) => typeof entry[1] === "number" && Number.isFinite(entry[1]) && entry[1] >= 0
+      )
+    );
+    if (Object.keys(details).length > 0) {
+      return details;
+    }
+  }
+  return {
+    input: numberValue(usage.inputTokens) ?? 0,
+    output: numberValue(usage.outputTokens) ?? 0,
+    total: numberValue(usage.totalTokens) ?? (numberValue(usage.inputTokens) ?? 0) + (numberValue(usage.outputTokens) ?? 0)
+  };
+}
+function childMetadata(args, agentId, agentName, childTurn) {
+  return {
+    source: "agent_tool_event",
+    childAgentId: agentId,
+    childAgentName: agentName,
+    childTurn,
+    parentToolName: args.toolName,
+    parentInternalCallId: args.internalCallId,
+    parentToolCallId: args.toolCallId
+  };
+}
+function generationKey(agentId, turn) {
+  return `${agentId}:${turn}`;
+}
+function agentLabel(agentId, agentName) {
+  return (agentName ?? agentId).replaceAll(/\s+/g, "_");
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function numberValue(value) {
+  return typeof value === "number" ? value : void 0;
+}
+function emptyToUndefined(value) {
+  return value === void 0 || value.length === 0 ? void 0 : value;
+}
+function errorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+// src/config.ts
+var langfuseResolvedConfigSymbol = /* @__PURE__ */ Symbol.for(
+  "@anvia/langfuse.resolvedConfig"
+);
+function resolveLangfuseConfig(options = {}, fallback) {
+  return {
+    publicKey: resolveStringOption(
+      options.publicKey,
+      fallback?.publicKey,
+      process.env.LANGFUSE_PUBLIC_KEY
+    ),
+    secretKey: resolveStringOption(
+      options.secretKey,
+      fallback?.secretKey,
+      process.env.LANGFUSE_SECRET_KEY
+    ),
+    baseUrl: resolveStringOption(options.baseUrl, fallback?.baseUrl, process.env.LANGFUSE_BASE_URL) ?? "https://cloud.langfuse.com",
+    environment: resolveStringOption(
+      options.environment,
+      fallback?.environment,
+      process.env.LANGFUSE_TRACING_ENVIRONMENT
+    ),
+    release: resolveStringOption(options.release, fallback?.release, process.env.LANGFUSE_RELEASE),
+    serviceName: resolveStringOption(
+      options.serviceName,
+      fallback?.serviceName,
+      process.env.LANGFUSE_SERVICE_NAME
+    ),
+    timeoutMs: options.timeoutMs ?? fallback?.timeoutMs ?? 3e4
+  };
+}
+function getResolvedLangfuseConfig(value) {
+  if (typeof value !== "object" || value === null) {
+    return void 0;
   }
-  return body;
+  return value[langfuseResolvedConfigSymbol];
+}
+function resolveStringOption(option, fallback, envVar) {
+  return emptyToUndefined(option) ?? emptyToUndefined(fallback) ?? emptyToUndefined(envVar);
 }
 
 // src/dataset-client.ts
@@ -377,7 +647,8 @@ function createLangfuseDatasetClient(tracing, options = {}) {
       if (dataset.metadata !== void 0) result.metadata = dataset.metadata;
       return result;
     },
-    async getDataset(name) {
+    async getDataset(options2) {
+      const { name } = options2;
       const items = [];
       let description;
       let metadata;
@@ -417,7 +688,8 @@ function createLangfuseDatasetClient(tracing, options = {}) {
       if (metadata !== void 0) dataset.metadata = metadata;
       return dataset;
     },
-    async upsertItems(name, items) {
+    async upsertItems(options2) {
+      const { name, items } = options2;
       const url = `${baseUrl}/api/public/datasets/${encodeURIComponent(name)}/items`;
       await request(url, {
         method: "POST",
@@ -427,7 +699,7 @@ function createLangfuseDatasetClient(tracing, options = {}) {
     async runExperiment(opts) {
       let items = opts.items;
       if (items === void 0) {
-        const dataset = await this.getDataset(opts.datasetName);
+        const dataset = await this.getDataset({ name: opts.datasetName });
         items = dataset.items;
       }
       if (items === void 0 || items.length === 0) {
@@ -508,7 +780,8 @@ import {
 } from "@anvia/core/evals";
 var DEFAULT_TRUNCATE_BYTES = 2048;
 function createLangfuseEvalReporter(tracing, options = {}) {
-  const onMissingTrace = options.onMissingTrace ?? (options.strict === true ? "throw" : "ignore");
+  const onMissingTrace = options.onMissingTrace ?? "ignore";
+  const traceObserver = options.traceObserver ?? "langfuse";
   const truncateAt = options.truncateInputAt ?? DEFAULT_TRUNCATE_BYTES;
   const includeMessages = options.includeMessages ?? true;
   const includeContext = options.includeContext ?? false;
@@ -517,18 +790,20 @@ function createLangfuseEvalReporter(tracing, options = {}) {
       if (args.outcome.outcome === "invalid" && options.publishInvalid !== true) {
         return;
       }
-      const trace = args.trace ?? resolveEvalTraceRef({
+      const trace2 = args.trace ?? resolveEvalTraceRef({
         output: args.output,
         input: args.case.input,
         metadata: args.case.metadata
       });
-      if (trace?.traceId === void 0 || trace.traceId.length === 0) {
+      if (trace2?.traceId === void 0 || trace2.traceId.length === 0 || trace2.observer !== void 0 && trace2.observer !== traceObserver) {
         if (onMissingTrace === "throw") {
-          throw new Error("Langfuse eval reporter requires traceId");
+          throw new Error(
+            `Langfuse eval reporter requires traceId from observer ${JSON.stringify(traceObserver)}`
+          );
         }
         if (onMissingTrace === "warn") {
           console.warn(
-            "[anvia/langfuse] eval reporter dropped score because no traceId was found",
+            "[anvia/langfuse] eval reporter dropped score because no matching trace was found",
             { caseId: args.case.id, metric: args.metric.name }
           );
         }
@@ -547,11 +822,11 @@ function createLangfuseEvalReporter(tracing, options = {}) {
       });
       const configId = resolveConfigId(args.metric);
       const score = {
-        traceId: trace.traceId,
+        traceId: trace2.traceId,
         name: args.metric.name,
         value: projection.value
       };
-      if (trace.observationId !== void 0) score.observationId = trace.observationId;
+      if (trace2.observationId !== void 0) score.observationId = trace2.observationId;
       if (args.metric.dataType !== void 0) score.dataType = args.metric.dataType;
       if (configId !== void 0) score.configId = configId;
       if (projection.explanation !== void 0) score.comment = projection.explanation;
@@ -649,18 +924,20 @@ function readMessages(output) {
 
 // src/experiment-runner.ts
 import { runEvalSuite } from "@anvia/core/evals";
-async function runEvalAsExperiment(evalOptions, experimentOptions) {
+async function runLangfuseEvalExperiment(client, options) {
+  const evalOptions = options.suite;
+  const experimentOptions = options.experiment;
   const clientOptions = {};
   if (experimentOptions.pageSize !== void 0) clientOptions.pageSize = experimentOptions.pageSize;
   if (experimentOptions.timeoutMs !== void 0)
     clientOptions.timeoutMs = experimentOptions.timeoutMs;
-  const client = experimentOptions.client ?? createLangfuseDatasetClient(experimentOptions.tracing, clientOptions);
+  const datasetClient = client.datasetClient(clientOptions);
   const suiteOptions = experimentOptions.publishScores === true ? {
     ...evalOptions,
     reporters: [
       ...evalOptions.reporters ?? [],
       createLangfuseEvalReporter(
-        experimentOptions.tracing,
+        client,
         experimentOptions.reporterOptions
       )
     ]
@@ -705,30 +982,30 @@ async function runEvalAsExperiment(evalOptions, experimentOptions) {
         };
       }
       const output = result.output ?? void 0;
-      const trace = readTraceFromOutput(result.output);
-      return { output, trace };
+      const trace2 = readTraceFromOutput(result.output);
+      return { output, trace: trace2 };
     }
   };
   if (experimentOptions.description !== void 0) {
     runOptions.description = experimentOptions.description;
   }
   if (experimentOptions.metadata !== void 0) runOptions.metadata = experimentOptions.metadata;
-  const datasetRun = await client.runExperiment(runOptions);
+  const datasetRun = await datasetClient.runExperiment(runOptions);
   return { suite, datasetRun };
 }
 function readTraceFromOutput(output) {
   if (typeof output !== "object" || output === null || !("trace" in output)) {
     return void 0;
   }
-  const trace = output.trace;
-  if (typeof trace !== "object" || trace === null) {
+  const trace2 = output.trace;
+  if (typeof trace2 !== "object" || trace2 === null) {
     return void 0;
   }
-  const traceId = trace.traceId;
+  const traceId = trace2.traceId;
   if (typeof traceId !== "string") {
     return void 0;
   }
-  const observationId = trace.observationId;
+  const observationId = trace2.observationId;
   if (typeof observationId === "string") {
     return { traceId, observationId };
   }
@@ -761,7 +1038,8 @@ function createLangfusePromptClient(tracing, options = {}) {
     }
     return await response.json();
   }
-  async function getPrompt(name, opts = {}) {
+  async function getPrompt(options2) {
+    const { name, ...opts } = options2;
     const key = `${name}::${opts.version ?? ""}::${opts.label ?? ""}`;
     const ttl = opts.cacheTtlMs ?? defaultTtl;
     if (opts.refresh !== true) {
@@ -790,18 +1068,18 @@ function createLangfusePromptClient(tracing, options = {}) {
     cache.set(key, { prompt, expiresAt: Date.now() + ttl });
     return prompt;
   }
-  function getPromptText(name, opts) {
-    return getPrompt(name, opts).then((prompt) => {
+  function getPromptText(options2) {
+    return getPrompt(options2).then((prompt) => {
       if (typeof prompt.prompt !== "string") {
-        throw new Error(`Prompt ${name} is a chat prompt; expected text`);
+        throw new Error(`Prompt ${options2.name} is a chat prompt; expected text`);
       }
       return prompt.prompt;
     });
   }
-  function getPromptChat(name, opts) {
-    return getPrompt(name, opts).then((prompt) => {
+  function getPromptChat(options2) {
+    return getPrompt(options2).then((prompt) => {
       if (typeof prompt.prompt === "string") {
-        throw new Error(`Prompt ${name} is a text prompt; expected chat`);
+        throw new Error(`Prompt ${options2.name} is a text prompt; expected chat`);
       }
       return prompt.prompt;
     });
@@ -809,332 +1087,94 @@ function createLangfusePromptClient(tracing, options = {}) {
   function refresh() {
     cache.clear();
   }
-  return { getPrompt, getPromptText, getPromptChat, refresh };
-}
-function normalizePrompt(raw, type) {
-  if (type === "text") {
-    if (typeof raw === "string") return raw;
-    throw new Error("Expected text prompt to be a string");
-  }
-  if (!Array.isArray(raw)) {
-    throw new Error("Expected chat prompt to be an array of messages");
-  }
-  return raw.map((entry) => {
-    if (typeof entry !== "object" || entry === null) {
-      throw new Error("Expected chat message to be an object");
-    }
-    const role = entry.role;
-    const content = entry.content;
-    if (typeof content !== "string") {
-      throw new Error("Expected chat message content to be a string");
-    }
-    if (role !== "system" && role !== "user" && role !== "assistant" && role !== "tool") {
-      throw new Error(`Unexpected chat message role: ${String(role)}`);
-    }
-    return { role, content };
-  });
-}
-function buildAuthHeader2(publicKey, secretKey) {
-  if (publicKey === void 0 || secretKey === void 0) {
-    return {};
-  }
-  const encoded = Buffer.from(`${publicKey}:${secretKey}`).toString("base64");
-  return { Authorization: `Basic ${encoded}` };
-}
-async function readErrorBody2(response) {
-  try {
-    return await response.text();
-  } catch {
-    return "<unreadable>";
-  }
-}
-
-// src/redaction.ts
-var DEFAULT_REPLACEMENT = "[REDACTED]";
-var MAX_DEPTH = 16;
-function createPiiRedactor(options = {}) {
-  const patterns = options.patterns ?? DEFAULT_PATTERNS;
-  const replacement = options.replacement ?? DEFAULT_REPLACEMENT;
-  const compiled = patterns.map((p) => ({
-    name: p.name,
-    regex: cloneRegex(p.regex, "g")
-  }));
-  const patternNamesList = patterns.map((p) => p.name);
-  function redactString(input) {
-    if (typeof input !== "string") return input;
-    let out = input;
-    for (const { name, regex } of compiled) {
-      out = applyPattern(out, name, regex, replacement);
-    }
-    return out;
-  }
-  function redactObject(input) {
-    return redactValue(input, 0, redactString);
-  }
-  function redactMessages(input) {
-    return input.map((message) => redactMessage(message, redactString));
-  }
-  function patternNames() {
-    return patternNamesList;
-  }
-  return { redactString, redactObject, redactMessages, patternNames };
-}
-var DEFAULT_PATTERNS = [
-  { name: "email", regex: /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g },
-  { name: "creditCard", regex: /\b(?:\d[ -]?){13,19}\b/g },
-  { name: "ipv4", regex: /\b(?:\d{1,3}\.){3}\d{1,3}\b/g },
-  {
-    name: "phone",
-    regex: /(?<!\d)(?:\+\d{1,3}[\s.-]?)?(?:\(\d{2,4}\)[\s.-]?)?\d{3,4}[\s.-]?\d{3,4}(?:[\s.-]?\d{3,4})?(?!\d)/g
-  },
-  { name: "jwt", regex: /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g },
-  {
-    name: "apiKey",
-    regex: /\b(?:sk|pk|api|key|token)[-_][A-Za-z0-9]{16,}\b/gi
-  }
-];
-function applyPattern(input, name, regex, replacement) {
-  if (name === "creditCard") {
-    return redactCreditCards(input, replacement);
-  }
-  return input.replace(regex, replacement);
-}
-function redactCreditCards(input, replacement) {
-  let out = "";
-  let i = 0;
-  while (i < input.length) {
-    const ch = input.charAt(i);
-    if (/\d/.test(ch)) {
-      const { length, valid } = longestLuhnChunk(input.slice(i));
-      if (valid) {
-        out += replacement;
-        i += length;
-        continue;
-      }
-    }
-    out += ch;
-    i += 1;
-  }
-  return out;
-}
-function longestLuhnChunk(s) {
-  let length = 0;
-  let bestValid = 0;
-  while (length < s.length && length < 40) {
-    const ch = s.charAt(length);
-    if (!/\d/.test(ch) && ch !== "-") break;
-    length += 1;
-    const candidate = s.slice(0, length).replace(/\D/g, "");
-    if (candidate.length >= 13 && candidate.length <= 19) {
-      if (startsWithKnownPrefix(candidate) && passesLuhn(candidate)) {
-        bestValid = length;
-      }
-    }
-  }
-  return { length: bestValid, valid: bestValid > 0 };
-}
-function startsWithKnownPrefix(digits) {
-  if (digits.startsWith("4")) return true;
-  const two = digits.slice(0, 2);
-  if (two === "51" || two === "52" || two === "53" || two === "54" || two === "55") return true;
-  const four = digits.slice(0, 4);
-  if (four === "2221" || four === "2720") return true;
-  const twoAgain = digits.slice(0, 2);
-  if (twoAgain === "34" || twoAgain === "37") return true;
-  if (four === "6011" || twoAgain === "65") return true;
-  return digits.startsWith("35");
-}
-function passesLuhn(digits) {
-  if (!/^\d+$/.test(digits)) return false;
-  let sum = 0;
-  let alt = false;
-  for (let i = digits.length - 1; i >= 0; i -= 1) {
-    const raw = digits.charCodeAt(i) - 48;
-    let value = raw;
-    if (alt) {
-      value *= 2;
-      if (value > 9) value -= 9;
-    }
-    sum += value;
-    alt = !alt;
-  }
-  return sum % 10 === 0;
-}
-function cloneRegex(source, flags) {
-  return new RegExp(source.source, flags + source.flags.replace(/g/g, ""));
-}
-function redactValue(value, depth, redactStringFn) {
-  if (depth > MAX_DEPTH) return value;
-  if (typeof value === "string") {
-    return isBase64DataUrl(value) ? value : redactStringFn(value);
-  }
-  if (Array.isArray(value))
-    return value.map((entry) => redactValue(entry, depth + 1, redactStringFn));
-  if (value !== null && typeof value === "object") {
-    if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
-      return value;
-    }
-    const record = value;
-    const out = {};
-    for (const [key, entry] of Object.entries(record)) {
-      if (key === "data" && typeof entry === "string" && (record.type === "base64" || record.type === "image" || record.type === "encrypted" || record.type === "redacted")) {
-        out[key] = entry;
-      } else {
-        out[key] = redactValue(entry, depth + 1, redactStringFn);
-      }
-    }
-    return out;
-  }
-  return value;
+  return { getPrompt, getPromptText, getPromptChat, refresh };
 }
-function redactMessage(message, redactStringFn) {
-  if (message.role === "system") {
-    return { ...message, content: redactStringFn(message.content) };
+function normalizePrompt(raw, type) {
+  if (type === "text") {
+    if (typeof raw === "string") return raw;
+    throw new Error("Expected text prompt to be a string");
   }
-  return {
-    ...message,
-    content: redactMessageContent(message.content, redactStringFn)
-  };
-}
-function redactMessageContent(value, redactStringFn) {
-  return redactValue(value, 0, redactStringFn);
-}
-function isBase64DataUrl(value) {
-  return /^data:[^;,]+;base64,/i.test(value);
+  if (!Array.isArray(raw)) {
+    throw new Error("Expected chat prompt to be an array of messages");
+  }
+  return raw.map((entry) => {
+    if (typeof entry !== "object" || entry === null) {
+      throw new Error("Expected chat message to be an object");
+    }
+    const role = entry.role;
+    const content = entry.content;
+    if (typeof content !== "string") {
+      throw new Error("Expected chat message content to be a string");
+    }
+    if (role !== "system" && role !== "user" && role !== "assistant" && role !== "tool") {
+      throw new Error(`Unexpected chat message role: ${String(role)}`);
+    }
+    return { role, content };
+  });
 }
-
-// src/tracing.ts
-import { LangfuseSpanProcessor } from "@langfuse/otel";
-import {
-  LangfuseOtelSpanAttributes,
-  startObservation
-} from "@langfuse/tracing";
-import { resourceFromAttributes } from "@opentelemetry/resources";
-import { NodeSDK } from "@opentelemetry/sdk-node";
-import { SEMRESATTRS_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
-
-// src/capture.ts
-var DEFAULT_CAPTURE_MAX_BYTES = 262144;
-var MIN_CAPTURE_MAX_BYTES = 96;
-function validateCaptureMaxBytes(value) {
-  const resolved = value ?? DEFAULT_CAPTURE_MAX_BYTES;
-  if (!Number.isInteger(resolved) || resolved < MIN_CAPTURE_MAX_BYTES) {
-    throw new TypeError(
-      `Langfuse captureMaxBytes must be an integer of at least ${MIN_CAPTURE_MAX_BYTES}`
-    );
+function buildAuthHeader2(publicKey, secretKey) {
+  if (publicKey === void 0 || secretKey === void 0) {
+    return {};
   }
-  return resolved;
+  const encoded = Buffer.from(`${publicKey}:${secretKey}`).toString("base64");
+  return { Authorization: `Basic ${encoded}` };
 }
-function sanitizeTraceValue(value, maxBytes) {
-  validateCaptureMaxBytes(maxBytes);
-  const sanitized = sanitizeValue(value, 0, /* @__PURE__ */ new WeakSet());
-  let serialized;
+async function readErrorBody2(response) {
   try {
-    serialized = JSON.stringify(sanitized) ?? String(sanitized);
+    return await response.text();
   } catch {
-    return omitted("unserializable");
-  }
-  const originalBytes = utf8Bytes(serialized);
-  if (originalBytes <= maxBytes) {
-    return sanitized;
+    return "<unreadable>";
   }
-  const preview = boundedPreview(serialized, originalBytes, maxBytes);
-  return {
-    anviaTraceValue: "truncated",
-    originalBytes,
-    preview
-  };
 }
-function sanitizeValue(value, depth, seen) {
-  if (depth > 16) {
-    return omitted("depth");
-  }
-  if (typeof value === "string") {
-    if (/^data:[^;,]+;base64,/i.test(value)) {
-      return omitted("base64", utf8Bytes(value));
-    }
-    return value;
+
+// src/tracing.ts
+var LangfuseObservationFactory = class {
+  constructor(tracer) {
+    this.tracer = tracer;
   }
-  if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
-    const byteLength = value.byteLength;
-    return omitted("binary", byteLength);
+  tracer;
+  agent(name, attributes, parent) {
+    return new LangfuseAgent({ otelSpan: this.startSpan(name, parent), attributes });
   }
-  if (value === null || typeof value !== "object") {
-    return value;
+  span(name, attributes, parent) {
+    return new LangfuseSpan({ otelSpan: this.startSpan(name, parent), attributes });
   }
-  if (seen.has(value)) {
-    return omitted("circular");
+  generation(name, attributes, parent) {
+    return new LangfuseGeneration({ otelSpan: this.startSpan(name, parent), attributes });
   }
-  seen.add(value);
-  if (Array.isArray(value)) {
-    const result2 = value.map((entry) => sanitizeValue(entry, depth + 1, seen));
-    seen.delete(value);
-    return result2;
+  tool(name, attributes, parent) {
+    return new LangfuseTool({ otelSpan: this.startSpan(name, parent), attributes });
   }
-  const record = value;
-  const result = {};
-  for (const [key, entry] of Object.entries(record)) {
-    if (key === "data" && typeof entry === "string" && (record.type === "base64" || record.type === "image" && typeof record.mediaType === "string")) {
-      result[key] = omitted("base64", utf8Bytes(entry));
-      continue;
-    }
-    result[key] = sanitizeValue(entry, depth + 1, seen);
+  guardrail(name, attributes, parent) {
+    return new LangfuseGuardrail({ otelSpan: this.startSpan(name, parent), attributes });
   }
-  seen.delete(value);
-  return result;
-}
-function omitted(reason, originalBytes) {
-  return {
-    anviaTraceValue: "omitted",
-    reason,
-    ...originalBytes === void 0 ? {} : { originalBytes }
-  };
-}
-function boundedPreview(value, originalBytes, maxBytes) {
-  let low = 0;
-  let high = value.length;
-  while (low < high) {
-    const middle = Math.ceil((low + high) / 2);
-    const candidate = {
-      anviaTraceValue: "truncated",
-      originalBytes,
-      preview: value.slice(0, middle)
-    };
-    if (utf8Bytes(JSON.stringify(candidate)) <= maxBytes) {
-      low = middle;
-    } else {
-      high = middle - 1;
-    }
+  event(name, attributes, parent, timestamp) {
+    const endTime = timestamp ?? /* @__PURE__ */ new Date();
+    return new LangfuseEvent({
+      otelSpan: this.startSpan(name, parent, timestamp),
+      attributes,
+      timestamp: endTime
+    });
   }
-  return value.slice(0, low);
-}
-function utf8Bytes(value) {
-  return typeof Buffer === "undefined" ? new TextEncoder().encode(value).byteLength : Buffer.byteLength(value, "utf8");
-}
-
-// src/tracing.ts
-var langfuse = {
-  create(options = {}) {
-    return new LangfuseAgentObserver(options);
+  startSpan(name, parent, startTime) {
+    const parentContext = parent === void 0 ? ROOT_CONTEXT : "otelSpan" in parent ? trace.setSpan(ROOT_CONTEXT, parent.otelSpan) : trace.setSpanContext(ROOT_CONTEXT, parent);
+    return this.tracer.startSpan(name, startTime === void 0 ? {} : { startTime }, parentContext);
   }
 };
-var LangfuseAgentObserver = class {
-  processor;
-  sdk;
+var LangfuseClient = class {
   [langfuseResolvedConfigSymbol];
   publicKey;
   secretKey;
   baseUrl;
   serviceName;
   timeoutMs;
-  queue;
-  currentHandle;
-  redactor;
-  redactInputs;
-  redactOutputs;
-  captureMode;
-  captureMaxBytes;
-  constructor(options) {
+  options;
+  resource;
+  initialization;
+  closePromise;
+  closed = false;
+  constructor(options = {}) {
+    this.options = options;
     const resolvedConfig = resolveLangfuseConfig(options);
     this[langfuseResolvedConfigSymbol] = resolvedConfig;
     this.publicKey = resolvedConfig.publicKey;
@@ -1142,50 +1182,82 @@ var LangfuseAgentObserver = class {
     this.baseUrl = resolvedConfig.baseUrl;
     this.serviceName = resolvedConfig.serviceName;
     this.timeoutMs = resolvedConfig.timeoutMs;
-    const processorOptions = {
-      baseUrl: this.baseUrl
+  }
+  observer(options = {}) {
+    this.assertOpen();
+    return new LangfuseAgentObserver(this, resolveLangfuseCapture(options));
+  }
+  evalReporter(options = {}) {
+    this.assertOpen();
+    const reporter = createLangfuseEvalReporter(this, options);
+    return {
+      report: (args) => {
+        this.assertOpen();
+        return reporter.report(args);
+      }
     };
-    if (this.publicKey !== void 0) processorOptions.publicKey = this.publicKey;
-    if (this.secretKey !== void 0) processorOptions.secretKey = this.secretKey;
-    if (resolvedConfig.environment !== void 0) {
-      processorOptions.environment = resolvedConfig.environment;
-    }
-    if (resolvedConfig.release !== void 0) processorOptions.release = resolvedConfig.release;
-    this.processor = new LangfuseSpanProcessor(processorOptions);
-    const sdkOptions = {
-      spanProcessors: [this.processor]
+  }
+  promptClient(options = {}) {
+    this.assertOpen();
+    const prompts = createLangfusePromptClient(this, options);
+    return {
+      getPrompt: (getOptions) => {
+        this.assertOpen();
+        return prompts.getPrompt(getOptions);
+      },
+      getPromptText: (getOptions) => {
+        this.assertOpen();
+        return prompts.getPromptText(getOptions);
+      },
+      getPromptChat: (getOptions) => {
+        this.assertOpen();
+        return prompts.getPromptChat(getOptions);
+      },
+      refresh: () => {
+        this.assertOpen();
+        prompts.refresh();
+      }
     };
-    if (this.serviceName !== void 0) {
-      sdkOptions.resource = resourceFromAttributes({
-        [SEMRESATTRS_SERVICE_NAME]: this.serviceName
-      });
-    }
-    this.sdk = new NodeSDK(sdkOptions);
-    this.sdk.start();
-    const batchSize = options.scoreBatchSize ?? 0;
-    this.queue = batchSize > 0 && this.publicKey !== void 0 && this.secretKey !== void 0 ? new ScoreQueue({
-      baseUrl: this.baseUrl,
-      publicKey: this.publicKey,
-      secretKey: this.secretKey,
-      timeoutMs: this.timeoutMs,
-      batchSize,
-      flushIntervalMs: options.scoreFlushIntervalMs ?? 250,
-      maxRetries: options.scoreMaxRetries ?? 3
-    }) : null;
-    this.redactInputs = options.redactInputs;
-    this.redactOutputs = options.redactOutputs;
-    this.captureMode = options.captureMode ?? "safe";
-    this.captureMaxBytes = validateCaptureMaxBytes(options.captureMaxBytes);
-    this.redactor = options.redactInputs !== void 0 || options.redactOutputs !== void 0 ? createPiiRedactor(options.redaction) : void 0;
-  }
-  async startRun(args) {
+  }
+  datasetClient(options = {}) {
+    this.assertOpen();
+    const datasets = createLangfuseDatasetClient(this, options);
+    const client = this;
+    return {
+      createDataset(dataset) {
+        client.assertOpen();
+        return datasets.createDataset(dataset);
+      },
+      getDataset(getOptions) {
+        client.assertOpen();
+        return datasets.getDataset(getOptions);
+      },
+      upsertItems(upsertOptions) {
+        client.assertOpen();
+        return datasets.upsertItems(upsertOptions);
+      },
+      runExperiment(experimentOptions) {
+        client.assertOpen();
+        return datasets.runExperiment(experimentOptions);
+      }
+    };
+  }
+  runEvalExperiment(options) {
+    this.assertOpen();
+    return runLangfuseEvalExperiment(this, options);
+  }
+  async startObservedRun(args, capture) {
+    const resource = await this.resources();
     const traceId = args.trace?.traceId;
-    const capturedInput = this.captureInput({
-      instructions: args.instructions,
-      prompt: args.prompt,
-      history: args.history
-    });
-    const capturedTraceMetadata = this.captureInput(args.trace?.metadata ?? {});
+    const capturedInput = captureInput(
+      {
+        instructions: args.instructions,
+        prompt: args.prompt,
+        history: args.history
+      },
+      capture
+    );
+    const capturedTraceMetadata = captureInput(args.trace?.metadata ?? {}, capture);
     const metadata = {
       agentName: args.agentName,
       agentDescription: args.agentDescription,
@@ -1201,69 +1273,41 @@ var LangfuseAgentObserver = class {
       input: capturedInput,
       metadata
     };
-    if (args.trace?.version !== void 0) {
-      rootAttributes.version = args.trace.version;
-    }
-    const root = startObservation(
+    if (args.trace?.version !== void 0) rootAttributes.version = args.trace.version;
+    const root = resource.observations.agent(
       args.agentName ?? "agent.run",
       rootAttributes,
-      traceId === void 0 ? { asType: "agent" } : {
-        asType: "agent",
-        parentSpanContext: {
-          traceId,
-          spanId: "0000000000000001",
-          traceFlags: 1
-        }
+      traceId === void 0 ? void 0 : {
+        traceId,
+        spanId: "0000000000000001",
+        traceFlags: TraceFlags.SAMPLED
       }
     );
     applyTraceAttributes(root, args, capturedTraceMetadata);
-    const promptRef = resolvePromptRef(args);
-    const runObserver = new LangfuseRunObserver(
+    return new LangfuseRunObserver(
       root,
-      {
-        traceId: root.traceId,
-        observationId: root.id
-      },
-      promptRef,
-      {
-        redactor: this.redactor,
-        redactInputs: this.redactInputs,
-        redactOutputs: this.redactOutputs,
-        captureMode: this.captureMode,
-        captureMaxBytes: this.captureMaxBytes
-      }
+      resource.observations,
+      { traceId: root.traceId, observationId: root.id },
+      resolvePromptRef(args),
+      capture
     );
-    this.currentHandle = runObserver.getHandle();
-    runObserver.setCurrentHandle = (handle) => {
-      this.currentHandle = handle;
-    };
-    runObserver.clearCurrentHandle = () => {
-      if (this.currentHandle === runObserver.getHandle()) {
-        this.currentHandle = void 0;
-      }
-    };
-    return runObserver;
   }
   async flush() {
-    await this.queue?.flush();
-    await this.processor.forceFlush();
+    this.assertOpen();
+    const resource = this.resource ?? (this.initialization === void 0 ? void 0 : await this.initialization);
+    if (resource === void 0) return;
+    await resource.queue?.flush();
+    await resource.processor.forceFlush();
   }
-  async shutdown() {
-    await this.queue?.shutdown();
-    await this.sdk.shutdown();
+  close() {
+    this.closePromise ??= this.closeResources();
+    return this.closePromise;
   }
-  async flushScores() {
-    await this.queue?.flush();
+  async [Symbol.asyncDispose]() {
+    await this.close();
   }
   scoreQueueDepth() {
-    return this.queue?.depth() ?? 0;
-  }
-  getCurrentTrace() {
-    return this.currentHandle;
-  }
-  captureInput(value) {
-    const redacted = this.redactor === void 0 || this.redactInputs === void 0 ? value : applyRedaction(this.redactor, value, this.redactInputs);
-    return sanitizeTraceValue(redacted, this.captureMaxBytes);
+    return this.resource?.queue?.depth() ?? 0;
   }
   async score(args) {
     if (args.traceId === void 0 || args.traceId.length === 0) {
@@ -1273,12 +1317,100 @@ var LangfuseAgentObserver = class {
       throw new Error("Langfuse score requires publicKey and secretKey");
     }
     assertScoreValue(args.value, args.dataType);
-    if (this.queue !== null) {
-      this.queue.enqueue(args);
+    const resource = await this.resources();
+    if (resource.queue !== null) {
+      resource.queue.enqueue(args);
       return;
     }
     await this.sendScore(args);
   }
+  resources() {
+    this.assertOpen();
+    if (this.resource !== void 0) return Promise.resolve(this.resource);
+    this.initialization ??= this.createResources().then((resource) => {
+      this.resource = resource;
+      return resource;
+    }).catch((error) => {
+      this.initialization = void 0;
+      throw error;
+    });
+    return this.initialization;
+  }
+  async createResources() {
+    const resolvedConfig = this[langfuseResolvedConfigSymbol];
+    const processorOptions = {
+      baseUrl: this.baseUrl
+    };
+    if (this.publicKey !== void 0) processorOptions.publicKey = this.publicKey;
+    if (this.secretKey !== void 0) processorOptions.secretKey = this.secretKey;
+    if (resolvedConfig.environment !== void 0) {
+      processorOptions.environment = resolvedConfig.environment;
+    }
+    if (resolvedConfig.release !== void 0) processorOptions.release = resolvedConfig.release;
+    const processor = new LangfuseSpanProcessor(processorOptions);
+    const providerOptions = {
+      spanProcessors: [processor]
+    };
+    if (this.serviceName !== void 0) {
+      providerOptions.resource = resourceFromAttributes({
+        [SEMRESATTRS_SERVICE_NAME]: this.serviceName
+      });
+    }
+    let provider;
+    try {
+      provider = new NodeTracerProvider(providerOptions);
+    } catch (error) {
+      await processor.shutdown().catch(() => void 0);
+      throw error;
+    }
+    try {
+      const batchSize = this.options.scores?.batchSize ?? 0;
+      const queue = batchSize > 0 && this.publicKey !== void 0 && this.secretKey !== void 0 ? new ScoreQueue({
+        baseUrl: this.baseUrl,
+        publicKey: this.publicKey,
+        secretKey: this.secretKey,
+        timeoutMs: this.timeoutMs,
+        batchSize,
+        flushIntervalMs: this.options.scores?.flushIntervalMs ?? 250,
+        maxAttempts: scoreMaxAttempts(this.options.scores?.retries)
+      }) : null;
+      return {
+        processor,
+        provider,
+        observations: new LangfuseObservationFactory(
+          provider.getTracer("@anvia/langfuse", "1.0.0")
+        ),
+        queue
+      };
+    } catch (error) {
+      await provider.shutdown().catch(() => void 0);
+      throw error;
+    }
+  }
+  async closeResources() {
+    this.closed = true;
+    const pending = this.resource === void 0 ? this.initialization : Promise.resolve(this.resource);
+    if (pending === void 0) return;
+    let resource;
+    try {
+      resource = await pending;
+    } catch {
+      return;
+    }
+    const settled = await Promise.allSettled([
+      resource.queue?.shutdown() ?? Promise.resolve(),
+      resource.provider.shutdown()
+    ]);
+    const failures = settled.flatMap(
+      (result) => result.status === "rejected" ? [result.reason] : []
+    );
+    if (failures.length > 0) {
+      throw new AggregateError(failures, "Failed to close LangfuseClient.");
+    }
+  }
+  assertOpen() {
+    if (this.closed) throw new Error("LangfuseClient is closed.");
+  }
   async sendScore(args) {
     const body = buildScoreBody2(args);
     const response = await fetch(`${this.baseUrl}/api/public/scores`, {
@@ -1297,6 +1429,37 @@ var LangfuseAgentObserver = class {
     }
   }
 };
+var LangfuseAgentObserver = class {
+  constructor(client, capture) {
+    this.client = client;
+    this.capture = capture;
+  }
+  client;
+  capture;
+  startRun(args) {
+    return this.client.startObservedRun(args, this.capture);
+  }
+};
+function resolveLangfuseCapture(options) {
+  return {
+    redactor: options.redactInputs !== void 0 || options.redactOutputs !== void 0 ? createPiiRedactor(options.redaction) : void 0,
+    redactInputs: options.redactInputs,
+    redactOutputs: options.redactOutputs,
+    captureMode: options.captureMode ?? "safe",
+    captureMaxBytes: validateCaptureMaxBytes(options.captureMaxBytes)
+  };
+}
+function captureInput(value, capture) {
+  const redacted = capture.redactor === void 0 || capture.redactInputs === void 0 ? value : applyRedaction(capture.redactor, value, capture.redactInputs);
+  return sanitizeTraceValue(redacted, capture.captureMaxBytes);
+}
+function scoreMaxAttempts(retries) {
+  if (retries === void 0) return 3;
+  if (!Number.isSafeInteger(retries.maxAttempts) || retries.maxAttempts < 1) {
+    throw new TypeError("Langfuse score retries.maxAttempts must be a positive integer.");
+  }
+  return retries.maxAttempts;
+}
 function assertScoreValue(value, dataType) {
   if (dataType === "NUMERIC") {
     if (typeof value !== "number") {
@@ -1436,20 +1599,15 @@ function asMetadata(value) {
   return isRecord(value) ? value : { value };
 }
 function eventStartTime(value) {
-  if (value instanceof Date) {
-    return Number.isNaN(value.getTime()) ? void 0 : value;
-  }
-  if (typeof value !== "string") {
-    return void 0;
-  }
+  if (value === void 0) return void 0;
   const parsed = new Date(value);
   return Number.isNaN(parsed.getTime()) ? void 0 : parsed;
 }
 var LangfuseRunObserver = class {
-  constructor(root, trace, promptRef, redaction) {
+  constructor(root, observations, trace2, promptRef, redaction) {
     this.root = root;
-    this.trace = trace;
-    this.handle = this.buildHandle();
+    this.observations = observations;
+    this.trace = trace2;
     this.promptRef = promptRef;
     this.redactor = redaction.redactor;
     this.redactInputs = redaction.redactInputs;
@@ -1458,13 +1616,9 @@ var LangfuseRunObserver = class {
     this.captureMaxBytes = redaction.captureMaxBytes;
   }
   root;
+  observations;
   trace;
   turnSpans = /* @__PURE__ */ new Map();
-  // Assigned by LangfuseAgentObserver.startRun so that the run can
-  // publish trace-handle updates back to the agent observer.
-  setCurrentHandle;
-  clearCurrentHandle;
-  handle;
   promptRef;
   redactor;
   redactInputs;
@@ -1491,7 +1645,7 @@ var LangfuseRunObserver = class {
       safeInput.tools = args.request.tools;
       safeInput.providerTools = args.request.providerTools;
       safeInput.outputSchema = args.request.outputSchema;
-      safeInput.additionalParams = args.request.additionalParams;
+      safeInput.providerOptions = args.request.providerOptions;
     }
     const metadata = {
       turn: args.turn,
@@ -1499,7 +1653,7 @@ var LangfuseRunObserver = class {
       toolNames: args.request.tools.map((tool) => tool.name),
       providerToolNames: args.request.providerTools?.map((tool) => tool.name) ?? [],
       hasOutputSchema: args.request.outputSchema !== void 0,
-      additionalParamKeys: isRecord(args.request.additionalParams) ? Object.keys(args.request.additionalParams) : []
+      providerOptionKeys: isRecord(args.request.providerOptions) ? Object.keys(args.request.providerOptions) : []
     };
     if (this.captureMode === "full" && args.providerRequest !== void 0) {
       metadata.providerRequest = args.providerRequest;
@@ -1507,7 +1661,7 @@ var LangfuseRunObserver = class {
     if (args.modelInfo !== void 0) {
       const modelInfo = {
         provider: args.modelInfo.provider,
-        defaultModel: args.modelInfo.defaultModel
+        modelId: args.modelInfo.modelId
       };
       if (args.modelInfo.capabilities !== void 0) {
         modelInfo.capabilities = args.modelInfo.capabilities;
@@ -1517,7 +1671,7 @@ var LangfuseRunObserver = class {
     Object.assign(metadata, promptMetadata(this.promptRef));
     const generationAttributes = {
       input: this.redactInputValue(safeInput),
-      model: args.request.model ?? args.modelInfo?.defaultModel ?? "default",
+      model: args.modelInfo?.modelId ?? "unknown",
       modelParameters: modelParameters(args.request),
       metadata: asMetadata(this.redactInputValue(metadata))
     };
@@ -1528,9 +1682,11 @@ var LangfuseRunObserver = class {
         isFallback: false
       };
     }
-    const generation = turn.startObservation(`model.turn.${args.turn}`, generationAttributes, {
-      asType: "generation"
-    });
+    const generation = this.observations.generation(
+      `model.turn.${args.turn}`,
+      generationAttributes,
+      turn
+    );
     return new LangfuseGenerationObserver(generation, this, /* @__PURE__ */ new Date());
   }
   startTool(args) {
@@ -1544,7 +1700,7 @@ var LangfuseRunObserver = class {
       if (args.toolDefinition !== void 0) metadata.toolDefinition = args.toolDefinition;
       if (args.toolMetadata !== void 0) metadata.toolMetadata = args.toolMetadata;
     }
-    const tool = turn.startObservation(
+    const tool = this.observations.tool(
       `tool.${args.toolName}`,
       {
         input: this.redactInputValue({
@@ -1553,14 +1709,16 @@ var LangfuseRunObserver = class {
         }),
         metadata: asMetadata(this.redactInputValue(metadata))
       },
-      { asType: "tool" }
+      turn
     );
-    return new LangfuseToolObserver(tool, this);
+    return new LangfuseToolObserver(tool, this, this.observations);
   }
   end(args) {
     this.closeAllTurns();
-    const redactedOutput = this.redactOutputValue(args.output);
+    const observedOutput = args.status === "completed" ? { status: args.status, output: args.output, text: args.text } : { status: args.status, stage: args.stage, text: args.text };
+    const redactedOutput = this.redactOutputValue(observedOutput);
     const metadata = {
+      status: args.status,
       usage: args.usage,
       messageCount: args.messages.length,
       sources: this.redactOutputValue(args.sources),
@@ -1573,7 +1731,6 @@ var LangfuseRunObserver = class {
       output: redactedOutput,
       metadata
     }).end();
-    this.clearCurrentHandle?.();
   }
   error(args) {
     this.closeAllTurns();
@@ -1593,7 +1750,6 @@ var LangfuseRunObserver = class {
       },
       metadata
     }).end();
-    this.clearCurrentHandle?.();
   }
   event(args) {
     const metadata = asMetadata(this.redactOutputValue(args.attributes ?? {}));
@@ -1602,43 +1758,19 @@ var LangfuseRunObserver = class {
       attributes.level = args.level;
     }
     const startTime = eventStartTime(args.timestamp);
-    this.root.startObservation(args.name, attributes, {
-      asType: "event",
-      ...startTime === void 0 ? {} : { startTime }
-    });
-  }
-  getHandle() {
-    return this.handle;
-  }
-  buildHandle() {
-    return {
-      traceId: this.trace.traceId ?? "",
-      observationId: this.trace.observationId ?? "",
-      addAttributes: (attributes) => {
-        this.root.update({ metadata: asMetadata(this.redactOutputValue(attributes)) });
-        this.setCurrentHandle?.(this.handle);
-      },
-      addEvent: (name, attributes) => {
-        this.root.startObservation(
-          name,
-          { metadata: asMetadata(this.redactOutputValue(attributes ?? {})) },
-          { asType: "event" }
-        );
-        this.setCurrentHandle?.(this.handle);
-      }
-    };
+    this.observations.event(args.name, attributes, this.root, startTime);
   }
   turnSpan(turn) {
     const existing = this.turnSpans.get(turn);
     if (existing !== void 0) {
       return existing;
     }
-    const span = this.root.startObservation(
+    const span = this.observations.span(
       `turn.${turn}`,
       {
         metadata: { turn }
       },
-      { asType: "span" }
+      this.root
     );
     this.turnSpans.set(turn, span);
     return span;
@@ -1719,12 +1851,14 @@ function textFromObservedAssistantContent(content) {
   return content.flatMap((item) => item.type === "text" ? [item.text] : []).join("\n");
 }
 var LangfuseToolObserver = class {
-  constructor(tool, run) {
+  constructor(tool, run, observations) {
     this.tool = tool;
     this.run = run;
+    this.observations = observations;
   }
   tool;
   run;
+  observations;
   childAgents = /* @__PURE__ */ new Map();
   childGenerations = /* @__PURE__ */ new Map();
   childTools = [];
@@ -1741,7 +1875,7 @@ var LangfuseToolObserver = class {
     if (child.type === "turn_start") {
       const promptMessage = isRecord(child.prompt) ? child.prompt : void 0;
       const historyMessages = Array.isArray(child.history) ? child.history.filter(isRecord) : [];
-      agent.startObservation(
+      this.observations.event(
         `${agentLabel(agentId, agentName)}.turn.${childTurn}.start`,
         {
           input: this.run.redactInputValue({
@@ -1752,7 +1886,7 @@ var LangfuseToolObserver = class {
             this.run.redactInputValue(childMetadata(args, agentId, agentName, childTurn))
           )
         },
-        { asType: "event" }
+        agent
       );
       return;
     }
@@ -1769,15 +1903,15 @@ var LangfuseToolObserver = class {
         input.tools = request.tools;
         input.providerTools = request.providerTools;
         input.outputSchema = request.outputSchema;
-        input.additionalParams = request.additionalParams;
+        input.providerOptions = request.providerOptions;
       }
       const toolNames = Array.isArray(request.tools) ? request.tools.filter(isRecord).map((tool) => tool.name).filter((name) => typeof name === "string") : [];
       const providerToolNames = Array.isArray(request.providerTools) ? request.providerTools.filter(isRecord).map((tool) => tool.name).filter((name) => typeof name === "string") : [];
-      const generation = agent.startObservation(
+      const generation = this.observations.generation(
         `${agentLabel(agentId, agentName)}.model.turn.${childTurn}`,
         {
           input: this.run.redactInputValue(input),
-          model: typeof request.model === "string" ? request.model : typeof modelInfo?.defaultModel === "string" ? modelInfo.defaultModel : "default",
+          model: typeof modelInfo?.modelId === "string" ? modelInfo.modelId : "unknown",
           modelParameters: modelParameters(request),
           metadata: asMetadata(
             this.run.redactInputValue({
@@ -1790,7 +1924,7 @@ var LangfuseToolObserver = class {
             })
           )
         },
-        { asType: "generation" }
+        agent
       );
       this.childGenerations.set(generationKey(agentId, childTurn), {
         generation,
@@ -1830,7 +1964,7 @@ var LangfuseToolObserver = class {
     if (child.type === "source" || child.type === "provider_tool_call") {
       const childGeneration = this.childGenerations.get(generationKey(agentId, childTurn));
       const parent = childGeneration?.generation ?? agent;
-      parent.startObservation(
+      this.observations.event(
         `${agentLabel(agentId, agentName)}.${child.type}`,
         {
           output: this.run.redactOutputValue(
@@ -1840,12 +1974,12 @@ var LangfuseToolObserver = class {
             this.run.redactOutputValue(childMetadata(args, agentId, agentName, childTurn))
           )
         },
-        { asType: "event" }
+        parent
       );
       return;
     }
     if (child.type === "guardrail_decision") {
-      agent.startObservation(
+      this.observations.guardrail(
         `${agentLabel(agentId, agentName)}.guardrail`,
         {
           output: this.run.redactOutputValue(child.decision),
@@ -1853,7 +1987,7 @@ var LangfuseToolObserver = class {
             this.run.redactOutputValue(childMetadata(args, agentId, agentName, childTurn))
           )
         },
-        { asType: "guardrail" }
+        agent
       ).end();
       return;
     }
@@ -1863,14 +1997,13 @@ var LangfuseToolObserver = class {
         output: this.run.redactOutputValue({ toolCall: child.toolCall })
       });
       const toolCall = child.toolCall;
-      const toolCallFunction = isRecord(toolCall.function) ? toolCall.function : void 0;
-      const toolName = typeof toolCallFunction?.name === "string" ? toolCallFunction.name : "tool";
-      const toolCallId = typeof toolCall.callId === "string" ? toolCall.callId : typeof toolCall.id === "string" ? toolCall.id : void 0;
-      const childTool = agent.startObservation(
+      const toolName = typeof toolCall.toolName === "string" ? toolCall.toolName : "tool";
+      const toolCallId = typeof toolCall.toolCallId === "string" ? toolCall.toolCallId : typeof toolCall.callId === "string" ? toolCall.callId : void 0;
+      const childTool = this.observations.tool(
         `${agentLabel(agentId, agentName)}.${toolName}`,
         {
           input: this.run.redactInputValue({
-            args: toolCallFunction?.arguments ?? {},
+            args: toolCall.input,
             toolCall
           }),
           metadata: asMetadata(
@@ -1881,7 +2014,7 @@ var LangfuseToolObserver = class {
             })
           )
         },
-        { asType: "tool" }
+        agent
       );
       const childToolRecord = {
         agentId,
@@ -1917,13 +2050,18 @@ var LangfuseToolObserver = class {
       return;
     }
     if (child.type === "final") {
+      const result = isRecord(child.result) ? child.result : {};
       const update = {
-        output: this.run.redactOutputValue(child.output)
+        output: this.run.redactOutputValue({
+          status: result.status,
+          output: result.output,
+          text: result.text
+        })
       };
       const metadata = {};
-      if (isRecord(child.usage)) metadata.usage = child.usage;
-      if (this.run.isFullCapture() && Array.isArray(child.messages)) {
-        metadata.messages = this.run.redactTranscript(child.messages);
+      if (isRecord(result.usage)) metadata.usage = result.usage;
+      if (this.run.isFullCapture() && Array.isArray(result.messages)) {
+        metadata.messages = this.run.redactTranscript(result.messages);
       }
       if (Object.keys(metadata).length > 0) update.metadata = metadata;
       agent.update(update).end();
@@ -1989,14 +2127,14 @@ var LangfuseToolObserver = class {
     if (existing !== void 0) {
       return existing;
     }
-    const agent = this.tool.startObservation(
+    const agent = this.observations.agent(
       `${agentLabel(agentId, agentName)}.run`,
       {
         metadata: asMetadata(
           this.run.redactInputValue(childMetadata(args, agentId, agentName, args.turn))
         )
       },
-      { asType: "agent" }
+      this.tool
     );
     this.childAgents.set(agentId, agent);
     return agent;
@@ -2032,12 +2170,8 @@ var LangfuseToolObserver = class {
 };
 export {
   DEFAULT_PATTERNS,
+  LangfuseClient,
   LangfuseScoreError,
-  createLangfuseDatasetClient,
-  createLangfuseEvalReporter,
-  createLangfusePromptClient,
-  createPiiRedactor,
-  langfuse,
-  runEvalAsExperiment
+  createPiiRedactor
 };
 //# sourceMappingURL=index.js.map