@mastra/langsmith 1.3.5 → 1.3.6

package/dist/index.cjs

@@ -1,380 +1,358 @@
-'use strict';
-
-var observability$1 = require('@mastra/core/observability');
-var utils = require('@mastra/core/utils');
-var observability = require('@mastra/observability');
-var langsmith = require('langsmith');
-
-// src/tracing.ts
-
-// src/metrics.ts
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let _mastra_core_observability = require("@mastra/core/observability");
+let _mastra_core_utils = require("@mastra/core/utils");
+let _mastra_observability = require("@mastra/observability");
+let langsmith = require("langsmith");
+//#region src/metrics.ts
+/**
+* Formats UsageStats to LangSmith's expected metric format.
+*/
 function formatUsageMetrics(usage) {
-  const metrics = {};
-  if (usage?.inputTokens !== void 0) {
-    metrics.input_tokens = usage.inputTokens;
-  }
-  if (usage?.outputTokens !== void 0) {
-    metrics.output_tokens = usage.outputTokens;
-  }
-  if (metrics.input_tokens !== void 0 && metrics.output_tokens !== void 0) {
-    metrics.total_tokens = metrics.input_tokens + metrics.output_tokens;
-  }
-  if (usage?.outputDetails?.reasoning !== void 0) {
-    metrics.output_token_details = {
-      ...metrics.output_token_details ?? {},
-      reasoning_tokens: usage.outputDetails.reasoning
-    };
-  }
-  if (usage?.inputDetails?.cacheRead !== void 0) {
-    metrics.input_token_details = {
-      ...metrics.input_token_details ?? {},
-      cache_read: usage.inputDetails.cacheRead
-    };
-  }
-  if (usage?.inputDetails?.cacheWrite !== void 0) {
-    metrics.input_token_details = {
-      ...metrics.input_token_details ?? {},
-      cache_write: usage.inputDetails.cacheWrite
-    };
-  }
-  if (usage?.inputDetails?.audio !== void 0) {
-    metrics.input_token_details = {
-      ...metrics.input_token_details ?? {},
-      audio: usage.inputDetails.audio
-    };
-  }
-  if (usage?.outputDetails?.audio !== void 0) {
-    metrics.output_token_details = {
-      ...metrics.output_token_details ?? {},
-      audio: usage.outputDetails.audio
-    };
-  }
-  return metrics;
+	const metrics = {};
+	if (usage?.inputTokens !== void 0) metrics.input_tokens = usage.inputTokens;
+	if (usage?.outputTokens !== void 0) metrics.output_tokens = usage.outputTokens;
+	if (metrics.input_tokens !== void 0 && metrics.output_tokens !== void 0) metrics.total_tokens = metrics.input_tokens + metrics.output_tokens;
+	if (usage?.outputDetails?.reasoning !== void 0) metrics.output_token_details = {
+		...metrics.output_token_details ?? {},
+		reasoning_tokens: usage.outputDetails.reasoning
+	};
+	if (usage?.inputDetails?.cacheRead !== void 0) metrics.input_token_details = {
+		...metrics.input_token_details ?? {},
+		cache_read: usage.inputDetails.cacheRead
+	};
+	if (usage?.inputDetails?.cacheWrite !== void 0) metrics.input_token_details = {
+		...metrics.input_token_details ?? {},
+		cache_write: usage.inputDetails.cacheWrite
+	};
+	if (usage?.inputDetails?.audio !== void 0) metrics.input_token_details = {
+		...metrics.input_token_details ?? {},
+		audio: usage.inputDetails.audio
+	};
+	if (usage?.outputDetails?.audio !== void 0) metrics.output_token_details = {
+		...metrics.output_token_details ?? {},
+		audio: usage.outputDetails.audio
+	};
+	return metrics;
 }
