@librechat/agents 3.3.7 → 3.3.9

package/dist/cjs/langfuseRuntimeScope.cjs

@@ -5,6 +5,8 @@ let _opentelemetry_api = require("@opentelemetry/api");
 const langfuseToolOutputTracingConfigKey = (0, _opentelemetry_api.createContextKey)("librechat.langfuse.tool-output-tracing");
 const langfuseConfigKey = (0, _opentelemetry_api.createContextKey)("librechat.langfuse.config");
 const langfuseTraceIdSeedKey = (0, _opentelemetry_api.createContextKey)("librechat.langfuse.trace-id-seed");
+const langfuseScopeRunIdKey = (0, _opentelemetry_api.createContextKey)("librechat.langfuse.run-id");
+const langfuseScopeAgentIdKey = (0, _opentelemetry_api.createContextKey)("librechat.langfuse.agent-id");
 function isRecord(value) {
 	return value != null && typeof value === "object" && !Array.isArray(value);
 }
@@ -29,27 +31,56 @@ function resolveLangfuseConfigForSpan(activeContext) {
 function resolveTraceIdSeedForSpan(activeContext) {
 	return require_langfuseRuntimeContext.getTraceIdSeed() ?? getOtelTraceIdSeed(activeContext);
 }
+function getOtelScopeRunId(activeContext) {
+	const value = activeContext.getValue(langfuseScopeRunIdKey);
+	return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+function getOtelScopeAgentId(activeContext) {
+	const value = activeContext.getValue(langfuseScopeAgentIdKey);
+	return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+/** The run identity the active scope belongs to (see
+*  `LangfuseRuntimeContext.runId`), or `undefined` for unstamped scopes. */
+function resolveLangfuseScopeRunId(activeContext) {
+	return require_langfuseRuntimeContext.getLangfuseScopeRunId() ?? getOtelScopeRunId(activeContext);
+}
+/** The agent identity of a per-agent overlay scope (see
+*  `LangfuseRuntimeContext.agentId`), or `undefined` for run-level scopes. */
+function resolveLangfuseScopeAgentId(activeContext) {
+	return require_langfuseRuntimeContext.getLangfuseScopeAgentId() ?? getOtelScopeAgentId(activeContext);
+}
 function resolveToolOutputTracingConfigForSpan(activeContext) {
 	return require_langfuseRuntimeContext.getLangfuseRuntimeToolOutputTracingConfig() ?? getOtelToolOutputTracingConfig(activeContext);
 }
-function withLangfuseRuntimeScope(scope, action) {
-	if (!require_langfuseRuntimeContext.hasLangfuseRuntimeContextValue(scope)) return action();
+function setOrClearContextValue(activeContext, key, value, replace) {
+	if (value != null) return activeContext.setValue(key, value);
+	return replace ? activeContext.deleteValue(key) : activeContext;
+}
+function withLangfuseRuntimeScope(scope, action, options) {
+	const replace = options?.replace === true;
+	if (!replace && !require_langfuseRuntimeContext.hasLangfuseRuntimeContextValue(scope)) return action();
 	let activeContext = _opentelemetry_api.context.active();
-	if (scope.langfuse != null) activeContext = activeContext.setValue(langfuseConfigKey, scope.langfuse);
-	if (scope.toolOutputTracing != null) activeContext = activeContext.setValue(langfuseToolOutputTracingConfigKey, scope.toolOutputTracing);
-	if (hasText(scope.traceIdSeed)) activeContext = activeContext.setValue(langfuseTraceIdSeedKey, scope.traceIdSeed);
-	return require_langfuseRuntimeContext.runWithLangfuseRuntimeContext(scope, () => _opentelemetry_api.context.with(activeContext, action));
+	activeContext = setOrClearContextValue(activeContext, langfuseConfigKey, scope.langfuse, replace);
+	activeContext = setOrClearContextValue(activeContext, langfuseToolOutputTracingConfigKey, scope.toolOutputTracing, replace);
+	activeContext = setOrClearContextValue(activeContext, langfuseTraceIdSeedKey, hasText(scope.traceIdSeed) ? scope.traceIdSeed : void 0, replace);
+	activeContext = setOrClearContextValue(activeContext, langfuseScopeRunIdKey, hasText(scope.runId) ? scope.runId : void 0, replace);
+	activeContext = setOrClearContextValue(activeContext, langfuseScopeAgentIdKey, hasText(scope.agentId) ? scope.agentId : void 0, replace);
+	return (replace ? require_langfuseRuntimeContext.replaceLangfuseRuntimeContext : require_langfuseRuntimeContext.runWithLangfuseRuntimeContext)(scope, () => _opentelemetry_api.context.with(activeContext, action));
 }
-function resolveLangfuseRuntimeScope({ runLangfuse, langfuseOverlay, traceIdSeed }) {
+function resolveLangfuseRuntimeScope({ runLangfuse, langfuseOverlay, traceIdSeed, runId, agentId }) {
 	return {
 		langfuse: require_langfuseConfig.resolveLangfuseConfig(runLangfuse, langfuseOverlay),
 		traceIdSeed,
-		toolOutputTracing: !require_langfuseConfig.hasToolOutputTracingConfig(runLangfuse, langfuseOverlay) ? void 0 : require_langfuseConfig.resolveToolOutputTracingConfig(runLangfuse, langfuseOverlay)
+		toolOutputTracing: !require_langfuseConfig.hasToolOutputTracingConfig(runLangfuse, langfuseOverlay) ? void 0 : require_langfuseConfig.resolveToolOutputTracingConfig(runLangfuse, langfuseOverlay),
+		runId,
+		agentId
 	};
 }
 //#endregion
 exports.resolveLangfuseConfigForSpan = resolveLangfuseConfigForSpan;
 exports.resolveLangfuseRuntimeScope = resolveLangfuseRuntimeScope;
+exports.resolveLangfuseScopeAgentId = resolveLangfuseScopeAgentId;
+exports.resolveLangfuseScopeRunId = resolveLangfuseScopeRunId;
 exports.resolveToolOutputTracingConfigForSpan = resolveToolOutputTracingConfigForSpan;
 exports.resolveTraceIdSeedForSpan = resolveTraceIdSeedForSpan;
 exports.withLangfuseRuntimeScope = withLangfuseRuntimeScope;

package/dist/cjs/langfuseRuntimeScope.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"langfuseRuntimeScope.cjs","names":["getLangfuseRuntimeConfig","getTraceIdSeed","getLangfuseRuntimeToolOutputTracingConfig","hasLangfuseRuntimeContextValue","context","runWithLangfuseRuntimeContext","resolveLangfuseConfig","hasToolOutputTracingConfig","resolveToolOutputTracingConfig"],"sources":["../../src/langfuseRuntimeScope.ts"],"sourcesContent":["import { context, createContextKey } from '@opentelemetry/api';\nimport type { Context } from '@opentelemetry/api';\nimport type {\n  LangfuseRuntimeContext,\n  ResolvedLangfuseToolOutputTracingConfig,\n} from '@/langfuseRuntimeContext';\nimport type * as t from '@/types';\nimport {\n  getLangfuseRuntimeConfig,\n  getLangfuseRuntimeToolOutputTracingConfig,\n  getTraceIdSeed,\n  hasLangfuseRuntimeContextValue,\n  runWithLangfuseRuntimeContext,\n} from '@/langfuseRuntimeContext';\nimport {\n  hasToolOutputTracingConfig,\n  resolveLangfuseConfig,\n  resolveToolOutputTracingConfig,\n} from '@/langfuseConfig';\n\nexport type LangfuseRuntimeScope = LangfuseRuntimeContext;\n\nexport type ResolveLangfuseRuntimeScopeParams = {\n  runLangfuse?: t.LangfuseConfig;\n  langfuseOverlay?: t.LangfuseConfig;\n  traceIdSeed?: string;\n};\n\nconst langfuseToolOutputTracingConfigKey = createContextKey(\n  'librechat.langfuse.tool-output-tracing'\n);\nconst langfuseConfigKey = createContextKey('librechat.langfuse.config');\nconst langfuseTraceIdSeedKey = createContextKey(\n  'librechat.langfuse.trace-id-seed'\n);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction hasText(value: string | undefined): value is string {\n  return value != null && value.trim() !== '';\n}\n\nexport function getOtelLangfuseConfig(\n  activeContext: Context\n): t.LangfuseConfig | undefined {\n  const value = activeContext.getValue(langfuseConfigKey);\n  return isRecord(value) ? (value as t.LangfuseConfig) : undefined;\n}\n\nexport function getOtelTraceIdSeed(activeContext: Context): string | undefined {\n  const value = activeContext.getValue(langfuseTraceIdSeedKey);\n  return typeof value === 'string' && value.trim() !== '' ? value : undefined;\n}\n\nexport function getOtelToolOutputTracingConfig(\n  activeContext: Context\n): ResolvedLangfuseToolOutputTracingConfig | undefined {\n  const value = activeContext.getValue(langfuseToolOutputTracingConfigKey);\n  return isRecord(value)\n    ? (value as ResolvedLangfuseToolOutputTracingConfig)\n    : undefined;\n}\n\nexport function resolveLangfuseConfigForSpan(\n  activeContext: Context\n): t.LangfuseConfig | undefined {\n  return getLangfuseRuntimeConfig() ?? getOtelLangfuseConfig(activeContext);\n}\n\nexport function resolveTraceIdSeedForSpan(\n  activeContext: Context\n): string | undefined {\n  return getTraceIdSeed() ?? getOtelTraceIdSeed(activeContext);\n}\n\nexport function resolveToolOutputTracingConfigForSpan(\n  activeContext: Context\n): ResolvedLangfuseToolOutputTracingConfig | undefined {\n  return (\n    getLangfuseRuntimeToolOutputTracingConfig() ??\n    getOtelToolOutputTracingConfig(activeContext)\n  );\n}\n\nexport function withLangfuseRuntimeScope<T>(\n  scope: LangfuseRuntimeScope,\n  action: () => T\n): T {\n  if (!hasLangfuseRuntimeContextValue(scope)) {\n    return action();\n  }\n\n  let activeContext = context.active();\n  if (scope.langfuse != null) {\n    activeContext = activeContext.setValue(langfuseConfigKey, scope.langfuse);\n  }\n  if (scope.toolOutputTracing != null) {\n    activeContext = activeContext.setValue(\n      langfuseToolOutputTracingConfigKey,\n      scope.toolOutputTracing\n    );\n  }\n  if (hasText(scope.traceIdSeed)) {\n    activeContext = activeContext.setValue(\n      langfuseTraceIdSeedKey,\n      scope.traceIdSeed\n    );\n  }\n\n  // Span processors receive the OTel parent context in `onStart`, while\n  // LangChain callback handlers may run outside that context and need ALS.\n  // The trace id generator reads the seed from ALS or OTel context so SDK\n  // callbacks that preserve only one of those contexts still keep trace/score\n  // cohesion.\n  return runWithLangfuseRuntimeContext(scope, () =>\n    context.with(activeContext, action)\n  );\n}\n\nexport function resolveLangfuseRuntimeScope({\n  runLangfuse,\n  langfuseOverlay,\n  traceIdSeed,\n}: ResolveLangfuseRuntimeScopeParams): LangfuseRuntimeScope {\n  const langfuse = resolveLangfuseConfig(runLangfuse, langfuseOverlay);\n  const toolOutputTracing = !hasToolOutputTracingConfig(\n    runLangfuse,\n    langfuseOverlay\n  )\n    ? undefined\n    : resolveToolOutputTracingConfig(runLangfuse, langfuseOverlay);\n  return { langfuse, traceIdSeed, toolOutputTracing };\n}\n"],"mappings":";;;;AA4BA,MAAM,sCAAA,GAAA,mBAAA,iBAAA,CACJ,wCACF;AACA,MAAM,qBAAA,GAAA,mBAAA,iBAAA,CAAqC,2BAA2B;AACtE,MAAM,0BAAA,GAAA,mBAAA,iBAAA,CACJ,kCACF;AAEA,SAAS,SAAS,OAAkD;CAClE,OAAO,SAAS,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC3E;AAEA,SAAS,QAAQ,OAA4C;CAC3D,OAAO,SAAS,QAAQ,MAAM,KAAK,MAAM;AAC3C;AAEA,SAAgB,sBACd,eAC8B;CAC9B,MAAM,QAAQ,cAAc,SAAS,iBAAiB;CACtD,OAAO,SAAS,KAAK,IAAK,QAA6B,KAAA;AACzD;AAEA,SAAgB,mBAAmB,eAA4C;CAC7E,MAAM,QAAQ,cAAc,SAAS,sBAAsB;CAC3D,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,KAAK,QAAQ,KAAA;AACpE;AAEA,SAAgB,+BACd,eACqD;CACrD,MAAM,QAAQ,cAAc,SAAS,kCAAkC;CACvE,OAAO,SAAS,KAAK,IAChB,QACD,KAAA;AACN;AAEA,SAAgB,6BACd,eAC8B;CAC9B,OAAOA,+BAAAA,yBAAyB,KAAK,sBAAsB,aAAa;AAC1E;AAEA,SAAgB,0BACd,eACoB;CACpB,OAAOC,+BAAAA,eAAe,KAAK,mBAAmB,aAAa;AAC7D;AAEA,SAAgB,sCACd,eACqD;CACrD,OACEC,+BAAAA,0CAA0C,KAC1C,+BAA+B,aAAa;AAEhD;AAEA,SAAgB,yBACd,OACA,QACG;CACH,IAAI,CAACC,+BAAAA,+BAA+B,KAAK,GACvC,OAAO,OAAO;CAGhB,IAAI,gBAAgBC,mBAAAA,QAAQ,OAAO;CACnC,IAAI,MAAM,YAAY,MACpB,gBAAgB,cAAc,SAAS,mBAAmB,MAAM,QAAQ;CAE1E,IAAI,MAAM,qBAAqB,MAC7B,gBAAgB,cAAc,SAC5B,oCACA,MAAM,iBACR;CAEF,IAAI,QAAQ,MAAM,WAAW,GAC3B,gBAAgB,cAAc,SAC5B,wBACA,MAAM,WACR;CAQF,OAAOC,+BAAAA,8BAA8B,aACnCD,mBAAAA,QAAQ,KAAK,eAAe,MAAM,CACpC;AACF;AAEA,SAAgB,4BAA4B,EAC1C,aACA,iBACA,eAC0D;CAQ1D,OAAO;EAAE,UAPQE,uBAAAA,sBAAsB,aAAa,eAOpC;EAAG;EAAa,mBANN,CAACC,uBAAAA,2BACzB,aACA,eACF,IACI,KAAA,IACAC,uBAAAA,+BAA+B,aAAa,eAAe;CACb;AACpD"}
+{"version":3,"file":"langfuseRuntimeScope.cjs","names":["getLangfuseRuntimeConfig","getTraceIdSeed","getLangfuseScopeRunId","getLangfuseScopeAgentId","getLangfuseRuntimeToolOutputTracingConfig","hasLangfuseRuntimeContextValue","context","replaceLangfuseRuntimeContext","runWithLangfuseRuntimeContext","resolveLangfuseConfig","hasToolOutputTracingConfig","resolveToolOutputTracingConfig"],"sources":["../../src/langfuseRuntimeScope.ts"],"sourcesContent":["import { context, createContextKey } from '@opentelemetry/api';\nimport type { Context } from '@opentelemetry/api';\nimport type {\n  LangfuseRuntimeContext,\n  ResolvedLangfuseToolOutputTracingConfig,\n} from '@/langfuseRuntimeContext';\nimport type * as t from '@/types';\nimport {\n  getLangfuseRuntimeConfig,\n  getLangfuseRuntimeToolOutputTracingConfig,\n  getLangfuseScopeAgentId,\n  getLangfuseScopeRunId,\n  getTraceIdSeed,\n  hasLangfuseRuntimeContextValue,\n  replaceLangfuseRuntimeContext,\n  runWithLangfuseRuntimeContext,\n} from '@/langfuseRuntimeContext';\nimport {\n  hasToolOutputTracingConfig,\n  resolveLangfuseConfig,\n  resolveToolOutputTracingConfig,\n} from '@/langfuseConfig';\n\nexport type LangfuseRuntimeScope = LangfuseRuntimeContext;\n\nexport type ResolveLangfuseRuntimeScopeParams = {\n  runLangfuse?: t.LangfuseConfig;\n  langfuseOverlay?: t.LangfuseConfig;\n  traceIdSeed?: string;\n  runId?: string;\n  agentId?: string;\n};\n\nexport type LangfuseRuntimeScopeOptions = {\n  /** Replace the surrounding scope entirely instead of merging with it:\n   *  fields absent from `scope` are CLEARED rather than inherited. Required\n   *  when rejecting a foreign concurrent run's scope, whose explicit values\n   *  must not survive merge inheritance. */\n  replace?: boolean;\n};\n\nconst langfuseToolOutputTracingConfigKey = createContextKey(\n  'librechat.langfuse.tool-output-tracing'\n);\nconst langfuseConfigKey = createContextKey('librechat.langfuse.config');\nconst langfuseTraceIdSeedKey = createContextKey(\n  'librechat.langfuse.trace-id-seed'\n);\nconst langfuseScopeRunIdKey = createContextKey('librechat.langfuse.run-id');\nconst langfuseScopeAgentIdKey = createContextKey('librechat.langfuse.agent-id');\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction hasText(value: string | undefined): value is string {\n  return value != null && value.trim() !== '';\n}\n\nexport function getOtelLangfuseConfig(\n  activeContext: Context\n): t.LangfuseConfig | undefined {\n  const value = activeContext.getValue(langfuseConfigKey);\n  return isRecord(value) ? (value as t.LangfuseConfig) : undefined;\n}\n\nexport function getOtelTraceIdSeed(activeContext: Context): string | undefined {\n  const value = activeContext.getValue(langfuseTraceIdSeedKey);\n  return typeof value === 'string' && value.trim() !== '' ? value : undefined;\n}\n\nexport function getOtelToolOutputTracingConfig(\n  activeContext: Context\n): ResolvedLangfuseToolOutputTracingConfig | undefined {\n  const value = activeContext.getValue(langfuseToolOutputTracingConfigKey);\n  return isRecord(value)\n    ? (value as ResolvedLangfuseToolOutputTracingConfig)\n    : undefined;\n}\n\nexport function resolveLangfuseConfigForSpan(\n  activeContext: Context\n): t.LangfuseConfig | undefined {\n  return getLangfuseRuntimeConfig() ?? getOtelLangfuseConfig(activeContext);\n}\n\nexport function resolveTraceIdSeedForSpan(\n  activeContext: Context\n): string | undefined {\n  return getTraceIdSeed() ?? getOtelTraceIdSeed(activeContext);\n}\n\nfunction getOtelScopeRunId(activeContext: Context): string | undefined {\n  const value = activeContext.getValue(langfuseScopeRunIdKey);\n  return typeof value === 'string' && value.trim() !== '' ? value : undefined;\n}\n\nfunction getOtelScopeAgentId(activeContext: Context): string | undefined {\n  const value = activeContext.getValue(langfuseScopeAgentIdKey);\n  return typeof value === 'string' && value.trim() !== '' ? value : undefined;\n}\n\n/** The run identity the active scope belongs to (see\n *  `LangfuseRuntimeContext.runId`), or `undefined` for unstamped scopes. */\nexport function resolveLangfuseScopeRunId(\n  activeContext: Context\n): string | undefined {\n  return getLangfuseScopeRunId() ?? getOtelScopeRunId(activeContext);\n}\n\n/** The agent identity of a per-agent overlay scope (see\n *  `LangfuseRuntimeContext.agentId`), or `undefined` for run-level scopes. */\nexport function resolveLangfuseScopeAgentId(\n  activeContext: Context\n): string | undefined {\n  return getLangfuseScopeAgentId() ?? getOtelScopeAgentId(activeContext);\n}\n\nexport function resolveToolOutputTracingConfigForSpan(\n  activeContext: Context\n): ResolvedLangfuseToolOutputTracingConfig | undefined {\n  return (\n    getLangfuseRuntimeToolOutputTracingConfig() ??\n    getOtelToolOutputTracingConfig(activeContext)\n  );\n}\n\nfunction setOrClearContextValue(\n  activeContext: Context,\n  key: Parameters<Context['setValue']>[0],\n  value: unknown,\n  replace: boolean\n): Context {\n  if (value != null) {\n    return activeContext.setValue(key, value);\n  }\n  return replace ? activeContext.deleteValue(key) : activeContext;\n}\n\nexport function withLangfuseRuntimeScope<T>(\n  scope: LangfuseRuntimeScope,\n  action: () => T,\n  options?: LangfuseRuntimeScopeOptions\n): T {\n  const replace = options?.replace === true;\n  if (!replace && !hasLangfuseRuntimeContextValue(scope)) {\n    return action();\n  }\n\n  let activeContext = context.active();\n  activeContext = setOrClearContextValue(\n    activeContext,\n    langfuseConfigKey,\n    scope.langfuse,\n    replace\n  );\n  activeContext = setOrClearContextValue(\n    activeContext,\n    langfuseToolOutputTracingConfigKey,\n    scope.toolOutputTracing,\n    replace\n  );\n  activeContext = setOrClearContextValue(\n    activeContext,\n    langfuseTraceIdSeedKey,\n    hasText(scope.traceIdSeed) ? scope.traceIdSeed : undefined,\n    replace\n  );\n  activeContext = setOrClearContextValue(\n    activeContext,\n    langfuseScopeRunIdKey,\n    hasText(scope.runId) ? scope.runId : undefined,\n    replace\n  );\n  activeContext = setOrClearContextValue(\n    activeContext,\n    langfuseScopeAgentIdKey,\n    hasText(scope.agentId) ? scope.agentId : undefined,\n    replace\n  );\n\n  // Span processors receive the OTel parent context in `onStart`, while\n  // LangChain callback handlers may run outside that context and need ALS.\n  // The trace id generator reads the seed from ALS or OTel context so SDK\n  // callbacks that preserve only one of those contexts still keep trace/score\n  // cohesion.\n  const runScoped = replace\n    ? replaceLangfuseRuntimeContext\n    : runWithLangfuseRuntimeContext;\n  return runScoped(scope, () => context.with(activeContext, action));\n}\n\nexport function resolveLangfuseRuntimeScope({\n  runLangfuse,\n  langfuseOverlay,\n  traceIdSeed,\n  runId,\n  agentId,\n}: ResolveLangfuseRuntimeScopeParams): LangfuseRuntimeScope {\n  const langfuse = resolveLangfuseConfig(runLangfuse, langfuseOverlay);\n  const toolOutputTracing = !hasToolOutputTracingConfig(\n    runLangfuse,\n    langfuseOverlay\n  )\n    ? undefined\n    : resolveToolOutputTracingConfig(runLangfuse, langfuseOverlay);\n  return { langfuse, traceIdSeed, toolOutputTracing, runId, agentId };\n}\n"],"mappings":"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"}

package/dist/cjs/langfuseSpanRegistry.cjs

@@ -0,0 +1,95 @@
+const require_misc = require("./utils/misc.cjs");
+const require_langfuseConfig = require("./langfuseConfig.cjs");
+let node_crypto = require("node:crypto");
+//#region src/langfuseSpanRegistry.ts
+/**
+* Spans created through the Langfuse tracer provider, keyed by the export
+* destination they were routed to. Callback handlers use this to distinguish
+* safe ambient parents from spans a root observation must not inherit:
+*
+* - Foreign spans (a host's own OpenTelemetry instrumentation, e.g. HTTP
+*   server spans on the global provider) are never exported to Langfuse —
+*   inheriting one orphans the trace root (its root/trace input-output
+*   shaping is skipped), collapses concurrent runs inside one request
+*   context into a single merged trace, and bypasses the seeded
+*   deterministic trace id generator.
+* - Langfuse-managed spans bound to a *different* destination (another
+*   tenant's project) would leave the new trace dangling in its own
+*   destination while inheriting the other tenant's trace id.
+*
+* Only a managed span whose destination matches the starting run's resolved
+* destination is a safe parent — that is the sanctioned way for hosts to
+* group runs under their own Langfuse observations.
+*/
+const managedSpanDestinations = /* @__PURE__ */ new WeakMap();
+function registerLangfuseManagedSpan(span, destinationKey) {
+	managedSpanDestinations.set(span, destinationKey);
+}
+function getLangfuseManagedSpanDestination(span) {
+	return managedSpanDestinations.get(span);
+}
+function resolveLangfuseEnvironment(langfuse) {
+	const candidates = [
+		langfuse?.environment,
+		process.env.LANGFUSE_TRACING_ENVIRONMENT,
+		process.env.NODE_ENV
+	];
+	for (const candidate of candidates) if (candidate != null && candidate.trim() !== "") return candidate.trim();
+}
+function getLangfuseSpanProcessorParams(langfuse) {
+	if (langfuse?.enabled === false) return;
+	const environment = resolveLangfuseEnvironment(langfuse);
+	if (require_langfuseConfig.hasLangfuseConfigCredentials(langfuse)) return {
+		publicKey: langfuse.publicKey,
+		secretKey: langfuse.secretKey,
+		...require_misc.isPresent(langfuse.baseUrl) ? { baseUrl: langfuse.baseUrl } : {},
+		...require_misc.isPresent(environment) ? { environment } : {}
+	};
+	if (require_langfuseConfig.hasLangfuseEnvConfig()) {
+		const baseUrl = langfuse?.baseUrl ?? process.env.LANGFUSE_BASE_URL ?? process.env.LANGFUSE_BASEURL;
+		return {
+			publicKey: process.env.LANGFUSE_PUBLIC_KEY,
+			secretKey: process.env.LANGFUSE_SECRET_KEY,
+			...require_misc.isPresent(baseUrl) ? { baseUrl } : {},
+			...require_misc.isPresent(environment) ? { environment } : {}
+		};
+	}
+	if (require_misc.isPresent(langfuse?.baseUrl) && require_langfuseConfig.hasLangfuseEnvCredentials()) return {
+		publicKey: process.env.LANGFUSE_PUBLIC_KEY,
+		secretKey: process.env.LANGFUSE_SECRET_KEY,
+		baseUrl: langfuse.baseUrl,
+		...require_misc.isPresent(environment) ? { environment } : {}
+	};
+}
+function hashCacheKeyValue(value) {
+	return require_misc.isPresent(value) ? (0, node_crypto.createHash)("sha256").update(value, "utf8").digest("hex") : void 0;
+}
+/**
+* Identity of an export destination (project credentials + endpoint +
+* environment) only. Processor-level policies like `toolOutputTracing` are
+* deliberately excluded: two spans exporting to the same project under
+* different redaction settings still share a destination and may parent one
+* another.
+*/
+function getLangfuseDestinationKey(params) {
+	return JSON.stringify({
+		publicKey: params.publicKey,
+		secretKeyHash: hashCacheKeyValue(params.secretKey),
+		baseUrl: params.baseUrl,
+		environment: params.environment
+	});
+}
+/** The export destination a run with this config resolves to, or `undefined`
+*  when no Langfuse destination is configured. */
+function resolveLangfuseDestinationKey(langfuse) {
+	const params = getLangfuseSpanProcessorParams(langfuse);
+	return params == null ? void 0 : getLangfuseDestinationKey(params);
+}
+//#endregion
+exports.getLangfuseDestinationKey = getLangfuseDestinationKey;
+exports.getLangfuseManagedSpanDestination = getLangfuseManagedSpanDestination;
+exports.getLangfuseSpanProcessorParams = getLangfuseSpanProcessorParams;
+exports.registerLangfuseManagedSpan = registerLangfuseManagedSpan;
+exports.resolveLangfuseDestinationKey = resolveLangfuseDestinationKey;
+
+//# sourceMappingURL=langfuseSpanRegistry.cjs.map

package/dist/cjs/langfuseSpanRegistry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"langfuseSpanRegistry.cjs","names":["hasLangfuseConfigCredentials","isPresent","hasLangfuseEnvConfig","hasLangfuseEnvCredentials"],"sources":["../../src/langfuseSpanRegistry.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport type { LangfuseSpanProcessorParams } from '@langfuse/otel';\nimport type { Span } from '@opentelemetry/api';\nimport type * as t from '@/types';\nimport {\n  hasLangfuseConfigCredentials,\n  hasLangfuseEnvCredentials,\n  hasLangfuseEnvConfig,\n} from '@/langfuseConfig';\nimport { isPresent } from '@/utils/misc';\n\n/**\n * Spans created through the Langfuse tracer provider, keyed by the export\n * destination they were routed to. Callback handlers use this to distinguish\n * safe ambient parents from spans a root observation must not inherit:\n *\n * - Foreign spans (a host's own OpenTelemetry instrumentation, e.g. HTTP\n *   server spans on the global provider) are never exported to Langfuse —\n *   inheriting one orphans the trace root (its root/trace input-output\n *   shaping is skipped), collapses concurrent runs inside one request\n *   context into a single merged trace, and bypasses the seeded\n *   deterministic trace id generator.\n * - Langfuse-managed spans bound to a *different* destination (another\n *   tenant's project) would leave the new trace dangling in its own\n *   destination while inheriting the other tenant's trace id.\n *\n * Only a managed span whose destination matches the starting run's resolved\n * destination is a safe parent — that is the sanctioned way for hosts to\n * group runs under their own Langfuse observations.\n */\nconst managedSpanDestinations = new WeakMap<Span, string>();\n\nexport function registerLangfuseManagedSpan(\n  span: Span,\n  destinationKey: string\n): void {\n  managedSpanDestinations.set(span, destinationKey);\n}\n\nexport function getLangfuseManagedSpanDestination(\n  span: Span\n): string | undefined {\n  return managedSpanDestinations.get(span);\n}\n\nfunction resolveLangfuseEnvironment(\n  langfuse?: t.LangfuseConfig\n): string | undefined {\n  const candidates = [\n    langfuse?.environment,\n    process.env.LANGFUSE_TRACING_ENVIRONMENT,\n    process.env.NODE_ENV,\n  ];\n  for (const candidate of candidates) {\n    if (candidate != null && candidate.trim() !== '') {\n      return candidate.trim();\n    }\n  }\n  return undefined;\n}\n\nexport function getLangfuseSpanProcessorParams(\n  langfuse?: t.LangfuseConfig\n): LangfuseSpanProcessorParams | undefined {\n  if (langfuse?.enabled === false) {\n    return undefined;\n  }\n  const environment = resolveLangfuseEnvironment(langfuse);\n  if (hasLangfuseConfigCredentials(langfuse)) {\n    return {\n      publicKey: langfuse.publicKey,\n      secretKey: langfuse.secretKey,\n      ...(isPresent(langfuse.baseUrl) ? { baseUrl: langfuse.baseUrl } : {}),\n      ...(isPresent(environment) ? { environment } : {}),\n    };\n  }\n  if (hasLangfuseEnvConfig()) {\n    const baseUrl =\n      langfuse?.baseUrl ??\n      process.env.LANGFUSE_BASE_URL ??\n      process.env.LANGFUSE_BASEURL;\n    return {\n      publicKey: process.env.LANGFUSE_PUBLIC_KEY as string,\n      secretKey: process.env.LANGFUSE_SECRET_KEY as string,\n      ...(isPresent(baseUrl) ? { baseUrl } : {}),\n      ...(isPresent(environment) ? { environment } : {}),\n    };\n  }\n  if (isPresent(langfuse?.baseUrl) && hasLangfuseEnvCredentials()) {\n    return {\n      publicKey: process.env.LANGFUSE_PUBLIC_KEY as string,\n      secretKey: process.env.LANGFUSE_SECRET_KEY as string,\n      baseUrl: langfuse.baseUrl,\n      ...(isPresent(environment) ? { environment } : {}),\n    };\n  }\n  return undefined;\n}\n\nfunction hashCacheKeyValue(value: string | undefined): string | undefined {\n  return isPresent(value)\n    ? createHash('sha256').update(value, 'utf8').digest('hex')\n    : undefined;\n}\n\n/**\n * Identity of an export destination (project credentials + endpoint +\n * environment) only. Processor-level policies like `toolOutputTracing` are\n * deliberately excluded: two spans exporting to the same project under\n * different redaction settings still share a destination and may parent one\n * another.\n */\nexport function getLangfuseDestinationKey(\n  params: LangfuseSpanProcessorParams\n): string {\n  return JSON.stringify({\n    publicKey: params.publicKey,\n    secretKeyHash: hashCacheKeyValue(params.secretKey),\n    baseUrl: params.baseUrl,\n    environment: params.environment,\n  });\n}\n\n/** The export destination a run with this config resolves to, or `undefined`\n *  when no Langfuse destination is configured. */\nexport function resolveLangfuseDestinationKey(\n  langfuse?: t.LangfuseConfig\n): string | undefined {\n  const params = getLangfuseSpanProcessorParams(langfuse);\n  return params == null ? undefined : getLangfuseDestinationKey(params);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA8BA,MAAM,0CAA0B,IAAI,QAAsB;AAE1D,SAAgB,4BACd,MACA,gBACM;CACN,wBAAwB,IAAI,MAAM,cAAc;AAClD;AAEA,SAAgB,kCACd,MACoB;CACpB,OAAO,wBAAwB,IAAI,IAAI;AACzC;AAEA,SAAS,2BACP,UACoB;CACpB,MAAM,aAAa;EACjB,UAAU;EACV,QAAQ,IAAI;EACZ,QAAQ,IAAI;CACd;CACA,KAAK,MAAM,aAAa,YACtB,IAAI,aAAa,QAAQ,UAAU,KAAK,MAAM,IAC5C,OAAO,UAAU,KAAK;AAI5B;AAEA,SAAgB,+BACd,UACyC;CACzC,IAAI,UAAU,YAAY,OACxB;CAEF,MAAM,cAAc,2BAA2B,QAAQ;CACvD,IAAIA,uBAAAA,6BAA6B,QAAQ,GACvC,OAAO;EACL,WAAW,SAAS;EACpB,WAAW,SAAS;EACpB,GAAIC,aAAAA,UAAU,SAAS,OAAO,IAAI,EAAE,SAAS,SAAS,QAAQ,IAAI,CAAC;EACnE,GAAIA,aAAAA,UAAU,WAAW,IAAI,EAAE,YAAY,IAAI,CAAC;CAClD;CAEF,IAAIC,uBAAAA,qBAAqB,GAAG;EAC1B,MAAM,UACJ,UAAU,WACV,QAAQ,IAAI,qBACZ,QAAQ,IAAI;EACd,OAAO;GACL,WAAW,QAAQ,IAAI;GACvB,WAAW,QAAQ,IAAI;GACvB,GAAID,aAAAA,UAAU,OAAO,IAAI,EAAE,QAAQ,IAAI,CAAC;GACxC,GAAIA,aAAAA,UAAU,WAAW,IAAI,EAAE,YAAY,IAAI,CAAC;EAClD;CACF;CACA,IAAIA,aAAAA,UAAU,UAAU,OAAO,KAAKE,uBAAAA,0BAA0B,GAC5D,OAAO;EACL,WAAW,QAAQ,IAAI;EACvB,WAAW,QAAQ,IAAI;EACvB,SAAS,SAAS;EAClB,GAAIF,aAAAA,UAAU,WAAW,IAAI,EAAE,YAAY,IAAI,CAAC;CAClD;AAGJ;AAEA,SAAS,kBAAkB,OAA+C;CACxE,OAAOA,aAAAA,UAAU,KAAK,KAAA,GAAA,YAAA,WAAA,CACP,QAAQ,CAAC,CAAC,OAAO,OAAO,MAAM,CAAC,CAAC,OAAO,KAAK,IACvD,KAAA;AACN;;;;;;;;AASA,SAAgB,0BACd,QACQ;CACR,OAAO,KAAK,UAAU;EACpB,WAAW,OAAO;EAClB,eAAe,kBAAkB,OAAO,SAAS;EACjD,SAAS,OAAO;EAChB,aAAa,OAAO;CACtB,CAAC;AACH;;;AAIA,SAAgB,8BACd,UACoB;CACpB,MAAM,SAAS,+BAA+B,QAAQ;CACtD,OAAO,UAAU,OAAO,KAAA,IAAY,0BAA0B,MAAM;AACtE"}

package/dist/cjs/langfuseTraceShaping.cjs

@@ -1,3 +1,5 @@
+require("./common/enum.cjs");
+require("./common/index.cjs");
 let _langfuse_tracing = require("@langfuse/tracing");
 //#region src/langfuseTraceShaping.ts
 const LANGGRAPH_START_NODE = "__start__";
@@ -9,8 +11,12 @@ const TOOL_DISPATCH_SPAN_NAME = "tool-dispatch";
 const GENERATION_SPAN_NAME = "llm";
 const ROOT_OBSERVATION_TYPE = "agent";
 const CHAIN_OBSERVATION_TYPE = "chain";
+const TOOL_OBSERVATION_TYPE = "tool";
 const AGENT_TRACE_TAG = "agent";
 const TITLE_TRACE_TAG = "title";
+const EPHEMERAL_AGENT_SENDER_SEPARATOR = "___";
+const EPHEMERAL_AGENT_INDEX_SEPARATOR = "____";
+const OBSERVATION_METADATA_LANGGRAPH_NODE = `${_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_METADATA}.langgraph_node`;
 function isRecord(value) {
 	return value != null && typeof value === "object" && !Array.isArray(value);
 }
@@ -94,13 +100,64 @@ function getMessageToolCalls(message) {
 	}
 	return calls;
 }
+/**
+* Id-bearing `invalid_tool_calls` on the assistant turn. ToolNode pairs these
+* with synthesized error results (and an invalid-only turn is routed on them
+* alone), so the tool-dispatch span must count them as part of the executing
+* batch — otherwise an invalid-only dispatch finds zero calls and the span
+* keeps the full serialized graph state as its input, and a mixed dispatch
+* silently omits the malformed call. `args` stays the raw unparsed string.
+*/
+/** Tool-result ids present in the serialized state — ToolNode's
+*  `!toolMessageIds.has(id)` execution filter, mirrored for the span. */
+function getToolResultIds(messages) {
+	const ids = /* @__PURE__ */ new Set();
+	for (const message of messages) {
+		if (getMessageRole(message) !== "tool") continue;
+		const rawId = message.tool_call_id ?? (isRecord(message.kwargs) ? message.kwargs.tool_call_id : void 0) ?? (isRecord(message.data) ? message.data.tool_call_id : void 0);
+		if (typeof rawId === "string" && rawId !== "") ids.add(rawId);
+	}
+	return ids;
+}
+function getMessageInvalidToolCalls(message, answeredIds) {
+	const rawCalls = message.invalid_tool_calls ?? (isRecord(message.kwargs) ? message.kwargs.invalid_tool_calls : void 0) ?? (isRecord(message.data) ? message.data.invalid_tool_calls : void 0);
+	if (!Array.isArray(rawCalls)) return [];
+	const calls = [];
+	for (const rawCall of rawCalls) {
+		if (!isRecord(rawCall) || typeof rawCall.id !== "string" || rawCall.id === "" || answeredIds.has(rawCall.id) || rawCall.id.startsWith("srvtoolu_")) continue;
+		const call = normalizeToolCall(typeof rawCall.name === "string" && rawCall.name !== "" ? rawCall : {
+			...rawCall,
+			name: "unknown"
+		});
+		if (call != null) calls.push(call);
+	}
+	return calls;
+}
+/** The serialized message's own id (uuid), NOT the LC-serialization type id
+*  array that `message.id` carries in constructor dumps. */
+function getSerializedMessageId(message) {
+	const kwargsId = isRecord(message.kwargs) ? message.kwargs.id : void 0;
+	const dataId = isRecord(message.data) ? message.data.id : void 0;
+	const rawId = message.id;
+	const id = kwargsId ?? dataId ?? rawId;
+	return typeof id === "string" && id !== "" ? id : void 0;
+}
 /** Latest assistant turn's tool calls — the calls this tool node is executing. */
 function findPendingToolCalls(value) {
 	const messages = getMessageArray(value);
 	if (messages == null) return [];
+	/**
+	* Invalid calls count only where ToolNode's own gate lets them execute:
+	* the messages-state form (a bare-array state means the node returns a
+	* plain output list and skips invalid handling) with an id-bearing
+	* assistant message (no id, no reducer upsert). Mirrors
+	* `canPromoteInvalidCalls` so the span never reports skipped calls.
+	*/
+	const invalidCallsApply = !Array.isArray(value);
+	const answeredIds = invalidCallsApply ? getToolResultIds(messages) : void 0;
 	for (let i = messages.length - 1; i >= 0; i--) {
 		if (getMessageRole(messages[i]) !== "assistant") continue;
-		const calls = getMessageToolCalls(messages[i]);
+		const calls = [...getMessageToolCalls(messages[i]), ...invalidCallsApply && getSerializedMessageId(messages[i]) != null ? getMessageInvalidToolCalls(messages[i], answeredIds) : []];
 		if (calls.length > 0) return calls;
 	}
 	return [];
@@ -144,8 +201,17 @@ function shapeRootSpan(span) {
 	const outputKey = _langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT;
 	const question = findLastMessageText(parseAttributeValue(span.attributes[inputKey]), "user");
 	const answer = findLastMessageText(parseAttributeValue(span.attributes[outputKey]), "assistant");
-	if (question != null) span.attributes[inputKey] = question;
-	if (answer != null) span.attributes[outputKey] = answer;
+	/** A generation that IS the trace root — a bare `model.invoke` with no
+	*  wrapping chain, i.e. the activity-label path — is also the only
+	*  observation carrying its own prompt: reducing its observation input
+	*  would discard the SystemMessage from the one place it is traced.
+	*  Chain/agent roots keep the full reduction; their child generations
+	*  still record the complete prompt. Trace-level input/output reduce
+	*  either way, so the trace list keeps showing question and answer. */
+	if (!isGenerationSpan(span)) {
+		if (question != null) span.attributes[inputKey] = question;
+		if (answer != null) span.attributes[outputKey] = answer;
+	}
 	const traceInput = question ?? span.attributes[inputKey];
 	const traceOutput = answer ?? span.attributes[outputKey];
 	if (traceInput != null) span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.TRACE_INPUT] = traceInput;
@@ -155,6 +221,55 @@ function isGenerationSpan(span) {
 	const type = span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_TYPE];
 	return typeof type === "string" && type.toLowerCase() === "generation";
 }
+function isToolSpan(span) {
+	const type = span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_TYPE];
+	return typeof type === "string" && type.toLowerCase() === TOOL_OBSERVATION_TYPE;
+}
+/**
+* Whether the span is a LangGraph node execution whose node id is the span
+* name — the shape of the outer workflow-agent node. `@langfuse/tracing`
+* flattens object metadata to per-key attributes with string values stored
+* raw, so LangGraph's `langgraph_node` arrives directly comparable.
+*/
+function isWorkflowNodeSpan(span) {
+	return span.attributes[OBSERVATION_METADATA_LANGGRAPH_NODE] === span.name;
+}
+/**
+* LibreChat ephemeral agents are identified as
+* `endpoint__model___sender[____index]` (`__` encodes `:`; see LibreChat's
+* `encodeEphemeralAgentId`), and the outer workflow node carries that id as
+* its span name — so switching models renames the span (item 1). Returns the
+* stable human `sender` segment only when the name matches that encoding:
+* the `endpoint__model` prefix must contain both segments and — unlike
+* display names such as `LibreChat Agent: Ops___EU` — never contains
+* whitespace, so legitimate names that merely embed `___` are left alone.
+*/
+function extractEphemeralAgentSender(name) {
+	let workingId = name;
+	const indexSeparator = workingId.lastIndexOf(EPHEMERAL_AGENT_INDEX_SEPARATOR);
+	if (indexSeparator !== -1 && /^\d+$/.test(workingId.slice(indexSeparator + 4))) workingId = workingId.slice(0, indexSeparator);
+	const senderSeparator = workingId.indexOf(EPHEMERAL_AGENT_SENDER_SEPARATOR);
+	if (senderSeparator <= 0) return;
+	const encodedPrefix = workingId.slice(0, senderSeparator);
+	if (/\s/.test(encodedPrefix)) return;
+	const prefixParts = encodedPrefix.split("__");
+	if (prefixParts.length < 2 || prefixParts.some((part) => part === "")) return;
+	const sender = workingId.slice(senderSeparator + 3).replace(/__/g, ":");
+	return sender === "" ? void 0 : sender;
+}
+/** Workflow-agent node spans are always children of the run's root chain and
+*  always carry `langgraph_node` metadata equal to their name, so host-named
+*  run roots (`LibreChat Agent: <name>`) and ordinary chains that merely look
+*  like encoded ids (`pipeline__stage___EU`) are never rename candidates.
+*  Successful decodes become `agent` observations, matching the inner
+*  `agent=<id>` node shaping. */
+function shapeEphemeralAgentNodeSpan(span) {
+	if (isToolSpan(span) || isRootSpan(span) || !isWorkflowNodeSpan(span)) return;
+	const sender = extractEphemeralAgentSender(span.name);
+	if (sender == null) return;
+	span.name = sender;
+	span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.OBSERVATION_TYPE] = ROOT_OBSERVATION_TYPE;
+}
 function hasTraceTag(span, expectedTag) {
 	const tags = parseAttributeValue(span.attributes[_langfuse_tracing.LangfuseOtelSpanAttributes.TRACE_TAGS]);
 	return Array.isArray(tags) && tags.some((tag) => typeof tag === "string" && tag === expectedTag);
@@ -171,7 +286,8 @@ function shapeRootObservationType(span) {
 * Reshapes spans per Langfuse-team feedback before export:
 * - `agent=<id>` / `tools=<id>` node names carry the ephemeral agent id
 *   (`provider__model`) — strip it so switching models doesn't break
-*   name-based logic (item 1).
+*   name-based logic (item 1). The outer workflow node is named with the
+*   bare agent id; ephemeral ids reduce to their stable sender name.
 * - LLM generation spans keep the provider client class name (`ChatOpenAI`,
 *   `AzureChatOpenAI`, …); rename them to a provider-agnostic `llm` so the
 *   name reflects the operation, not the model (the model stays on the
@@ -188,6 +304,7 @@ function shapeLangfuseSpan(span) {
 	if (mutable.name.startsWith(LANGGRAPH_AGENT_NODE_PREFIX)) shapeAgentNodeSpan(mutable);
 	else if (mutable.name.startsWith(LANGGRAPH_TOOL_NODE_PREFIX)) shapeToolNodeSpan(mutable);
 	else if (isGenerationSpan(mutable)) mutable.name = GENERATION_SPAN_NAME;
+	else shapeEphemeralAgentNodeSpan(mutable);
 	if (!isRootSpan(span)) return;
 	shapeRootObservationType(mutable);
 	shapeRootSpan(mutable);

package/dist/cjs/langfuseTraceShaping.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"langfuseTraceShaping.cjs","names":["LangfuseOtelSpanAttributes"],"sources":["../../src/langfuseTraceShaping.ts"],"sourcesContent":["import { LangfuseOtelSpanAttributes } from '@langfuse/tracing';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\n\nconst LANGGRAPH_START_NODE = '__start__';\nconst ANONYMOUS_LAMBDA_NAME = 'RunnableLambda';\nconst LANGGRAPH_AGENT_NODE_PREFIX = 'agent=';\nconst LANGGRAPH_TOOL_NODE_PREFIX = 'tools=';\nconst AGENT_NODE_SPAN_NAME = 'agent';\nconst TOOL_DISPATCH_SPAN_NAME = 'tool-dispatch';\nconst GENERATION_SPAN_NAME = 'llm';\nconst ROOT_OBSERVATION_TYPE = 'agent';\nconst CHAIN_OBSERVATION_TYPE = 'chain';\nconst AGENT_TRACE_TAG = 'agent';\nconst TITLE_TRACE_TAG = 'title';\n\ntype MutableSpan = ReadableSpan & {\n  name: string;\n  attributes: Record<string, unknown>;\n};\n\ntype SerializedToolCall = {\n  name: string;\n  args: unknown;\n  id?: string;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction parseAttributeValue(value: unknown): unknown {\n  if (typeof value !== 'string') {\n    return value;\n  }\n  const trimmed = value.trim();\n  if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {\n    return value;\n  }\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return value;\n  }\n}\n\nfunction getMessageArray(\n  value: unknown\n): Record<string, unknown>[] | undefined {\n  if (Array.isArray(value)) {\n    const records = value.filter(isRecord);\n    return records.length > 0 ? records : undefined;\n  }\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  return (\n    getMessageArray(value.messages) ??\n    getMessageArray(value.input) ??\n    getMessageArray(value.output)\n  );\n}\n\nfunction getMessageRole(message: Record<string, unknown>): string | undefined {\n  const id = message.id;\n  if (Array.isArray(id)) {\n    const className = id[id.length - 1];\n    if (typeof className === 'string') {\n      if (className.includes('Human')) {\n        return 'user';\n      }\n      if (className.includes('AI')) {\n        return 'assistant';\n      }\n      if (className.includes('System')) {\n        return 'system';\n      }\n      if (className.includes('Tool')) {\n        return 'tool';\n      }\n    }\n  }\n  const rawRole =\n    message.type ?? message._type ?? message.role ?? message.sender;\n  if (typeof rawRole !== 'string') {\n    const kwargs = message.kwargs;\n    return isRecord(kwargs) ? getMessageRole(kwargs) : undefined;\n  }\n  const normalized = rawRole.toLowerCase();\n  if (normalized === 'human') {\n    return 'user';\n  }\n  if (normalized === 'ai') {\n    return 'assistant';\n  }\n  return normalized;\n}\n\nfunction getMessageText(message: Record<string, unknown>): string | undefined {\n  const content =\n    message.content ??\n    (isRecord(message.kwargs) ? message.kwargs.content : undefined) ??\n    (isRecord(message.data) ? message.data.content : undefined);\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return undefined;\n  }\n  const text = content\n    .filter(isRecord)\n    .map((part) => (typeof part.text === 'string' ? part.text : ''))\n    .join('');\n  return text === '' ? undefined : text;\n}\n\nfunction findLastMessageText(value: unknown, role: string): string | undefined {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return undefined;\n  }\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== role) {\n      continue;\n    }\n    const text = getMessageText(messages[i]);\n    if (text != null && text.trim() !== '') {\n      return text;\n    }\n  }\n  return undefined;\n}\n\nfunction normalizeToolCall(value: unknown): SerializedToolCall | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  const fn = value.function;\n  if (isRecord(fn) && typeof fn.name === 'string') {\n    return {\n      name: fn.name,\n      args: parseAttributeValue(fn.arguments),\n      ...(typeof value.id === 'string' ? { id: value.id } : {}),\n    };\n  }\n  if (typeof value.name !== 'string') {\n    return undefined;\n  }\n  return {\n    name: value.name,\n    args: value.args ?? {},\n    ...(typeof value.id === 'string' ? { id: value.id } : {}),\n  };\n}\n\nfunction getMessageToolCalls(\n  message: Record<string, unknown>\n): SerializedToolCall[] {\n  const rawCalls =\n    message.tool_calls ??\n    (isRecord(message.kwargs) ? message.kwargs.tool_calls : undefined) ??\n    (isRecord(message.additional_kwargs)\n      ? message.additional_kwargs.tool_calls\n      : undefined) ??\n    (isRecord(message.data) ? message.data.tool_calls : undefined);\n  if (!Array.isArray(rawCalls)) {\n    return [];\n  }\n  const calls: SerializedToolCall[] = [];\n  for (const rawCall of rawCalls) {\n    const call = normalizeToolCall(rawCall);\n    if (call != null) {\n      calls.push(call);\n    }\n  }\n  return calls;\n}\n\n/** Latest assistant turn's tool calls — the calls this tool node is executing. */\nfunction findPendingToolCalls(value: unknown): SerializedToolCall[] {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return [];\n  }\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== 'assistant') {\n      continue;\n    }\n    const calls = getMessageToolCalls(messages[i]);\n    if (calls.length > 0) {\n      return calls;\n    }\n  }\n  return [];\n}\n\nfunction getRootSpanParentId(span: ReadableSpan): string | undefined {\n  const legacyParent = (span as { parentSpanId?: string }).parentSpanId;\n  if (typeof legacyParent === 'string' && legacyParent !== '') {\n    return legacyParent;\n  }\n  const parentContext = (span as { parentSpanContext?: { spanId?: string } })\n    .parentSpanContext;\n  const spanId = parentContext?.spanId;\n  return typeof spanId === 'string' && spanId !== '' ? spanId : undefined;\n}\n\nfunction isRootSpan(span: ReadableSpan): boolean {\n  return getRootSpanParentId(span) == null;\n}\n\n/**\n * LangGraph plumbing observations that add noise without information:\n * the duplicated `__start__` channel-seed nodes and anonymous\n * `RunnableLambda` pass-throughs (Langfuse team feedback items 4 & 5).\n * Internal ToolNode batch spans are disabled at their source so traced child\n * tools retain an exported parent. Explicitly traced ToolNodes are preserved.\n */\nexport function shouldDropLangfuseSpan(spanName: string): boolean {\n  return (\n    spanName === LANGGRAPH_START_NODE || spanName === ANONYMOUS_LAMBDA_NAME\n  );\n}\n\nfunction shapeToolNodeSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  span.name = TOOL_DISPATCH_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    CHAIN_OBSERVATION_TYPE;\n  const calls = findPendingToolCalls(\n    parseAttributeValue(span.attributes[inputKey])\n  );\n  if (calls.length === 0) {\n    return;\n  }\n  span.attributes[inputKey] = JSON.stringify(\n    calls.map(({ name, args }) => ({ name, args }))\n  );\n}\n\nfunction shapeAgentNodeSpan(span: MutableSpan): void {\n  span.name = AGENT_NODE_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    ROOT_OBSERVATION_TYPE;\n}\n\nfunction shapeRootSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  const outputKey = LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT;\n  const question = findLastMessageText(\n    parseAttributeValue(span.attributes[inputKey]),\n    'user'\n  );\n  const answer = findLastMessageText(\n    parseAttributeValue(span.attributes[outputKey]),\n    'assistant'\n  );\n  if (question != null) {\n    span.attributes[inputKey] = question;\n  }\n  if (answer != null) {\n    span.attributes[outputKey] = answer;\n  }\n  const traceInput = question ?? span.attributes[inputKey];\n  const traceOutput = answer ?? span.attributes[outputKey];\n  if (traceInput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_INPUT] = traceInput;\n  }\n  if (traceOutput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_OUTPUT] = traceOutput;\n  }\n}\n\nfunction isGenerationSpan(span: MutableSpan): boolean {\n  const type = span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE];\n  return typeof type === 'string' && type.toLowerCase() === 'generation';\n}\n\nfunction hasTraceTag(span: MutableSpan, expectedTag: string): boolean {\n  const tags = parseAttributeValue(\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_TAGS]\n  );\n  return (\n    Array.isArray(tags) &&\n    tags.some((tag) => typeof tag === 'string' && tag === expectedTag)\n  );\n}\n\nfunction shapeRootObservationType(span: MutableSpan): void {\n  if (isGenerationSpan(span)) {\n    return;\n  }\n  if (hasTraceTag(span, AGENT_TRACE_TAG)) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      ROOT_OBSERVATION_TYPE;\n    return;\n  }\n  if (hasTraceTag(span, TITLE_TRACE_TAG)) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      CHAIN_OBSERVATION_TYPE;\n  }\n}\n\n/**\n * Reshapes spans per Langfuse-team feedback before export:\n * - `agent=<id>` / `tools=<id>` node names carry the ephemeral agent id\n *   (`provider__model`) — strip it so switching models doesn't break\n *   name-based logic (item 1).\n * - LLM generation spans keep the provider client class name (`ChatOpenAI`,\n *   `AzureChatOpenAI`, …); rename them to a provider-agnostic `llm` so the\n *   name reflects the operation, not the model (the model stays on the\n *   generation's model attribute).\n * - Agent nodes become `agent` observations, while tool-dispatch nodes become\n *   stable `chain` observations whose input is scoped to the pending calls.\n *   Individual child calls remain `tool` observations (items 3 & 4).\n * - Agent trace roots become `agent` observations and title trace roots become\n *   `chain` observations. Root and trace input/output are reduced to the user\n *   question and assistant response when chat messages are available (item 2).\n */\nexport function shapeLangfuseSpan(span: ReadableSpan): void {\n  const mutable = span as MutableSpan;\n  if (mutable.name.startsWith(LANGGRAPH_AGENT_NODE_PREFIX)) {\n    shapeAgentNodeSpan(mutable);\n  } else if (mutable.name.startsWith(LANGGRAPH_TOOL_NODE_PREFIX)) {\n    shapeToolNodeSpan(mutable);\n  } else if (isGenerationSpan(mutable)) {\n    mutable.name = GENERATION_SPAN_NAME;\n  }\n  if (!isRootSpan(span)) {\n    return;\n  }\n  shapeRootObservationType(mutable);\n  shapeRootSpan(mutable);\n}\n"],"mappings":"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"}
+{"version":3,"file":"langfuseTraceShaping.cjs","names":["LangfuseOtelSpanAttributes"],"sources":["../../src/langfuseTraceShaping.ts"],"sourcesContent":["import { LangfuseOtelSpanAttributes } from '@langfuse/tracing';\nimport type { ReadableSpan } from '@opentelemetry/sdk-trace-base';\nimport { Constants } from '@/common';\n\nconst LANGGRAPH_START_NODE = '__start__';\nconst ANONYMOUS_LAMBDA_NAME = 'RunnableLambda';\nconst LANGGRAPH_AGENT_NODE_PREFIX = 'agent=';\nconst LANGGRAPH_TOOL_NODE_PREFIX = 'tools=';\nconst AGENT_NODE_SPAN_NAME = 'agent';\nconst TOOL_DISPATCH_SPAN_NAME = 'tool-dispatch';\nconst GENERATION_SPAN_NAME = 'llm';\nconst ROOT_OBSERVATION_TYPE = 'agent';\nconst CHAIN_OBSERVATION_TYPE = 'chain';\nconst TOOL_OBSERVATION_TYPE = 'tool';\nconst AGENT_TRACE_TAG = 'agent';\nconst TITLE_TRACE_TAG = 'title';\nconst EPHEMERAL_AGENT_SENDER_SEPARATOR = '___';\nconst EPHEMERAL_AGENT_INDEX_SEPARATOR = '____';\nconst OBSERVATION_METADATA_LANGGRAPH_NODE = `${LangfuseOtelSpanAttributes.OBSERVATION_METADATA}.langgraph_node`;\n\ntype MutableSpan = ReadableSpan & {\n  name: string;\n  attributes: Record<string, unknown>;\n};\n\ntype SerializedToolCall = {\n  name: string;\n  args: unknown;\n  id?: string;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value != null && typeof value === 'object' && !Array.isArray(value);\n}\n\nfunction parseAttributeValue(value: unknown): unknown {\n  if (typeof value !== 'string') {\n    return value;\n  }\n  const trimmed = value.trim();\n  if (!trimmed.startsWith('{') && !trimmed.startsWith('[')) {\n    return value;\n  }\n  try {\n    return JSON.parse(value) as unknown;\n  } catch {\n    return value;\n  }\n}\n\nfunction getMessageArray(\n  value: unknown\n): Record<string, unknown>[] | undefined {\n  if (Array.isArray(value)) {\n    const records = value.filter(isRecord);\n    return records.length > 0 ? records : undefined;\n  }\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  return (\n    getMessageArray(value.messages) ??\n    getMessageArray(value.input) ??\n    getMessageArray(value.output)\n  );\n}\n\nfunction getMessageRole(message: Record<string, unknown>): string | undefined {\n  const id = message.id;\n  if (Array.isArray(id)) {\n    const className = id[id.length - 1];\n    if (typeof className === 'string') {\n      if (className.includes('Human')) {\n        return 'user';\n      }\n      if (className.includes('AI')) {\n        return 'assistant';\n      }\n      if (className.includes('System')) {\n        return 'system';\n      }\n      if (className.includes('Tool')) {\n        return 'tool';\n      }\n    }\n  }\n  const rawRole =\n    message.type ?? message._type ?? message.role ?? message.sender;\n  if (typeof rawRole !== 'string') {\n    const kwargs = message.kwargs;\n    return isRecord(kwargs) ? getMessageRole(kwargs) : undefined;\n  }\n  const normalized = rawRole.toLowerCase();\n  if (normalized === 'human') {\n    return 'user';\n  }\n  if (normalized === 'ai') {\n    return 'assistant';\n  }\n  return normalized;\n}\n\nfunction getMessageText(message: Record<string, unknown>): string | undefined {\n  const content =\n    message.content ??\n    (isRecord(message.kwargs) ? message.kwargs.content : undefined) ??\n    (isRecord(message.data) ? message.data.content : undefined);\n  if (typeof content === 'string') {\n    return content;\n  }\n  if (!Array.isArray(content)) {\n    return undefined;\n  }\n  const text = content\n    .filter(isRecord)\n    .map((part) => (typeof part.text === 'string' ? part.text : ''))\n    .join('');\n  return text === '' ? undefined : text;\n}\n\nfunction findLastMessageText(value: unknown, role: string): string | undefined {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return undefined;\n  }\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== role) {\n      continue;\n    }\n    const text = getMessageText(messages[i]);\n    if (text != null && text.trim() !== '') {\n      return text;\n    }\n  }\n  return undefined;\n}\n\nfunction normalizeToolCall(value: unknown): SerializedToolCall | undefined {\n  if (!isRecord(value)) {\n    return undefined;\n  }\n  const fn = value.function;\n  if (isRecord(fn) && typeof fn.name === 'string') {\n    return {\n      name: fn.name,\n      args: parseAttributeValue(fn.arguments),\n      ...(typeof value.id === 'string' ? { id: value.id } : {}),\n    };\n  }\n  if (typeof value.name !== 'string') {\n    return undefined;\n  }\n  return {\n    name: value.name,\n    args: value.args ?? {},\n    ...(typeof value.id === 'string' ? { id: value.id } : {}),\n  };\n}\n\nfunction getMessageToolCalls(\n  message: Record<string, unknown>\n): SerializedToolCall[] {\n  const rawCalls =\n    message.tool_calls ??\n    (isRecord(message.kwargs) ? message.kwargs.tool_calls : undefined) ??\n    (isRecord(message.additional_kwargs)\n      ? message.additional_kwargs.tool_calls\n      : undefined) ??\n    (isRecord(message.data) ? message.data.tool_calls : undefined);\n  if (!Array.isArray(rawCalls)) {\n    return [];\n  }\n  const calls: SerializedToolCall[] = [];\n  for (const rawCall of rawCalls) {\n    const call = normalizeToolCall(rawCall);\n    if (call != null) {\n      calls.push(call);\n    }\n  }\n  return calls;\n}\n\n/**\n * Id-bearing `invalid_tool_calls` on the assistant turn. ToolNode pairs these\n * with synthesized error results (and an invalid-only turn is routed on them\n * alone), so the tool-dispatch span must count them as part of the executing\n * batch — otherwise an invalid-only dispatch finds zero calls and the span\n * keeps the full serialized graph state as its input, and a mixed dispatch\n * silently omits the malformed call. `args` stays the raw unparsed string.\n */\n/** Tool-result ids present in the serialized state — ToolNode's\n *  `!toolMessageIds.has(id)` execution filter, mirrored for the span. */\nfunction getToolResultIds(\n  messages: Record<string, unknown>[]\n): Set<string> {\n  const ids = new Set<string>();\n  for (const message of messages) {\n    if (getMessageRole(message) !== 'tool') {\n      continue;\n    }\n    const rawId =\n      message.tool_call_id ??\n      (isRecord(message.kwargs) ? message.kwargs.tool_call_id : undefined) ??\n      (isRecord(message.data) ? message.data.tool_call_id : undefined);\n    if (typeof rawId === 'string' && rawId !== '') {\n      ids.add(rawId);\n    }\n  }\n  return ids;\n}\n\nfunction getMessageInvalidToolCalls(\n  message: Record<string, unknown>,\n  answeredIds: ReadonlySet<string>\n): SerializedToolCall[] {\n  const rawCalls =\n    message.invalid_tool_calls ??\n    (isRecord(message.kwargs) ? message.kwargs.invalid_tool_calls : undefined) ??\n    (isRecord(message.data) ? message.data.invalid_tool_calls : undefined);\n  if (!Array.isArray(rawCalls)) {\n    return [];\n  }\n  const calls: SerializedToolCall[] = [];\n  for (const rawCall of rawCalls) {\n    // Same attribution predicate ToolNode executes with (id-bearing,\n    // non-server) so the span never claims calls the node deliberately skips.\n    if (\n      !isRecord(rawCall) ||\n      typeof rawCall.id !== 'string' ||\n      rawCall.id === '' ||\n      answeredIds.has(rawCall.id) ||\n      rawCall.id.startsWith(Constants.ANTHROPIC_SERVER_TOOL_PREFIX)\n    ) {\n      continue;\n    }\n    // Same name fallback ToolNode synthesizes with — a nameless attributable\n    // call still gets a result, so it must still count in the span input.\n    const call = normalizeToolCall(\n      typeof rawCall.name === 'string' && rawCall.name !== ''\n        ? rawCall\n        : { ...rawCall, name: 'unknown' }\n    );\n    if (call != null) {\n      calls.push(call);\n    }\n  }\n  return calls;\n}\n\n/** The serialized message's own id (uuid), NOT the LC-serialization type id\n *  array that `message.id` carries in constructor dumps. */\nfunction getSerializedMessageId(\n  message: Record<string, unknown>\n): string | undefined {\n  const kwargsId = isRecord(message.kwargs) ? message.kwargs.id : undefined;\n  const dataId = isRecord(message.data) ? message.data.id : undefined;\n  const rawId = message.id;\n  const id = kwargsId ?? dataId ?? rawId;\n  return typeof id === 'string' && id !== '' ? id : undefined;\n}\n\n/** Latest assistant turn's tool calls — the calls this tool node is executing. */\nfunction findPendingToolCalls(value: unknown): SerializedToolCall[] {\n  const messages = getMessageArray(value);\n  if (messages == null) {\n    return [];\n  }\n  /**\n   * Invalid calls count only where ToolNode's own gate lets them execute:\n   * the messages-state form (a bare-array state means the node returns a\n   * plain output list and skips invalid handling) with an id-bearing\n   * assistant message (no id, no reducer upsert). Mirrors\n   * `canPromoteInvalidCalls` so the span never reports skipped calls.\n   */\n  const invalidCallsApply = !Array.isArray(value);\n  const answeredIds = invalidCallsApply\n    ? getToolResultIds(messages)\n    : undefined;\n  for (let i = messages.length - 1; i >= 0; i--) {\n    if (getMessageRole(messages[i]) !== 'assistant') {\n      continue;\n    }\n    const calls = [\n      ...getMessageToolCalls(messages[i]),\n      ...(invalidCallsApply && getSerializedMessageId(messages[i]) != null\n        ? getMessageInvalidToolCalls(messages[i], answeredIds!)\n        : []),\n    ];\n    if (calls.length > 0) {\n      return calls;\n    }\n  }\n  return [];\n}\n\nfunction getRootSpanParentId(span: ReadableSpan): string | undefined {\n  const legacyParent = (span as { parentSpanId?: string }).parentSpanId;\n  if (typeof legacyParent === 'string' && legacyParent !== '') {\n    return legacyParent;\n  }\n  const parentContext = (span as { parentSpanContext?: { spanId?: string } })\n    .parentSpanContext;\n  const spanId = parentContext?.spanId;\n  return typeof spanId === 'string' && spanId !== '' ? spanId : undefined;\n}\n\nfunction isRootSpan(span: ReadableSpan): boolean {\n  return getRootSpanParentId(span) == null;\n}\n\n/**\n * LangGraph plumbing observations that add noise without information:\n * the duplicated `__start__` channel-seed nodes and anonymous\n * `RunnableLambda` pass-throughs (Langfuse team feedback items 4 & 5).\n * Internal ToolNode batch spans are disabled at their source so traced child\n * tools retain an exported parent. Explicitly traced ToolNodes are preserved.\n */\nexport function shouldDropLangfuseSpan(spanName: string): boolean {\n  return (\n    spanName === LANGGRAPH_START_NODE || spanName === ANONYMOUS_LAMBDA_NAME\n  );\n}\n\nfunction shapeToolNodeSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  span.name = TOOL_DISPATCH_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    CHAIN_OBSERVATION_TYPE;\n  const calls = findPendingToolCalls(\n    parseAttributeValue(span.attributes[inputKey])\n  );\n  if (calls.length === 0) {\n    return;\n  }\n  span.attributes[inputKey] = JSON.stringify(\n    calls.map(({ name, args }) => ({ name, args }))\n  );\n}\n\nfunction shapeAgentNodeSpan(span: MutableSpan): void {\n  span.name = AGENT_NODE_SPAN_NAME;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    ROOT_OBSERVATION_TYPE;\n}\n\nfunction shapeRootSpan(span: MutableSpan): void {\n  const inputKey = LangfuseOtelSpanAttributes.OBSERVATION_INPUT;\n  const outputKey = LangfuseOtelSpanAttributes.OBSERVATION_OUTPUT;\n  const question = findLastMessageText(\n    parseAttributeValue(span.attributes[inputKey]),\n    'user'\n  );\n  const answer = findLastMessageText(\n    parseAttributeValue(span.attributes[outputKey]),\n    'assistant'\n  );\n  /** A generation that IS the trace root — a bare `model.invoke` with no\n   *  wrapping chain, i.e. the activity-label path — is also the only\n   *  observation carrying its own prompt: reducing its observation input\n   *  would discard the SystemMessage from the one place it is traced.\n   *  Chain/agent roots keep the full reduction; their child generations\n   *  still record the complete prompt. Trace-level input/output reduce\n   *  either way, so the trace list keeps showing question and answer. */\n  if (!isGenerationSpan(span)) {\n    if (question != null) {\n      span.attributes[inputKey] = question;\n    }\n    if (answer != null) {\n      span.attributes[outputKey] = answer;\n    }\n  }\n  const traceInput = question ?? span.attributes[inputKey];\n  const traceOutput = answer ?? span.attributes[outputKey];\n  if (traceInput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_INPUT] = traceInput;\n  }\n  if (traceOutput != null) {\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_OUTPUT] = traceOutput;\n  }\n}\n\nfunction isGenerationSpan(span: MutableSpan): boolean {\n  const type = span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE];\n  return typeof type === 'string' && type.toLowerCase() === 'generation';\n}\n\nfunction isToolSpan(span: MutableSpan): boolean {\n  const type = span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE];\n  return (\n    typeof type === 'string' && type.toLowerCase() === TOOL_OBSERVATION_TYPE\n  );\n}\n\n/**\n * Whether the span is a LangGraph node execution whose node id is the span\n * name — the shape of the outer workflow-agent node. `@langfuse/tracing`\n * flattens object metadata to per-key attributes with string values stored\n * raw, so LangGraph's `langgraph_node` arrives directly comparable.\n */\nfunction isWorkflowNodeSpan(span: MutableSpan): boolean {\n  return span.attributes[OBSERVATION_METADATA_LANGGRAPH_NODE] === span.name;\n}\n\n/**\n * LibreChat ephemeral agents are identified as\n * `endpoint__model___sender[____index]` (`__` encodes `:`; see LibreChat's\n * `encodeEphemeralAgentId`), and the outer workflow node carries that id as\n * its span name — so switching models renames the span (item 1). Returns the\n * stable human `sender` segment only when the name matches that encoding:\n * the `endpoint__model` prefix must contain both segments and — unlike\n * display names such as `LibreChat Agent: Ops___EU` — never contains\n * whitespace, so legitimate names that merely embed `___` are left alone.\n */\nfunction extractEphemeralAgentSender(name: string): string | undefined {\n  let workingId = name;\n  const indexSeparator = workingId.lastIndexOf(EPHEMERAL_AGENT_INDEX_SEPARATOR);\n  if (\n    indexSeparator !== -1 &&\n    /^\\d+$/.test(\n      workingId.slice(indexSeparator + EPHEMERAL_AGENT_INDEX_SEPARATOR.length)\n    )\n  ) {\n    workingId = workingId.slice(0, indexSeparator);\n  }\n  const senderSeparator = workingId.indexOf(EPHEMERAL_AGENT_SENDER_SEPARATOR);\n  if (senderSeparator <= 0) {\n    return undefined;\n  }\n  const encodedPrefix = workingId.slice(0, senderSeparator);\n  if (/\\s/.test(encodedPrefix)) {\n    return undefined;\n  }\n  const prefixParts = encodedPrefix.split('__');\n  if (prefixParts.length < 2 || prefixParts.some((part) => part === '')) {\n    return undefined;\n  }\n  const sender = workingId\n    .slice(senderSeparator + EPHEMERAL_AGENT_SENDER_SEPARATOR.length)\n    .replace(/__/g, ':');\n  return sender === '' ? undefined : sender;\n}\n\n/** Workflow-agent node spans are always children of the run's root chain and\n *  always carry `langgraph_node` metadata equal to their name, so host-named\n *  run roots (`LibreChat Agent: <name>`) and ordinary chains that merely look\n *  like encoded ids (`pipeline__stage___EU`) are never rename candidates.\n *  Successful decodes become `agent` observations, matching the inner\n *  `agent=<id>` node shaping. */\nfunction shapeEphemeralAgentNodeSpan(span: MutableSpan): void {\n  if (isToolSpan(span) || isRootSpan(span) || !isWorkflowNodeSpan(span)) {\n    return;\n  }\n  const sender = extractEphemeralAgentSender(span.name);\n  if (sender == null) {\n    return;\n  }\n  span.name = sender;\n  span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n    ROOT_OBSERVATION_TYPE;\n}\n\nfunction hasTraceTag(span: MutableSpan, expectedTag: string): boolean {\n  const tags = parseAttributeValue(\n    span.attributes[LangfuseOtelSpanAttributes.TRACE_TAGS]\n  );\n  return (\n    Array.isArray(tags) &&\n    tags.some((tag) => typeof tag === 'string' && tag === expectedTag)\n  );\n}\n\nfunction shapeRootObservationType(span: MutableSpan): void {\n  if (isGenerationSpan(span)) {\n    return;\n  }\n  if (hasTraceTag(span, AGENT_TRACE_TAG)) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      ROOT_OBSERVATION_TYPE;\n    return;\n  }\n  if (hasTraceTag(span, TITLE_TRACE_TAG)) {\n    span.attributes[LangfuseOtelSpanAttributes.OBSERVATION_TYPE] =\n      CHAIN_OBSERVATION_TYPE;\n  }\n}\n\n/**\n * Reshapes spans per Langfuse-team feedback before export:\n * - `agent=<id>` / `tools=<id>` node names carry the ephemeral agent id\n *   (`provider__model`) — strip it so switching models doesn't break\n *   name-based logic (item 1). The outer workflow node is named with the\n *   bare agent id; ephemeral ids reduce to their stable sender name.\n * - LLM generation spans keep the provider client class name (`ChatOpenAI`,\n *   `AzureChatOpenAI`, …); rename them to a provider-agnostic `llm` so the\n *   name reflects the operation, not the model (the model stays on the\n *   generation's model attribute).\n * - Agent nodes become `agent` observations, while tool-dispatch nodes become\n *   stable `chain` observations whose input is scoped to the pending calls.\n *   Individual child calls remain `tool` observations (items 3 & 4).\n * - Agent trace roots become `agent` observations and title trace roots become\n *   `chain` observations. Root and trace input/output are reduced to the user\n *   question and assistant response when chat messages are available (item 2).\n */\nexport function shapeLangfuseSpan(span: ReadableSpan): void {\n  const mutable = span as MutableSpan;\n  if (mutable.name.startsWith(LANGGRAPH_AGENT_NODE_PREFIX)) {\n    shapeAgentNodeSpan(mutable);\n  } else if (mutable.name.startsWith(LANGGRAPH_TOOL_NODE_PREFIX)) {\n    shapeToolNodeSpan(mutable);\n  } else if (isGenerationSpan(mutable)) {\n    mutable.name = GENERATION_SPAN_NAME;\n  } else {\n    shapeEphemeralAgentNodeSpan(mutable);\n  }\n  if (!isRootSpan(span)) {\n    return;\n  }\n  shapeRootObservationType(mutable);\n  shapeRootSpan(mutable);\n}\n"],"mappings":"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"}

package/dist/cjs/llm/anthropic/utils/message_inputs.cjs

@@ -178,6 +178,29 @@ function _ensureMessageContents(messages) {
 	else updatedMsgs.push(message);
 	return updatedMsgs;
 }
+/**
+* Anthropic requires `tool_use.input` to be a JSON object; anything else is
+* rejected with a 400 (`tool_use.input: Input should be an object`).
+* History can carry non-object inputs: streaming leaves the raw partial-JSON
+* string on the content block, and upstream context projections can leave
+* `null` (observed live on a summarization-retained tool call replayed after
+* compaction). A string is parsed when it forms complete JSON; every other
+* shape degrades to `{}` — the call already executed, so the replayed input
+* is informational and an empty object is the safe representation.
+*/
+/** True for `{}` — no own enumerable keys on a non-array, non-null object. */
+function isEmptyPlainObject(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) && Object.keys(value).length === 0;
+}
+function coerceAnthropicToolUseInput(input) {
+	let candidate = input;
+	if (typeof candidate === "string") try {
+		candidate = JSON.parse(candidate);
+	} catch {
+		return {};
+	}
+	return typeof candidate === "object" && candidate !== null && !Array.isArray(candidate) ? candidate : {};
+}
 function _convertLangChainToolCallToAnthropic(toolCall) {
 	if (toolCall.id === void 0) throw new Error("Anthropic requires all tool calls to have an \"id\".");
 	const isServerTool = toolCall.id.startsWith("srvtoolu_");
@@ -185,7 +208,7 @@ function _convertLangChainToolCallToAnthropic(toolCall) {
 		type: isServerTool ? "server_tool_use" : "tool_use",
 		id: isServerTool ? toolCall.id : normalizeAnthropicToolCallId(toolCall.id),
 		name: toolCall.name,
-		input: toolCall.args
+		input: coerceAnthropicToolUseInput(toolCall.args)
 	};
 }
 const standardContentBlockConverter = {
@@ -344,17 +367,11 @@ function _formatContent(message) {
 			*/
 			if ("id" in contentPart && typeof contentPart.id === "string" && contentPart.id.startsWith("srvtoolu_") && "name" in contentPart) {
 				const rawPart = contentPart;
-				let input = rawPart.input ?? rawPart.args;
-				if (typeof input === "string") try {
-					input = JSON.parse(input);
-				} catch {
-					input = {};
-				}
 				return {
 					type: "server_tool_use",
 					id: rawPart.id,
 					name: rawPart.name ?? "web_search",
-					input: input ?? {}
+					input: coerceAnthropicToolUseInput(rawPart.input ?? rawPart.args)
 				};
 			}
 			/**
@@ -468,7 +485,7 @@ function _formatContent(message) {
 				if ("index" in contentPartCopy) delete contentPartCopy.index;
 				if (contentPartCopy.type === "input_json_delta") return null;
 				if (contentPartCopy.type === "tool_use" && "id" in contentPartCopy && typeof contentPartCopy.id === "string" && contentPartCopy.id.startsWith("srvtoolu_")) contentPartCopy.type = "server_tool_use";
-				if (contentPartCopy.type === "tool_use" && typeof contentPartCopy.id === "string" && (contentPartCopy.input === "" || contentPartCopy.input == null)) {
+				if (contentPartCopy.type === "tool_use" && typeof contentPartCopy.id === "string" && (contentPartCopy.input === "" || contentPartCopy.input == null || isEmptyPlainObject(contentPartCopy.input))) {
 					const matchingToolCall = (0, _langchain_core_messages.isAIMessage)(message) ? message.tool_calls?.find((toolCall) => toolCall.id === contentPartCopy.id) : void 0;
 					if (matchingToolCall) contentPartCopy.input = matchingToolCall.args;
 					else {
@@ -480,12 +497,19 @@ function _formatContent(message) {
 						if (merged !== "") contentPartCopy.input = merged;
 					}
 				}
-				if ("input" in contentPartCopy) {
-					if (typeof contentPartCopy.input === "string") try {
-						contentPartCopy.input = JSON.parse(contentPartCopy.input);
-					} catch {
-						contentPartCopy.input = {};
-					}
+				if (contentPartCopy.type === "tool_use" || contentPartCopy.type === "server_tool_use")
+ /**
+				* The API requires `input` to be a JSON object. Streaming leaves the
+				* raw partial-JSON string here, and context-pressure truncation can
+				* leave `null` on BOTH the block and its `tool_calls` mirror — so
+				* the restore above may itself restore a non-object. Coerce last,
+				* after every restore path has run.
+				*/
+				contentPartCopy.input = coerceAnthropicToolUseInput("input" in contentPartCopy ? contentPartCopy.input : void 0);
+				else if ("input" in contentPartCopy && typeof contentPartCopy.input === "string") try {
+					contentPartCopy.input = JSON.parse(contentPartCopy.input);
+				} catch {
+					contentPartCopy.input = {};
 				}
 				/**
 				* For multi-turn conversations with citations, we must preserve ALL blocks