langsmith 0.3.34 → 0.3.35-rc.0

package/dist/client.cjs

@@ -36,6 +36,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = exports.DEFAULT_BATCH_SIZE_LIMIT_BYTES = exports.AutoBatchQueue = void 0;
 exports.mergeRuntimeEnvIntoRunCreate = mergeRuntimeEnvIntoRunCreate;
 const uuid = __importStar(require("uuid"));
+const translator_js_1 = require("./experimental/otel/translator.cjs");
+const otel_js_1 = require("./singletons/otel.cjs");
 const async_caller_js_1 = require("./utils/async_caller.cjs");
 const messages_js_1 = require("./utils/messages.cjs");
 const env_js_1 = require("./utils/env.cjs");
@@ -149,6 +151,7 @@ class AutoBatchQueue {
         this.items.push({
             action: item.action,
             payload: item.item,
+            otelContext: item.otelContext,
             // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
             itemPromiseResolve: itemPromiseResolve,
             itemPromise,
@@ -182,7 +185,11 @@ class AutoBatchQueue {
             this.sizeBytes -= item.size;
         }
         return [
-            popped.map((it) => ({ action: it.action, item: it.payload })),
+            popped.map((it) => ({
+                action: it.action,
+                item: it.payload,
+                otelContext: it.otelContext,
+            })),
             () => popped.forEach((it) => it.itemPromiseResolve()),
         ];
     }
@@ -332,6 +339,12 @@ class Client {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "langSmithToOTELTranslator", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "debug", {
             enumerable: true,
             configurable: true,
@@ -377,6 +390,16 @@ class Client {
         this.batchSizeBytesLimit = config.batchSizeBytesLimit;
         this.fetchOptions = config.fetchOptions || {};
         this.manualFlushMode = config.manualFlushMode ?? this.manualFlushMode;
+        if ((0, env_js_1.getEnvironmentVariable)("OTEL_ENABLED") === "true") {
+            const otel_trace = (0, otel_js_1.getOTELTrace)();
+            const existingTracerProvider = otel_trace.getTracerProvider();
+            const { tracerProvider: langSmithTracerProvider } = (0, otel_js_1.getDefaultOTLPTracerComponents)() ?? {};
+            // If user has set global tracer before, this fails and returns false
+            const globalSuccessfullyOverridden = otel_trace.setGlobalTracerProvider(langSmithTracerProvider);
+            this.langSmithToOTELTranslator = new translator_js_1.LangSmithToOTELTranslator(globalSuccessfullyOverridden
+                ? langSmithTracerProvider
+                : existingTracerProvider);
+        }
     }
     static getDefaultClientConfig() {
         const apiKey = (0, env_js_1.getLangSmithEnvironmentVariable)("API_KEY");
@@ -618,26 +641,62 @@ class Client {
             return;
         }
         try {
-            const ingestParams = {
-                runCreates: batch
-                    .filter((item) => item.action === "create")
-                    .map((item) => item.item),
-                runUpdates: batch
-                    .filter((item) => item.action === "update")
-                    .map((item) => item.item),
-            };
-            const serverInfo = await this._ensureServerInfo();
-            if (serverInfo?.batch_ingest_config?.use_multipart_endpoint) {
-                await this.multipartIngestRuns(ingestParams);
+            if (this.langSmithToOTELTranslator !== undefined) {
+                this._sendBatchToOTELTranslator(batch);
             }
             else {
-                await this.batchIngestRuns(ingestParams);
+                const ingestParams = {
+                    runCreates: batch
+                        .filter((item) => item.action === "create")
+                        .map((item) => item.item),
+                    runUpdates: batch
+                        .filter((item) => item.action === "update")
+                        .map((item) => item.item),
+                };
+                const serverInfo = await this._ensureServerInfo();
+                if (serverInfo?.batch_ingest_config?.use_multipart_endpoint) {
+                    await this.multipartIngestRuns(ingestParams);
+                }
+                else {
+                    await this.batchIngestRuns(ingestParams);
+                }
             }
         }
+        catch (e) {
+            console.error("Error exporting batch:", e);
+        }
         finally {
             done();
         }
     }
+    _sendBatchToOTELTranslator(batch) {
+        if (this.langSmithToOTELTranslator !== undefined) {
+            const otelContextMap = new Map();
+            const operations = [];
+            for (const item of batch) {
+                if (item.item.id && item.otelContext) {
+                    otelContextMap.set(item.item.id, item.otelContext);
+                    if (item.action === "create") {
+                        operations.push({
+                            operation: "post",
+                            id: item.item.id,
+                            trace_id: item.item.trace_id ?? item.item.id,
+                            run: item.item,
+                        });
+                    }
+                    else {
+                        operations.push({
+                            operation: "patch",
+                            id: item.item.id,
+                            trace_id: item.item.trace_id ?? item.item.id,
+                            run: item.item,
+                        });
+                    }
+                }
+            }
+            this.langSmithToOTELTranslator.exportBatch(operations, otelContextMap);
+        }
+    }
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
@@ -711,6 +770,17 @@ class Client {
         const sizeLimitBytes = await this._getBatchSizeLimitBytes();
         await this.drainAutoBatchQueue(sizeLimitBytes);
     }
+    _cloneCurrentOTELContext() {
+        const otel_trace = (0, otel_js_1.getOTELTrace)();
+        const otel_context = (0, otel_js_1.getOTELContext)();
+        if (this.langSmithToOTELTranslator !== undefined) {
+            const currentSpan = otel_trace.getActiveSpan();
+            if (currentSpan) {
+                return otel_trace.setSpan(otel_context.active(), currentSpan);
+            }
+        }
+        return undefined;
+    }
     async createRun(run) {
         if (!this._filterForSampling([run]).length) {
             return;
@@ -726,9 +796,11 @@ class Client {
         if (this.autoBatchTracing &&
             runCreate.trace_id !== undefined &&
             runCreate.dotted_order !== undefined) {
+            const otelContext = this._cloneCurrentOTELContext();
             void this.processRunOperation({
                 action: "create",
                 item: runCreate,
+                otelContext,
             }).catch(console.error);
             return;
         }
@@ -1056,17 +1128,26 @@ class Client {
         if (this.autoBatchTracing &&
             data.trace_id !== undefined &&
             data.dotted_order !== undefined) {
+            const otelContext = this._cloneCurrentOTELContext();
             if (run.end_time !== undefined &&
                 data.parent_run_id === undefined &&
                 this.blockOnRootRunFinalization &&
                 !this.manualFlushMode) {
                 // Trigger batches as soon as a root trace ends and wait to ensure trace finishes
                 // in serverless environments.
-                await this.processRunOperation({ action: "update", item: data }).catch(console.error);
+                await this.processRunOperation({
+                    action: "update",
+                    item: data,
+                    otelContext,
+                }).catch(console.error);
                 return;
             }
             else {
-                void this.processRunOperation({ action: "update", item: data }).catch(console.error);
+                void this.processRunOperation({
+                    action: "update",
+                    item: data,
+                    otelContext,
+                }).catch(console.error);
             }
             return;
         }
@@ -3416,15 +3497,16 @@ class Client {
      *
      * @returns A promise that resolves once all currently pending traces have sent.
      */
-    awaitPendingTraceBatches() {
+    async awaitPendingTraceBatches() {
         if (this.manualFlushMode) {
             console.warn("[WARNING]: When tracing in manual flush mode, you must call `await client.flush()` manually to submit trace batches.");
             return Promise.resolve();
         }
-        return Promise.all([
+        await Promise.all([
             ...this.autoBatchQueue.items.map(({ itemPromise }) => itemPromise),
             this.batchIngestCaller.queue.onIdle(),
         ]);
+        await (0, otel_js_1.getDefaultOTLPTracerComponents)()?.spanProcessor?.forceFlush();
     }
 }
 exports.Client = Client;

package/dist/client.d.ts

@@ -1,3 +1,4 @@
+import type { OTELContext, OTELTracerProvider } from "./experimental/otel/types.js";
 import { AsyncCallerParams } from "./utils/async_caller.js";
 import { ComparativeExperiment, DataType, Dataset, DatasetDiffInfo, DatasetShareSchema, Example, ExampleCreate, ExampleUpdate, ExampleUpdateWithoutId, Feedback, FeedbackConfig, FeedbackIngestToken, KVMap, LangChainBaseMessage, LangSmithSettings, LikePromptResponse, Prompt, PromptCommit, PromptSortField, Run, RunCreate, RunUpdate, ScoreType, ExampleSearch, TimeDelta, TracerSession, TracerSessionResult, ValueType, AnnotationQueue, RunWithAnnotationQueueInfo, Attachments, UploadExamplesResponse, UpdateExamplesResponse, DatasetVersion, AnnotationQueueWithDetails } from "./schemas.js";
 import { EvaluationResult, EvaluationResults, RunEvaluator } from "./evaluation/evaluator.js";
@@ -25,6 +26,11 @@ export interface ClientConfig {
      * Enable debug mode for the client. If set, all sent HTTP requests will be logged.
      */
     debug?: boolean;
+    /**
+     * Optional tracer provider for OpenTelemetry integration.
+     * If not provided, a LangSmith-specific tracer provider will be used.
+     */
+    otelTracerProvider?: OTELTracerProvider;
 }
 /**
  * Represents the parameters for listing runs (spans) from the Langsmith server.
@@ -240,6 +246,7 @@ export type CreateProjectParams = {
 type AutoBatchQueueItem = {
     action: "create" | "update";
     item: RunCreate | RunUpdate;
+    otelContext?: OTELContext;
 };
 type Thread = {
     filter: string;
@@ -261,6 +268,7 @@ export declare class AutoBatchQueue {
     items: {
         action: "create" | "update";
         payload: RunCreate | RunUpdate;
+        otelContext?: OTELContext;
         itemPromiseResolve: () => void;
         itemPromise: Promise<void>;
         size: number;
@@ -269,6 +277,7 @@ export declare class AutoBatchQueue {
     peek(): {
         action: "create" | "update";
         payload: RunCreate | RunUpdate;
+        otelContext?: OTELContext;
         itemPromiseResolve: () => void;
         itemPromise: Promise<void>;
         size: number;
@@ -301,6 +310,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     private _serverInfo;
     private _getServerInfoPromise?;
     private manualFlushMode;
+    private langSmithToOTELTranslator?;
     debug: boolean;
     constructor(config?: ClientConfig);
     static getDefaultClientConfig(): {
@@ -325,6 +335,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     private _getMultiPartSupport;
     private drainAutoBatchQueue;
     private _processBatch;
+    private _sendBatchToOTELTranslator;
     private processRunOperation;
     protected _getServerInfo(): Promise<any>;
     protected _ensureServerInfo(): Promise<Record<string, any>>;
@@ -333,6 +344,7 @@ export declare class Client implements LangSmithTracingClientInterface {
      * Flushes current queued traces.
      */
     flush(): Promise<void>;
+    private _cloneCurrentOTELContext;
     createRun(run: CreateRunParams): Promise<void>;
     /**
      * Batch ingest/upsert multiple runs in the Langsmith system.
@@ -971,7 +983,7 @@ export declare class Client implements LangSmithTracingClientInterface {
      *
      * @returns A promise that resolves once all currently pending traces have sent.
      */
-    awaitPendingTraceBatches(): Promise<void> | Promise<[...void[], void]>;
+    awaitPendingTraceBatches(): Promise<void>;
 }
 export interface LangSmithTracingClientInterface {
     createRun: (run: CreateRunParams) => Promise<void>;

package/dist/client.js

@@ -1,4 +1,6 @@
 import * as uuid from "uuid";
+import { LangSmithToOTELTranslator, } from "./experimental/otel/translator.js";
+import { getDefaultOTLPTracerComponents, getOTELTrace, getOTELContext, } from "./singletons/otel.js";
 import { AsyncCaller } from "./utils/async_caller.js";
 import { convertLangChainMessageToExample, isLangChainMessage, } from "./utils/messages.js";
 import { getEnvironmentVariable, getLangChainEnvVarsMetadata, getLangSmithEnvironmentVariable, getRuntimeEnvironment, } from "./utils/env.js";
@@ -112,6 +114,7 @@ export class AutoBatchQueue {
         this.items.push({
             action: item.action,
             payload: item.item,
+            otelContext: item.otelContext,
             // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
             itemPromiseResolve: itemPromiseResolve,
             itemPromise,
@@ -145,7 +148,11 @@ export class AutoBatchQueue {
             this.sizeBytes -= item.size;
         }
         return [
-            popped.map((it) => ({ action: it.action, item: it.payload })),
+            popped.map((it) => ({
+                action: it.action,
+                item: it.payload,
+                otelContext: it.otelContext,
+            })),
             () => popped.forEach((it) => it.itemPromiseResolve()),
         ];
     }
@@ -294,6 +301,12 @@ export class Client {
             writable: true,
             value: false
         });
+        Object.defineProperty(this, "langSmithToOTELTranslator", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "debug", {
             enumerable: true,
             configurable: true,
@@ -339,6 +352,16 @@ export class Client {
         this.batchSizeBytesLimit = config.batchSizeBytesLimit;
         this.fetchOptions = config.fetchOptions || {};
         this.manualFlushMode = config.manualFlushMode ?? this.manualFlushMode;
+        if (getEnvironmentVariable("OTEL_ENABLED") === "true") {
+            const otel_trace = getOTELTrace();
+            const existingTracerProvider = otel_trace.getTracerProvider();
+            const { tracerProvider: langSmithTracerProvider } = getDefaultOTLPTracerComponents() ?? {};
+            // If user has set global tracer before, this fails and returns false
+            const globalSuccessfullyOverridden = otel_trace.setGlobalTracerProvider(langSmithTracerProvider);
+            this.langSmithToOTELTranslator = new LangSmithToOTELTranslator(globalSuccessfullyOverridden
+                ? langSmithTracerProvider
+                : existingTracerProvider);
+        }
     }
     static getDefaultClientConfig() {
         const apiKey = getLangSmithEnvironmentVariable("API_KEY");
@@ -580,26 +603,62 @@ export class Client {
             return;
         }
         try {
-            const ingestParams = {
-                runCreates: batch
-                    .filter((item) => item.action === "create")
-                    .map((item) => item.item),
-                runUpdates: batch
-                    .filter((item) => item.action === "update")
-                    .map((item) => item.item),
-            };
-            const serverInfo = await this._ensureServerInfo();
-            if (serverInfo?.batch_ingest_config?.use_multipart_endpoint) {
-                await this.multipartIngestRuns(ingestParams);
+            if (this.langSmithToOTELTranslator !== undefined) {
+                this._sendBatchToOTELTranslator(batch);
             }
             else {
-                await this.batchIngestRuns(ingestParams);
+                const ingestParams = {
+                    runCreates: batch
+                        .filter((item) => item.action === "create")
+                        .map((item) => item.item),
+                    runUpdates: batch
+                        .filter((item) => item.action === "update")
+                        .map((item) => item.item),
+                };
+                const serverInfo = await this._ensureServerInfo();
+                if (serverInfo?.batch_ingest_config?.use_multipart_endpoint) {
+                    await this.multipartIngestRuns(ingestParams);
+                }
+                else {
+                    await this.batchIngestRuns(ingestParams);
+                }
             }
         }
+        catch (e) {
+            console.error("Error exporting batch:", e);
+        }
         finally {
             done();
         }
     }
+    _sendBatchToOTELTranslator(batch) {
+        if (this.langSmithToOTELTranslator !== undefined) {
+            const otelContextMap = new Map();
+            const operations = [];
+            for (const item of batch) {
+                if (item.item.id && item.otelContext) {
+                    otelContextMap.set(item.item.id, item.otelContext);
+                    if (item.action === "create") {
+                        operations.push({
+                            operation: "post",
+                            id: item.item.id,
+                            trace_id: item.item.trace_id ?? item.item.id,
+                            run: item.item,
+                        });
+                    }
+                    else {
+                        operations.push({
+                            operation: "patch",
+                            id: item.item.id,
+                            trace_id: item.item.trace_id ?? item.item.id,
+                            run: item.item,
+                        });
+                    }
+                }
+            }
+            this.langSmithToOTELTranslator.exportBatch(operations, otelContextMap);
+        }
+    }
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
@@ -673,6 +732,17 @@ export class Client {
         const sizeLimitBytes = await this._getBatchSizeLimitBytes();
         await this.drainAutoBatchQueue(sizeLimitBytes);
     }
+    _cloneCurrentOTELContext() {
+        const otel_trace = getOTELTrace();
+        const otel_context = getOTELContext();
+        if (this.langSmithToOTELTranslator !== undefined) {
+            const currentSpan = otel_trace.getActiveSpan();
+            if (currentSpan) {
+                return otel_trace.setSpan(otel_context.active(), currentSpan);
+            }
+        }
+        return undefined;
+    }
     async createRun(run) {
         if (!this._filterForSampling([run]).length) {
             return;
@@ -688,9 +758,11 @@ export class Client {
         if (this.autoBatchTracing &&
             runCreate.trace_id !== undefined &&
             runCreate.dotted_order !== undefined) {
+            const otelContext = this._cloneCurrentOTELContext();
             void this.processRunOperation({
                 action: "create",
                 item: runCreate,
+                otelContext,
             }).catch(console.error);
             return;
         }
@@ -1018,17 +1090,26 @@ export class Client {
         if (this.autoBatchTracing &&
             data.trace_id !== undefined &&
             data.dotted_order !== undefined) {
+            const otelContext = this._cloneCurrentOTELContext();
             if (run.end_time !== undefined &&
                 data.parent_run_id === undefined &&
                 this.blockOnRootRunFinalization &&
                 !this.manualFlushMode) {
                 // Trigger batches as soon as a root trace ends and wait to ensure trace finishes
                 // in serverless environments.
-                await this.processRunOperation({ action: "update", item: data }).catch(console.error);
+                await this.processRunOperation({
+                    action: "update",
+                    item: data,
+                    otelContext,
+                }).catch(console.error);
                 return;
             }
             else {
-                void this.processRunOperation({ action: "update", item: data }).catch(console.error);
+                void this.processRunOperation({
+                    action: "update",
+                    item: data,
+                    otelContext,
+                }).catch(console.error);
             }
             return;
         }
@@ -3378,15 +3459,16 @@ export class Client {
      *
      * @returns A promise that resolves once all currently pending traces have sent.
      */
-    awaitPendingTraceBatches() {
+    async awaitPendingTraceBatches() {
         if (this.manualFlushMode) {
             console.warn("[WARNING]: When tracing in manual flush mode, you must call `await client.flush()` manually to submit trace batches.");
             return Promise.resolve();
         }
-        return Promise.all([
+        await Promise.all([
             ...this.autoBatchQueue.items.map(({ itemPromise }) => itemPromise),
             this.batchIngestCaller.queue.onIdle(),
         ]);
+        await getDefaultOTLPTracerComponents()?.spanProcessor?.forceFlush();
     }
 }
 function isExampleCreate(input) {

package/dist/experimental/otel/constants.cjs

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_SDK_TOOL_OPERATIONS = exports.AI_SDK_LLM_OPERATIONS = exports.GEN_AI_CHOICE = exports.GEN_AI_ASSISTANT_MESSAGE = exports.GEN_AI_USER_MESSAGE = exports.GEN_AI_SYSTEM_MESSAGE = exports.LANGSMITH_PARENT_RUN_ID = exports.LANGSMITH_DOTTED_ORDER = exports.LANGSMITH_TRACE_ID = exports.LANGSMITH_RUN_ID = exports.LANGSMITH_REQUEST_HEADERS = exports.LANGSMITH_REQUEST_STREAMING = exports.LANGSMITH_RUNTIME = exports.LANGSMITH_TAGS = exports.LANGSMITH_METADATA = exports.LANGSMITH_NAME = exports.LANGSMITH_RUN_TYPE = exports.LANGSMITH_SESSION_NAME = exports.LANGSMITH_SESSION_ID = exports.GEN_AI_USAGE_OUTPUT_TOKEN_DETAILS = exports.GEN_AI_USAGE_INPUT_TOKEN_DETAILS = exports.GEN_AI_RESPONSE_SYSTEM_FINGERPRINT = exports.GEN_AI_RESPONSE_SERVICE_TIER = exports.GEN_AI_RESPONSE_ID = exports.GEN_AI_SERIALIZED_DOC = exports.GEN_AI_SERIALIZED_SIGNATURE = exports.GEN_AI_SERIALIZED_NAME = exports.GEN_AI_REQUEST_EXTRA_BODY = exports.GEN_AI_REQUEST_EXTRA_QUERY = exports.GENAI_COMPLETION = exports.GENAI_PROMPT = exports.GEN_AI_RESPONSE_FINISH_REASONS = exports.GEN_AI_REQUEST_PRESENCE_PENALTY = exports.GEN_AI_REQUEST_FREQUENCY_PENALTY = exports.GEN_AI_REQUEST_TOP_P = exports.GEN_AI_REQUEST_TEMPERATURE = exports.GEN_AI_REQUEST_MAX_TOKENS = exports.GEN_AI_USAGE_TOTAL_TOKENS = exports.GEN_AI_USAGE_OUTPUT_TOKENS = exports.GEN_AI_USAGE_INPUT_TOKENS = exports.GEN_AI_RESPONSE_MODEL = exports.GEN_AI_REQUEST_MODEL = exports.GEN_AI_SYSTEM = exports.GEN_AI_OPERATION_NAME = void 0;
+// OpenTelemetry GenAI semantic convention attribute names
+exports.GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+exports.GEN_AI_SYSTEM = "gen_ai.system";
+exports.GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+exports.GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+exports.GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+exports.GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+exports.GEN_AI_USAGE_TOTAL_TOKENS = "gen_ai.usage.total_tokens";
+exports.GEN_AI_REQUEST_MAX_TOKENS = "gen_ai.request.max_tokens";
+exports.GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature";
+exports.GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p";
+exports.GEN_AI_REQUEST_FREQUENCY_PENALTY = "gen_ai.request.frequency_penalty";
+exports.GEN_AI_REQUEST_PRESENCE_PENALTY = "gen_ai.request.presence_penalty";
+exports.GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";
+exports.GENAI_PROMPT = "gen_ai.prompt";
+exports.GENAI_COMPLETION = "gen_ai.completion";
+exports.GEN_AI_REQUEST_EXTRA_QUERY = "gen_ai.request.extra_query";
+exports.GEN_AI_REQUEST_EXTRA_BODY = "gen_ai.request.extra_body";
+exports.GEN_AI_SERIALIZED_NAME = "gen_ai.serialized.name";
+exports.GEN_AI_SERIALIZED_SIGNATURE = "gen_ai.serialized.signature";
+exports.GEN_AI_SERIALIZED_DOC = "gen_ai.serialized.doc";
+exports.GEN_AI_RESPONSE_ID = "gen_ai.response.id";
+exports.GEN_AI_RESPONSE_SERVICE_TIER = "gen_ai.response.service_tier";
+exports.GEN_AI_RESPONSE_SYSTEM_FINGERPRINT = "gen_ai.response.system_fingerprint";
+exports.GEN_AI_USAGE_INPUT_TOKEN_DETAILS = "gen_ai.usage.input_token_details";
+exports.GEN_AI_USAGE_OUTPUT_TOKEN_DETAILS = "gen_ai.usage.output_token_details";
+// LangSmith custom attributes
+exports.LANGSMITH_SESSION_ID = "langsmith.trace.session_id";
+exports.LANGSMITH_SESSION_NAME = "langsmith.trace.session_name";
+exports.LANGSMITH_RUN_TYPE = "langsmith.span.kind";
+exports.LANGSMITH_NAME = "langsmith.trace.name";
+exports.LANGSMITH_METADATA = "langsmith.metadata";
+exports.LANGSMITH_TAGS = "langsmith.span.tags";
+exports.LANGSMITH_RUNTIME = "langsmith.span.runtime";
+exports.LANGSMITH_REQUEST_STREAMING = "langsmith.request.streaming";
+exports.LANGSMITH_REQUEST_HEADERS = "langsmith.request.headers";
+exports.LANGSMITH_RUN_ID = "langsmith.span.id";
+exports.LANGSMITH_TRACE_ID = "langsmith.trace.id";
+exports.LANGSMITH_DOTTED_ORDER = "langsmith.span.dotted_order";
+exports.LANGSMITH_PARENT_RUN_ID = "langsmith.span.parent_id";
+// GenAI event names
+exports.GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
+exports.GEN_AI_USER_MESSAGE = "gen_ai.user.message";
+exports.GEN_AI_ASSISTANT_MESSAGE = "gen_ai.assistant.message";
+exports.GEN_AI_CHOICE = "gen_ai.choice";
+exports.AI_SDK_LLM_OPERATIONS = [
+    "ai.generateText.doGenerate",
+    "ai.streamText.doStream",
+    "ai.generateObject.doGenerate",
+    "ai.streamObject.doStream",
+];
+exports.AI_SDK_TOOL_OPERATIONS = ["ai.toolCall"];

package/dist/experimental/otel/constants.d.ts

@@ -0,0 +1,44 @@
+export declare const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export declare const GEN_AI_SYSTEM = "gen_ai.system";
+export declare const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export declare const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+export declare const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export declare const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+export declare const GEN_AI_USAGE_TOTAL_TOKENS = "gen_ai.usage.total_tokens";
+export declare const GEN_AI_REQUEST_MAX_TOKENS = "gen_ai.request.max_tokens";
+export declare const GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature";
+export declare const GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p";
+export declare const GEN_AI_REQUEST_FREQUENCY_PENALTY = "gen_ai.request.frequency_penalty";
+export declare const GEN_AI_REQUEST_PRESENCE_PENALTY = "gen_ai.request.presence_penalty";
+export declare const GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";
+export declare const GENAI_PROMPT = "gen_ai.prompt";
+export declare const GENAI_COMPLETION = "gen_ai.completion";
+export declare const GEN_AI_REQUEST_EXTRA_QUERY = "gen_ai.request.extra_query";
+export declare const GEN_AI_REQUEST_EXTRA_BODY = "gen_ai.request.extra_body";
+export declare const GEN_AI_SERIALIZED_NAME = "gen_ai.serialized.name";
+export declare const GEN_AI_SERIALIZED_SIGNATURE = "gen_ai.serialized.signature";
+export declare const GEN_AI_SERIALIZED_DOC = "gen_ai.serialized.doc";
+export declare const GEN_AI_RESPONSE_ID = "gen_ai.response.id";
+export declare const GEN_AI_RESPONSE_SERVICE_TIER = "gen_ai.response.service_tier";
+export declare const GEN_AI_RESPONSE_SYSTEM_FINGERPRINT = "gen_ai.response.system_fingerprint";
+export declare const GEN_AI_USAGE_INPUT_TOKEN_DETAILS = "gen_ai.usage.input_token_details";
+export declare const GEN_AI_USAGE_OUTPUT_TOKEN_DETAILS = "gen_ai.usage.output_token_details";
+export declare const LANGSMITH_SESSION_ID = "langsmith.trace.session_id";
+export declare const LANGSMITH_SESSION_NAME = "langsmith.trace.session_name";
+export declare const LANGSMITH_RUN_TYPE = "langsmith.span.kind";
+export declare const LANGSMITH_NAME = "langsmith.trace.name";
+export declare const LANGSMITH_METADATA = "langsmith.metadata";
+export declare const LANGSMITH_TAGS = "langsmith.span.tags";
+export declare const LANGSMITH_RUNTIME = "langsmith.span.runtime";
+export declare const LANGSMITH_REQUEST_STREAMING = "langsmith.request.streaming";
+export declare const LANGSMITH_REQUEST_HEADERS = "langsmith.request.headers";
+export declare const LANGSMITH_RUN_ID = "langsmith.span.id";
+export declare const LANGSMITH_TRACE_ID = "langsmith.trace.id";
+export declare const LANGSMITH_DOTTED_ORDER = "langsmith.span.dotted_order";
+export declare const LANGSMITH_PARENT_RUN_ID = "langsmith.span.parent_id";
+export declare const GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
+export declare const GEN_AI_USER_MESSAGE = "gen_ai.user.message";
+export declare const GEN_AI_ASSISTANT_MESSAGE = "gen_ai.assistant.message";
+export declare const GEN_AI_CHOICE = "gen_ai.choice";
+export declare const AI_SDK_LLM_OPERATIONS: string[];
+export declare const AI_SDK_TOOL_OPERATIONS: string[];

package/dist/experimental/otel/constants.js

@@ -0,0 +1,52 @@
+// OpenTelemetry GenAI semantic convention attribute names
+export const GEN_AI_OPERATION_NAME = "gen_ai.operation.name";
+export const GEN_AI_SYSTEM = "gen_ai.system";
+export const GEN_AI_REQUEST_MODEL = "gen_ai.request.model";
+export const GEN_AI_RESPONSE_MODEL = "gen_ai.response.model";
+export const GEN_AI_USAGE_INPUT_TOKENS = "gen_ai.usage.input_tokens";
+export const GEN_AI_USAGE_OUTPUT_TOKENS = "gen_ai.usage.output_tokens";
+export const GEN_AI_USAGE_TOTAL_TOKENS = "gen_ai.usage.total_tokens";
+export const GEN_AI_REQUEST_MAX_TOKENS = "gen_ai.request.max_tokens";
+export const GEN_AI_REQUEST_TEMPERATURE = "gen_ai.request.temperature";
+export const GEN_AI_REQUEST_TOP_P = "gen_ai.request.top_p";
+export const GEN_AI_REQUEST_FREQUENCY_PENALTY = "gen_ai.request.frequency_penalty";
+export const GEN_AI_REQUEST_PRESENCE_PENALTY = "gen_ai.request.presence_penalty";
+export const GEN_AI_RESPONSE_FINISH_REASONS = "gen_ai.response.finish_reasons";
+export const GENAI_PROMPT = "gen_ai.prompt";
+export const GENAI_COMPLETION = "gen_ai.completion";
+export const GEN_AI_REQUEST_EXTRA_QUERY = "gen_ai.request.extra_query";
+export const GEN_AI_REQUEST_EXTRA_BODY = "gen_ai.request.extra_body";
+export const GEN_AI_SERIALIZED_NAME = "gen_ai.serialized.name";
+export const GEN_AI_SERIALIZED_SIGNATURE = "gen_ai.serialized.signature";
+export const GEN_AI_SERIALIZED_DOC = "gen_ai.serialized.doc";
+export const GEN_AI_RESPONSE_ID = "gen_ai.response.id";
+export const GEN_AI_RESPONSE_SERVICE_TIER = "gen_ai.response.service_tier";
+export const GEN_AI_RESPONSE_SYSTEM_FINGERPRINT = "gen_ai.response.system_fingerprint";
+export const GEN_AI_USAGE_INPUT_TOKEN_DETAILS = "gen_ai.usage.input_token_details";
+export const GEN_AI_USAGE_OUTPUT_TOKEN_DETAILS = "gen_ai.usage.output_token_details";
+// LangSmith custom attributes
+export const LANGSMITH_SESSION_ID = "langsmith.trace.session_id";
+export const LANGSMITH_SESSION_NAME = "langsmith.trace.session_name";
+export const LANGSMITH_RUN_TYPE = "langsmith.span.kind";
+export const LANGSMITH_NAME = "langsmith.trace.name";
+export const LANGSMITH_METADATA = "langsmith.metadata";
+export const LANGSMITH_TAGS = "langsmith.span.tags";
+export const LANGSMITH_RUNTIME = "langsmith.span.runtime";
+export const LANGSMITH_REQUEST_STREAMING = "langsmith.request.streaming";
+export const LANGSMITH_REQUEST_HEADERS = "langsmith.request.headers";
+export const LANGSMITH_RUN_ID = "langsmith.span.id";
+export const LANGSMITH_TRACE_ID = "langsmith.trace.id";
+export const LANGSMITH_DOTTED_ORDER = "langsmith.span.dotted_order";
+export const LANGSMITH_PARENT_RUN_ID = "langsmith.span.parent_id";
+// GenAI event names
+export const GEN_AI_SYSTEM_MESSAGE = "gen_ai.system.message";
+export const GEN_AI_USER_MESSAGE = "gen_ai.user.message";
+export const GEN_AI_ASSISTANT_MESSAGE = "gen_ai.assistant.message";
+export const GEN_AI_CHOICE = "gen_ai.choice";
+export const AI_SDK_LLM_OPERATIONS = [
+    "ai.generateText.doGenerate",
+    "ai.streamText.doStream",
+    "ai.generateObject.doGenerate",
+    "ai.streamObject.doStream",
+];
+export const AI_SDK_TOOL_OPERATIONS = ["ai.toolCall"];