-
-// src/tracing.ts
-var DEFAULT_RUN_ID_CACHE_MAX_ENTRIES = 1e4;
-var DEFAULT_SPAN_TYPE = "chain";
-var SPAN_TYPE_EXCEPTIONS = {
-  [observability$1.SpanType.MODEL_GENERATION]: "llm",
-  [observability$1.SpanType.TOOL_CALL]: "tool",
-  [observability$1.SpanType.MCP_TOOL_CALL]: "tool",
-  [observability$1.SpanType.PROVIDER_TOOL_CALL]: "tool",
-  [observability$1.SpanType.WORKFLOW_CONDITIONAL_EVAL]: "chain",
-  [observability$1.SpanType.WORKFLOW_WAIT_EVENT]: "chain"
+//#endregion
+//#region src/tracing.ts
+const DEFAULT_RUN_ID_CACHE_MAX_ENTRIES = 1e4;
+const DEFAULT_SPAN_TYPE = "chain";
+const SPAN_TYPE_EXCEPTIONS = {
+	[_mastra_core_observability.SpanType.MODEL_GENERATION]: "llm",
+	[_mastra_core_observability.SpanType.TOOL_CALL]: "tool",
+	[_mastra_core_observability.SpanType.MCP_TOOL_CALL]: "tool",
+	[_mastra_core_observability.SpanType.PROVIDER_TOOL_CALL]: "tool",
+	[_mastra_core_observability.SpanType.WORKFLOW_CONDITIONAL_EVAL]: "chain",
+	[_mastra_core_observability.SpanType.WORKFLOW_WAIT_EVENT]: "chain"
 };
 function mapSpanType(spanType) {
-  return SPAN_TYPE_EXCEPTIONS[spanType] ?? DEFAULT_SPAN_TYPE;
+	return SPAN_TYPE_EXCEPTIONS[spanType] ?? DEFAULT_SPAN_TYPE;
 }
 function isKVMap(value) {
-  return value != null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
+	return value != null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date);
 }
-var LangSmithExporter = class extends observability.TrackingExporter {
-  name = "langsmith";
-  #client;
-  /**
-   * Maps Mastra `span.id` to the runId LangSmith allocated when the corresponding
-   * RunTree was created. LangSmith's `createFeedback` requires the LangSmith runId,
-   * not the Mastra span id, so scores submitted via `onScoreEvent` look up the
-   * LangSmith runId here before calling the API.
-   *
-   * Bounded LRU keyed by Mastra span id — entries are evicted oldest-first when
-   * size exceeds `#runIdCacheMaxEntries` so the cache cannot grow without bound.
-   */
-  #langsmithRunIdBySpanId = /* @__PURE__ */ new Map();
-  #runIdCacheMaxEntries;
-  constructor(config = {}) {
-    const apiKey = config.apiKey ?? process.env.LANGSMITH_API_KEY;
-    super({
-      ...config,
-      apiKey
-    });
-    this.#runIdCacheMaxEntries = Math.max(1, config.runIdCacheMaxEntries ?? DEFAULT_RUN_ID_CACHE_MAX_ENTRIES);
-    if (!apiKey) {
-      this.setDisabled(`Missing required credentials (apiKey: ${!!apiKey})`);
-      return;
-    }
-    this.#client = config.client ?? new langsmith.Client(this.config);
-  }
-  /** Look up the LangSmith runId for a Mastra span id, refreshing its LRU position on hit. */
-  #getLangsmithRunId(spanId) {
-    const runId = this.#langsmithRunIdBySpanId.get(spanId);
-    if (runId === void 0) return void 0;
-    this.#langsmithRunIdBySpanId.delete(spanId);
-    this.#langsmithRunIdBySpanId.set(spanId, runId);
-    return runId;
-  }
-  /** Remember the LangSmith runId for a Mastra span id, evicting oldest entries when full. */
-  #rememberLangsmithRunId(spanId, runId) {
-    if (this.#langsmithRunIdBySpanId.has(spanId)) {
-      this.#langsmithRunIdBySpanId.delete(spanId);
-    }
-    this.#langsmithRunIdBySpanId.set(spanId, runId);
-    while (this.#langsmithRunIdBySpanId.size > this.#runIdCacheMaxEntries) {
-      const oldest = this.#langsmithRunIdBySpanId.keys().next().value;
-      if (oldest === void 0) break;
-      this.#langsmithRunIdBySpanId.delete(oldest);
-    }
-  }
-  /**
-   * Flush pending trace batches to LangSmith.
-   * The LangSmith Client internally batches API calls; this ensures
-   * all queued runs are sent before the process exits or the flush
-   * caller continues.
-   */
-  async _flush() {
-    if (this.#client) {
-      await this.#client.awaitPendingTraceBatches();
-    }
-  }
-  async _postShutdown() {
-    this.#langsmithRunIdBySpanId.clear();
-  }
-  async onScoreEvent(event) {
-    if (!this.#client) return;
-    const { score } = event;
-    if (!score.spanId) {
-      this.logger.warn("LangSmith exporter: dropping score with no spanId; trace-level scoring is not yet supported", {
-        scorerId: score.scorerId
-      });
-      return;
-    }
-    const langsmithRunId = this.#getLangsmithRunId(score.spanId);
-    if (!langsmithRunId) {
-      this.logger.warn(
-        "LangSmith exporter: dropping score for a span that was not previously emitted to LangSmith (span_started must be processed before submitting a score for it)",
-        {
-          traceId: score.traceId,
-          spanId: score.spanId,
-          scorerId: score.scorerId
-        }
-      );
-      return;
-    }
-    const key = score.scorerName ?? score.scorerId;
-    try {
-      await this.#client.createFeedback(langsmithRunId, key, {
-        score: score.score,
-        ...score.reason ? { comment: score.reason } : {},
-        feedbackId: score.scoreId,
-        ...score.scoreTraceId ? { sourceRunId: score.scoreTraceId } : {},
-        sourceInfo: {
-          // User-supplied metadata is spread first so the authoritative reserved
-          // fields below cannot be overwritten by `scorerId` / `scoreSource` keys
-          // a caller may have set inside metadata.
-          ...score.metadata ?? {},
-          scorerId: score.scorerId,
-          ...score.scoreSource ? { scoreSource: score.scoreSource } : {}
-        }
-      });
-    } catch (err) {
-      this.logger.error("LangSmith exporter: Failed to submit feedback", {
-        error: err,
-        traceId: score.traceId,
-        spanId: score.spanId,
-        scorerId: score.scorerId
-      });
-    }
-  }
-  skipBuildRootTask = true;
-  async _buildRoot(_args) {
-    throw new Error("Method not implemented.");
-  }
-  async _buildSpan(args) {
-    const { span, traceData } = args;
-    const parent = span.isRootSpan ? void 0 : traceData.getParent(args);
-    if (!span.isRootSpan && !parent) {
-      return;
-    }
-    const payload = {
-      name: span.name,
-      ...this.buildRunTreePayload(span, traceData, true)
-    };
-    const langSmithSpan = span.isRootSpan ? new langsmith.RunTree(payload) : parent.createChild(payload);
-    if (langSmithSpan.id) {
-      this.#rememberLangsmithRunId(span.id, langSmithSpan.id);
-    }
-    await langSmithSpan.postRun();
-    return langSmithSpan;
-  }
-  async _buildEvent(args) {
-    const langSmithSpan = await this._buildSpan(args);
-    if (!langSmithSpan) {
-      return;
-    }
-    await langSmithSpan.end({ endTime: args.span.startTime.getTime() });
-    await langSmithSpan.patchRun();
-    return langSmithSpan;
-  }
-  async _updateSpan(args) {
-    await this.handleSpanUpdateOrEnd({ ...args, isEnd: false });
-  }
-  async _finishSpan(args) {
-    await this.handleSpanUpdateOrEnd({ ...args, isEnd: true });
-  }
-  async _abortSpan(args) {
-    const { span, reason } = args;
-    span.error = reason.message;
-    span.metadata = {
-      ...span.metadata,
-      errorDetails: reason
-    };
-    await span.end();
-    await span.patchRun();
-  }
-  async handleSpanUpdateOrEnd(args) {
-    const { span, traceData, isEnd } = args;
-    const langSmithSpan = traceData.getSpan({ spanId: span.id });
-    if (!langSmithSpan) {
-      return;
-    }
-    const updatePayload = this.buildRunTreePayload(span, traceData);
-    langSmithSpan.metadata = {
-      ...langSmithSpan.metadata,
-      ...updatePayload.metadata
-    };
-    if (updatePayload.inputs != null) {
-      langSmithSpan.inputs = updatePayload.inputs;
-    }
-    if (updatePayload.outputs != null) {
-      langSmithSpan.outputs = updatePayload.outputs;
-    }
-    if (updatePayload.error != null) {
-      langSmithSpan.error = updatePayload.error;
-    }
-    if (span.type === observability$1.SpanType.MODEL_GENERATION) {
-      const modelAttr = span.attributes ?? {};
-      if (modelAttr.completionStartTime !== void 0) {
-        langSmithSpan.addEvent({
-          name: "new_token",
-          time: modelAttr.completionStartTime.toISOString()
-        });
-      }
-    }
-    if (isEnd) {
-      if (span.endTime) {
-        await langSmithSpan.end({ endTime: span.endTime.getTime() });
-      } else {
-        await langSmithSpan.end();
-      }
-    }
-    await langSmithSpan.patchRun();
-  }
-  /**
-   * Find LangSmith vendor metadata by walking up the span hierarchy and merging.
-   * Metadata is merged from ancestors with child values taking precedence over parent values.
-   *
-   * TODO(2.0): Extract shared `findVendorMetadata()` to base TrackingExporter class
-   * and reuse here and in LangfuseExporter.findLangfusePrompt()
-   */
-  findLangsmithMetadata(traceData, span) {
-    const metadataChain = [];
-    let currentSpanId = span.id;
-    while (currentSpanId) {
-      const providerMetadata = traceData.getMetadata({ spanId: currentSpanId });
-      if (providerMetadata) {
-        metadataChain.push(providerMetadata);
-      }
-      currentSpanId = traceData.getParentId({ spanId: currentSpanId });
-    }
-    if (metadataChain.length === 0) {
-      return void 0;
-    }
-    const merged = {};
-    for (let i = metadataChain.length - 1; i >= 0; i--) {
-      const meta = metadataChain[i];
-      if (meta.projectName !== void 0) merged.projectName = meta.projectName;
-      if (meta.sessionId !== void 0) merged.sessionId = meta.sessionId;
-      if (meta.sessionName !== void 0) merged.sessionName = meta.sessionName;
-    }
-    this.logger.debug(`${this.name}: merged vendor metadata from hierarchy`, {
-      traceId: span.traceId,
-      spanId: span.id,
-      metadataKeys: Object.keys(merged),
-      ancestorCount: metadataChain.length
-    });
-    return merged;
-  }
-  buildRunTreePayload(span, traceData, isNew = false) {
-    const vendorMetadata = this.findLangsmithMetadata(traceData, span);
-    const spanMetadata = span.metadata ? utils.omitKeys(span.metadata, ["langsmith"]) : {};
-    const payload = {
-      client: this.#client,
-      metadata: {
-        mastra_span_type: span.type,
-        ...spanMetadata
-      }
-    };
-    if (isNew) {
-      payload.run_type = mapSpanType(span.type);
-      payload.start_time = span.startTime.getTime();
-    }
-    const projectName = vendorMetadata?.projectName ?? this.config.projectName;
-    if (projectName) {
-      payload.project_name = projectName;
-    }
-    if (vendorMetadata?.sessionId) {
-      payload.metadata.session_id = vendorMetadata.sessionId;
-    }
-    if (vendorMetadata?.sessionName) {
-      payload.metadata.session_name = vendorMetadata.sessionName;
-    }
-    if (span.isRootSpan && span.tags?.length) {
-      payload.tags = span.tags;
-    }
-    if (span.input !== void 0) {
-      payload.inputs = isKVMap(span.input) ? span.input : { input: span.input };
-    }
-    if (span.output !== void 0) {
-      payload.outputs = isKVMap(span.output) ? span.output : { output: span.output };
-    }
-    const attributes = span.attributes ?? {};
-    if (span.type === observability$1.SpanType.MODEL_GENERATION) {
-      const modelAttr = attributes;
-      if (modelAttr.model !== void 0) {
-        payload.metadata.ls_model_name = modelAttr.model;
-      }
-      if (modelAttr.provider !== void 0) {
-        payload.metadata.ls_provider = modelAttr.provider;
-      }
-      payload.metadata.usage_metadata = formatUsageMetrics(modelAttr.usage);
-      if (modelAttr.parameters !== void 0) {
-        payload.metadata.modelParameters = modelAttr.parameters;
-      }
-      const otherAttributes = utils.omitKeys(attributes, ["model", "provider", "usage", "parameters", "completionStartTime"]);
-      payload.metadata = {
-        ...payload.metadata,
-        ...otherAttributes
-      };
-    } else {
-      payload.metadata = {
-        ...payload.metadata,
-        ...attributes
-      };
-    }
-    if (span.errorInfo) {
-      payload.error = span.errorInfo.message;
-      payload.metadata.errorDetails = span.errorInfo;
-    }
-    return payload;
-  }
+var LangSmithExporter = class extends _mastra_observability.TrackingExporter {
+	name = "langsmith";
+	#client;
+	/**
+	* Maps Mastra `span.id` to the runId LangSmith allocated when the corresponding
+	* RunTree was created. LangSmith's `createFeedback` requires the LangSmith runId,
+	* not the Mastra span id, so scores submitted via `onScoreEvent` look up the
+	* LangSmith runId here before calling the API.
+	*
+	* Bounded LRU keyed by Mastra span id — entries are evicted oldest-first when
+	* size exceeds `#runIdCacheMaxEntries` so the cache cannot grow without bound.
+	*/
+	#langsmithRunIdBySpanId = /* @__PURE__ */ new Map();
+	#runIdCacheMaxEntries;
+	constructor(config = {}) {
+		const apiKey = config.apiKey ?? process.env.LANGSMITH_API_KEY;
+		super({
+			...config,
+			apiKey
+		});
+		this.#runIdCacheMaxEntries = Math.max(1, config.runIdCacheMaxEntries ?? DEFAULT_RUN_ID_CACHE_MAX_ENTRIES);
+		if (!apiKey) {
+			this.setDisabled(`Missing required credentials (apiKey: ${!!apiKey})`);
+			return;
+		}
+		this.#client = config.client ?? new langsmith.Client(this.config);
+	}
+	/** Look up the LangSmith runId for a Mastra span id, refreshing its LRU position on hit. */
+	#getLangsmithRunId(spanId) {
+		const runId = this.#langsmithRunIdBySpanId.get(spanId);
+		if (runId === void 0) return void 0;
+		this.#langsmithRunIdBySpanId.delete(spanId);
+		this.#langsmithRunIdBySpanId.set(spanId, runId);
+		return runId;
+	}
+	/** Remember the LangSmith runId for a Mastra span id, evicting oldest entries when full. */
+	#rememberLangsmithRunId(spanId, runId) {
+		if (this.#langsmithRunIdBySpanId.has(spanId)) this.#langsmithRunIdBySpanId.delete(spanId);
+		this.#langsmithRunIdBySpanId.set(spanId, runId);
+		while (this.#langsmithRunIdBySpanId.size > this.#runIdCacheMaxEntries) {
+			const oldest = this.#langsmithRunIdBySpanId.keys().next().value;
+			if (oldest === void 0) break;
+			this.#langsmithRunIdBySpanId.delete(oldest);
+		}
+	}
+	/**
+	* Flush pending trace batches to LangSmith.
+	* The LangSmith Client internally batches API calls; this ensures
+	* all queued runs are sent before the process exits or the flush
+	* caller continues.
+	*/
+	async _flush() {
+		if (this.#client) await this.#client.awaitPendingTraceBatches();
+	}
+	async _postShutdown() {
+		this.#langsmithRunIdBySpanId.clear();
+	}
+	async onScoreEvent(event) {
+		if (!this.#client) return;
+		const { score } = event;
+		if (!score.spanId) {
+			this.logger.warn("LangSmith exporter: dropping score with no spanId; trace-level scoring is not yet supported", { scorerId: score.scorerId });
+			return;
+		}
+		const langsmithRunId = this.#getLangsmithRunId(score.spanId);
+		if (!langsmithRunId) {
+			this.logger.warn("LangSmith exporter: dropping score for a span that was not previously emitted to LangSmith (span_started must be processed before submitting a score for it)", {
+				traceId: score.traceId,
+				spanId: score.spanId,
+				scorerId: score.scorerId
+			});
+			return;
+		}
+		const key = score.scorerName ?? score.scorerId;
+		try {
+			await this.#client.createFeedback(langsmithRunId, key, {
+				score: score.score,
+				...score.reason ? { comment: score.reason } : {},
+				feedbackId: score.scoreId,
+				...score.scoreTraceId ? { sourceRunId: score.scoreTraceId } : {},
+				sourceInfo: {
+					...score.metadata ?? {},
+					scorerId: score.scorerId,
+					...score.scoreSource ? { scoreSource: score.scoreSource } : {}
+				}
+			});
+		} catch (err) {
+			this.logger.error("LangSmith exporter: Failed to submit feedback", {
+				error: err,
+				traceId: score.traceId,
+				spanId: score.spanId,
+				scorerId: score.scorerId
+			});
+		}
+	}
+	skipBuildRootTask = true;
+	async _buildRoot(_args) {
+		throw new Error("Method not implemented.");
+	}
+	async _buildSpan(args) {
+		const { span, traceData } = args;
+		const parent = span.isRootSpan ? void 0 : traceData.getParent(args);
+		if (!span.isRootSpan && !parent) return;
+		const payload = {
+			name: span.name,
+			...this.buildRunTreePayload(span, traceData, true)
+		};
+		const langSmithSpan = span.isRootSpan ? new langsmith.RunTree(payload) : parent.createChild(payload);
+		if (langSmithSpan.id) this.#rememberLangsmithRunId(span.id, langSmithSpan.id);
+		await langSmithSpan.postRun();
+		return langSmithSpan;
+	}
+	async _buildEvent(args) {
+		const langSmithSpan = await this._buildSpan(args);
+		if (!langSmithSpan) return;
+		await langSmithSpan.end({ endTime: args.span.startTime.getTime() });
+		await langSmithSpan.patchRun();
+		return langSmithSpan;
+	}
+	async _updateSpan(args) {
+		await this.handleSpanUpdateOrEnd({
+			...args,
+			isEnd: false
+		});
+	}
+	async _finishSpan(args) {
+		await this.handleSpanUpdateOrEnd({
+			...args,
+			isEnd: true
+		});
+	}
+	async _abortSpan(args) {
+		const { span, reason } = args;
+		span.error = reason.message;
+		span.metadata = {
+			...span.metadata,
+			errorDetails: reason
+		};
+		await span.end();
+		await span.patchRun();
+	}
+	async handleSpanUpdateOrEnd(args) {
+		const { span, traceData, isEnd } = args;
+		const langSmithSpan = traceData.getSpan({ spanId: span.id });
+		if (!langSmithSpan) return;
+		const updatePayload = this.buildRunTreePayload(span, traceData);
+		langSmithSpan.metadata = {
+			...langSmithSpan.metadata,
+			...updatePayload.metadata
+		};
+		if (updatePayload.inputs != null) langSmithSpan.inputs = updatePayload.inputs;
+		if (updatePayload.outputs != null) langSmithSpan.outputs = updatePayload.outputs;
+		if (updatePayload.error != null) langSmithSpan.error = updatePayload.error;
+		if (span.type === _mastra_core_observability.SpanType.MODEL_GENERATION) {
+			const modelAttr = span.attributes ?? {};
+			if (modelAttr.completionStartTime !== void 0) langSmithSpan.addEvent({
+				name: "new_token",
+				time: modelAttr.completionStartTime.toISOString()
+			});
+		}
+		if (isEnd) if (span.endTime) await langSmithSpan.end({ endTime: span.endTime.getTime() });
+		else await langSmithSpan.end();
+		await langSmithSpan.patchRun();
+	}
+	/**
+	* Find LangSmith vendor metadata by walking up the span hierarchy and merging.
+	* Metadata is merged from ancestors with child values taking precedence over parent values.
+	*
+	* TODO(2.0): Extract shared `findVendorMetadata()` to base TrackingExporter class
+	* and reuse here and in LangfuseExporter.findLangfusePrompt()
+	*/
+	findLangsmithMetadata(traceData, span) {
+		const metadataChain = [];
+		let currentSpanId = span.id;
+		while (currentSpanId) {
+			const providerMetadata = traceData.getMetadata({ spanId: currentSpanId });
+			if (providerMetadata) metadataChain.push(providerMetadata);
+			currentSpanId = traceData.getParentId({ spanId: currentSpanId });
+		}
+		if (metadataChain.length === 0) return;
+		const merged = {};
+		for (let i = metadataChain.length - 1; i >= 0; i--) {
+			const meta = metadataChain[i];
+			if (meta.projectName !== void 0) merged.projectName = meta.projectName;
+			if (meta.sessionId !== void 0) merged.sessionId = meta.sessionId;
+			if (meta.sessionName !== void 0) merged.sessionName = meta.sessionName;
+		}
+		this.logger.debug(`${this.name}: merged vendor metadata from hierarchy`, {
+			traceId: span.traceId,
+			spanId: span.id,
+			metadataKeys: Object.keys(merged),
+			ancestorCount: metadataChain.length
+		});
+		return merged;
+	}
+	buildRunTreePayload(span, traceData, isNew = false) {
+		const vendorMetadata = this.findLangsmithMetadata(traceData, span);
+		const spanMetadata = span.metadata ? (0, _mastra_core_utils.omitKeys)(span.metadata, ["langsmith"]) : {};
+		const payload = {
+			client: this.#client,
+			metadata: {
+				mastra_span_type: span.type,
+				...spanMetadata
+			}
+		};
+		if (isNew) {
+			payload.run_type = mapSpanType(span.type);
+			payload.start_time = span.startTime.getTime();
+		}
+		const projectName = vendorMetadata?.projectName ?? this.config.projectName;
+		if (projectName) payload.project_name = projectName;
+		if (vendorMetadata?.sessionId) payload.metadata.session_id = vendorMetadata.sessionId;
+		if (vendorMetadata?.sessionName) payload.metadata.session_name = vendorMetadata.sessionName;
+		if (span.isRootSpan && span.tags?.length) payload.tags = span.tags;
+		if (span.input !== void 0) payload.inputs = isKVMap(span.input) ? span.input : { input: span.input };
+		if (span.output !== void 0) payload.outputs = isKVMap(span.output) ? span.output : { output: span.output };
+		const attributes = span.attributes ?? {};
+		if (span.type === _mastra_core_observability.SpanType.MODEL_GENERATION) {
+			const modelAttr = attributes;
+			if (modelAttr.model !== void 0) payload.metadata.ls_model_name = modelAttr.model;
+			if (modelAttr.provider !== void 0) payload.metadata.ls_provider = modelAttr.provider;
+			payload.metadata.usage_metadata = formatUsageMetrics(modelAttr.usage);
+			if (modelAttr.parameters !== void 0) payload.metadata.modelParameters = modelAttr.parameters;
+			const otherAttributes = (0, _mastra_core_utils.omitKeys)(attributes, [
+				"model",
+				"provider",
+				"usage",
+				"parameters",
+				"completionStartTime"
+			]);
+			payload.metadata = {
+				...payload.metadata,
+				...otherAttributes
+			};
+		} else payload.metadata = {
+			...payload.metadata,
+			...attributes
+		};
+		if (span.errorInfo) {
+			payload.error = span.errorInfo.message;
+			payload.metadata.errorDetails = span.errorInfo;
+		}
+		return payload;
+	}
 };
-
-// src/helpers.ts
+//#endregion
+//#region src/helpers.ts
+/**
+* Adds LangSmith metadata to the tracing options.
+*
+* The metadata is added under `metadata.langsmith` and allows you to:
+* - Route traces to different LangSmith projects via `projectName`
+* - Group traces by session via `sessionId` and `sessionName`
+*
+* @param metadata - The LangSmith metadata to add
+* @returns A TracingOptionsUpdater function for use with `buildTracingOptions`
+*
+* @example
+* ```typescript
+* import { buildTracingOptions } from '@mastra/observability';
+* import { withLangsmithMetadata } from '@mastra/langsmith';
+*
+* // Route traces to a specific project
+* const tracingOptions = buildTracingOptions(
+*   withLangsmithMetadata({ projectName: 'customer-support' }),
+* );
+*
+* // Or set multiple fields
+* const tracingOptions = buildTracingOptions(
+*   withLangsmithMetadata({
+*     projectName: 'my-project',
+*     sessionId: 'session-123',
+*   }),
+* );
+*
+* // Use in agent config
+* const agent = new Agent({
+*   name: 'support-agent',
+*   model: openai('gpt-4o'),
+*   defaultGenerateOptions: {
+*     tracingOptions: buildTracingOptions(
+*       withLangsmithMetadata({ projectName: 'support-traces' })
+*     ),
+*   },
+* });
+* ```
+*/
 function withLangsmithMetadata(metadata) {
-  return (opts) => ({
-    ...opts,
-    metadata: {
-      ...opts.metadata,
-      langsmith: {
-        ...opts.metadata?.langsmith,
-        ...metadata
-      }
-    }
-  });
+	return (opts) => ({
+		...opts,
+		metadata: {
+			...opts.metadata,
+			langsmith: {
+				...opts.metadata?.langsmith,
+				...metadata
+			}
+		}
+	});
 }
-
+//#endregion
 exports.LangSmithExporter = LangSmithExporter;
 exports.withLangsmithMetadata = withLangsmithMetadata;
-//# sourceMappingURL=index.cjs.map
+
 //# sourceMappingURL=index.cjs.map