langsmith 0.8.9 → 0.8.10

package/dist/client.cjs

@@ -893,7 +893,8 @@ class Client {
             config.hideInputs ?? config.anonymizer ?? defaultConfig.hideInputs;
         this.hideOutputs =
             config.hideOutputs ?? config.anonymizer ?? defaultConfig.hideOutputs;
-        this.hideMetadata = config.hideMetadata ?? defaultConfig.hideMetadata;
+        this.hideMetadata =
+            config.hideMetadata ?? config.anonymizer ?? defaultConfig.hideMetadata;
         this.anonymizer = config.anonymizer;
         this.omitTracedRuntimeInfo = config.omitTracedRuntimeInfo ?? false;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
@@ -1555,6 +1556,9 @@ class Client {
         const batchSizeBytes = batch.reduce((sum, item) => sum + (item.size ?? 0), 0);
         try {
             if (this.langSmithToOTELTranslator !== undefined) {
+                for (const item of batch) {
+                    item.item = await this._maskRunMetadata(item.item);
+                }
                 this._sendBatchToOTELTranslator(batch);
             }
             else {
@@ -1635,6 +1639,25 @@ class Client {
             this.langSmithToOTELTranslator.exportBatch(operations, otelContextMap);
         }
     }
+    async _maskRunMetadata(run) {
+        if (run.extra?.metadata == null) {
+            return run;
+        }
+        return {
+            ...run,
+            extra: {
+                ...run.extra,
+                metadata: await this.processMetadata(run.extra.metadata),
+            },
+        };
+    }
+    async _mergeRuntimeEnvAndMaskMetadata(run) {
+        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        if (this.omitTracedRuntimeInfo) {
+            return merged;
+        }
+        return this._maskRunMetadata(merged);
+    }
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
@@ -1791,7 +1814,7 @@ class Client {
             }).catch(console.error);
             return;
         }
-        const mergedRunCreateParam = mergeRuntimeEnvIntoRun(runCreate, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        const mergedRunCreateParam = await this._mergeRuntimeEnvAndMaskMetadata(runCreate);
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }
@@ -2980,7 +3003,7 @@ class Client {
             _hostUrl: this.getHostUrl(),
         }));
     }
-    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, }) {
+    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, tagValueIds = null, }) {
         const upsert_ = upsert ? `?upsert=true` : "";
         const endpoint = `${this.apiUrl}/sessions${upsert_}`;
         const extra = projectExtra || {};
@@ -3004,6 +3027,9 @@ class Client {
         if (evaluatorKeys != null && evaluatorKeys.length > 0) {
             body["evaluator_keys"] = evaluatorKeys;
         }
+        if (tagValueIds !== null) {
+            body["tag_value_ids"] = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(endpoint, {
@@ -3247,7 +3273,7 @@ class Client {
         const result = await response.json();
         return result;
     }
-    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, } = {}) {
+    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, tagValueIds, } = {}) {
         const body = {
             name,
             description,
@@ -3262,6 +3288,9 @@ class Client {
         if (outputsSchema) {
             body.outputs_schema_definition = outputsSchema;
         }
+        if (tagValueIds !== undefined) {
+            body.tag_value_ids = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets`, {

package/dist/client.d.ts

@@ -20,11 +20,11 @@ export interface ClientConfig {
     timeout_ms?: number;
     webUrl?: string;
     /**
-     * A function applied for masking serialized run inputs and outputs,
-     * before sending to the API. Can be called with raw inputs, raw
-     * outputs, or a nested `{ error: string }` object for errors.
+     * A function applied for masking serialized run inputs, outputs and
+     * metadata, before sending to the API. Can be called with raw inputs, raw
+     * outputs, raw metadata, or a nested `{ error: string }` object for errors.
      *
-     * If a `hideInputs` or `hideOutputs` function is present,
+     * If a `hideInputs`, `hideOutputs` or `hideMetadata` function is present,
      * the client will call it instead of the anonymizer as appropriate.
      */
     anonymizer?: (values: KVMap) => KVMap | Promise<KVMap>;
@@ -413,6 +413,7 @@ export type CreateProjectParams = {
     numExamples?: number | null;
     numRepetitions?: number | null;
     evaluatorKeys?: string[] | null;
+    tagValueIds?: string[] | null;
 };
 type AutoBatchQueueItem = {
     action: "create" | "update";
@@ -670,6 +671,8 @@ export declare class Client implements LangSmithTracingClientInterface {
     private static _writeTraceToFallbackDir;
     private _processBatch;
     private _sendBatchToOTELTranslator;
+    private _maskRunMetadata;
+    private _mergeRuntimeEnvAndMaskMetadata;
     private processRunOperation;
     protected _getServerInfo(): Promise<any>;
     private _checkStainlessVersion;
@@ -872,7 +875,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     listSharedExamples(shareToken: string, options?: {
         exampleIds?: string[];
     }): Promise<Example[]>;
-    createProject({ projectName, description, metadata, upsert, projectExtra, referenceDatasetId, numExamples, numRepetitions, evaluatorKeys, }: CreateProjectParams): Promise<TracerSession>;
+    createProject({ projectName, description, metadata, upsert, projectExtra, referenceDatasetId, numExamples, numRepetitions, evaluatorKeys, tagValueIds, }: CreateProjectParams): Promise<TracerSession>;
     updateProject(projectId: string, { name, description, metadata, projectExtra, endTime, }: {
         name?: string | null;
         description?: string | null;
@@ -914,12 +917,13 @@ export declare class Client implements LangSmithTracingClientInterface {
         projectName?: string;
     }): Promise<void>;
     uploadCsv({ csvFile, fileName, inputKeys, outputKeys, description, dataType, name, }: UploadCSVParams): Promise<Dataset>;
-    createDataset(name: string, { description, dataType, inputsSchema, outputsSchema, metadata, }?: {
+    createDataset(name: string, { description, dataType, inputsSchema, outputsSchema, metadata, tagValueIds, }?: {
         description?: string;
         dataType?: DataType;
         inputsSchema?: KVMap;
         outputsSchema?: KVMap;
         metadata?: RecordStringAny;
+        tagValueIds?: string[];
     }): Promise<Dataset>;
     readDataset({ datasetId, datasetName, }: {
         datasetId?: string;

package/dist/client.js

@@ -854,7 +854,8 @@ export class Client {
             config.hideInputs ?? config.anonymizer ?? defaultConfig.hideInputs;
         this.hideOutputs =
             config.hideOutputs ?? config.anonymizer ?? defaultConfig.hideOutputs;
-        this.hideMetadata = config.hideMetadata ?? defaultConfig.hideMetadata;
+        this.hideMetadata =
+            config.hideMetadata ?? config.anonymizer ?? defaultConfig.hideMetadata;
         this.anonymizer = config.anonymizer;
         this.omitTracedRuntimeInfo = config.omitTracedRuntimeInfo ?? false;
         this.autoBatchTracing = config.autoBatchTracing ?? this.autoBatchTracing;
@@ -1516,6 +1517,9 @@ export class Client {
         const batchSizeBytes = batch.reduce((sum, item) => sum + (item.size ?? 0), 0);
         try {
             if (this.langSmithToOTELTranslator !== undefined) {
+                for (const item of batch) {
+                    item.item = await this._maskRunMetadata(item.item);
+                }
                 this._sendBatchToOTELTranslator(batch);
             }
             else {
@@ -1596,6 +1600,25 @@ export class Client {
             this.langSmithToOTELTranslator.exportBatch(operations, otelContextMap);
         }
     }
+    async _maskRunMetadata(run) {
+        if (run.extra?.metadata == null) {
+            return run;
+        }
+        return {
+            ...run,
+            extra: {
+                ...run.extra,
+                metadata: await this.processMetadata(run.extra.metadata),
+            },
+        };
+    }
+    async _mergeRuntimeEnvAndMaskMetadata(run) {
+        const merged = mergeRuntimeEnvIntoRun(run, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        if (this.omitTracedRuntimeInfo) {
+            return merged;
+        }
+        return this._maskRunMetadata(merged);
+    }
     async processRunOperation(item) {
         clearTimeout(this.autoBatchTimeout);
         this.autoBatchTimeout = undefined;
@@ -1752,7 +1775,7 @@ export class Client {
             }).catch(console.error);
             return;
         }
-        const mergedRunCreateParam = mergeRuntimeEnvIntoRun(runCreate, this.cachedLSEnvVarsForMetadata, this.omitTracedRuntimeInfo);
+        const mergedRunCreateParam = await this._mergeRuntimeEnvAndMaskMetadata(runCreate);
         if (options?.apiKey !== undefined) {
             headers["x-api-key"] = options.apiKey;
         }
@@ -2941,7 +2964,7 @@ export class Client {
             _hostUrl: this.getHostUrl(),
         }));
     }
-    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, }) {
+    async createProject({ projectName, description = null, metadata = null, upsert = false, projectExtra = null, referenceDatasetId = null, numExamples = null, numRepetitions = null, evaluatorKeys = null, tagValueIds = null, }) {
         const upsert_ = upsert ? `?upsert=true` : "";
         const endpoint = `${this.apiUrl}/sessions${upsert_}`;
         const extra = projectExtra || {};
@@ -2965,6 +2988,9 @@ export class Client {
         if (evaluatorKeys != null && evaluatorKeys.length > 0) {
             body["evaluator_keys"] = evaluatorKeys;
         }
+        if (tagValueIds !== null) {
+            body["tag_value_ids"] = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(endpoint, {
@@ -3208,7 +3234,7 @@ export class Client {
         const result = await response.json();
         return result;
     }
-    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, } = {}) {
+    async createDataset(name, { description, dataType, inputsSchema, outputsSchema, metadata, tagValueIds, } = {}) {
         const body = {
             name,
             description,
@@ -3223,6 +3249,9 @@ export class Client {
         if (outputsSchema) {
             body.outputs_schema_definition = outputsSchema;
         }
+        if (tagValueIds !== undefined) {
+            body.tag_value_ids = tagValueIds;
+        }
         const serializedBody = JSON.stringify(body);
         const response = await this.caller.call(async () => {
             const res = await this._fetch(`${this.apiUrl}/datasets`, {

package/dist/experimental/vercel/_agent_type.cjs

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveVercelLsAgentType = resolveVercelLsAgentType;
+exports.vercelLsAgentTypeMetadata = vercelLsAgentTypeMetadata;
+const run_trees_js_1 = require("../../run_trees.cjs");
+const traceable_js_1 = require("../../singletons/traceable.cjs");
+const ls_agent_type_js_1 = require("../../utils/ls_agent_type.cjs");
+// Vercel builds its traceable's `metadata` config eagerly, before traceable
+// itself runs — this resolver stamps `ls_agent_type` at that moment.
+// Traceable's own propagation would carry a parent's middleware/subagent/
+// compaction/"root" tag down on its own. This resolver is needed
+// for correct default tagging of the root `ls_agent_type` == root
+// and tagging of subagents.
+function resolveVercelLsAgentType(parentRunTree) {
+    const parent = parentRunTree ?? (0, traceable_js_1.getCurrentRunTree)(true);
+    if (!(0, run_trees_js_1.isRunTree)(parent))
+        return (0, ls_agent_type_js_1.resolveDefaultLsAgentType)(parent);
+    const parentTag = parent.extra?.metadata?.ls_agent_type;
+    if (typeof parentTag === "string" && ls_agent_type_js_1.NON_ROOT_LS_AGENT_TYPES.has(parentTag)) {
+        return parentTag;
+    }
+    if (parent.run_type === "tool")
+        return "subagent";
+    if (parentTag === "root")
+        return "root";
+    return undefined;
+}
+function vercelLsAgentTypeMetadata(parentRunTree) {
+    return (0, ls_agent_type_js_1.lsAgentTypeMetadata)(resolveVercelLsAgentType(parentRunTree));
+}

package/dist/experimental/vercel/_agent_type.d.ts

@@ -0,0 +1,5 @@
+import { LsAgentType } from "../../utils/ls_agent_type.js";
+export declare function resolveVercelLsAgentType(parentRunTree?: unknown): LsAgentType | undefined;
+export declare function vercelLsAgentTypeMetadata(parentRunTree?: unknown): {
+    ls_agent_type?: LsAgentType;
+};

package/dist/experimental/vercel/_agent_type.js

@@ -0,0 +1,26 @@
+import { isRunTree } from "../../run_trees.js";
+import { getCurrentRunTree } from "../../singletons/traceable.js";
+import { NON_ROOT_LS_AGENT_TYPES, lsAgentTypeMetadata, resolveDefaultLsAgentType, } from "../../utils/ls_agent_type.js";
+// Vercel builds its traceable's `metadata` config eagerly, before traceable
+// itself runs — this resolver stamps `ls_agent_type` at that moment.
+// Traceable's own propagation would carry a parent's middleware/subagent/
+// compaction/"root" tag down on its own. This resolver is needed
+// for correct default tagging of the root `ls_agent_type` == root
+// and tagging of subagents.
+export function resolveVercelLsAgentType(parentRunTree) {
+    const parent = parentRunTree ?? getCurrentRunTree(true);
+    if (!isRunTree(parent))
+        return resolveDefaultLsAgentType(parent);
+    const parentTag = parent.extra?.metadata?.ls_agent_type;
+    if (typeof parentTag === "string" && NON_ROOT_LS_AGENT_TYPES.has(parentTag)) {
+        return parentTag;
+    }
+    if (parent.run_type === "tool")
+        return "subagent";
+    if (parentTag === "root")
+        return "root";
+    return undefined;
+}
+export function vercelLsAgentTypeMetadata(parentRunTree) {
+    return lsAgentTypeMetadata(resolveVercelLsAgentType(parentRunTree));
+}

package/dist/experimental/vercel/telemetry.cjs

@@ -7,6 +7,7 @@ const env_js_1 = require("../../env.cjs");
 const utils_js_1 = require("./utils.cjs");
 const utils_js_2 = require("./utils.cjs");
 const types_js_1 = require("../../utils/types.cjs");
+const _agent_type_js_1 = require("./_agent_type.cjs");
 function _formatMessages(messages) {
     if (!Array.isArray(messages))
         return messages;
@@ -52,12 +53,6 @@ event, traceRawHttp) {
     }
     return (0, utils_js_1.convertMessageToTracedFormat)(output);
 }
-function _getLsAgentType(parentRunTree) {
-    if ((0, run_trees_js_1.isRunTree)(parentRunTree) && parentRunTree.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-}
 function _hasNonzeroUsageMetadata(runTree) {
     const usageMetadata = runTree.extra?.metadata?.usage_metadata;
     if (!(0, types_js_1.isRecord)(usageMetadata))
@@ -200,7 +195,7 @@ function LangSmithTelemetry(config) {
                 metadata: {
                     ...customMetadata,
                     ai_sdk_method: event.operationId,
-                    ls_agent_type: _getLsAgentType(parentRunTree),
+                    ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(parentRunTree),
                     ls_model_name: event.modelId,
                     ls_integration: "vercel-ai-sdk-telemetry",
                 },

package/dist/experimental/vercel/telemetry.js

@@ -4,6 +4,7 @@ import { isEnvTracingEnabled } from "../../env.js";
 import { convertMessageToTracedFormat } from "./utils.js";
 import { setUsageMetadataOnRunTree } from "./utils.js";
 import { isPrimitive, isRecord } from "../../utils/types.js";
+import { vercelLsAgentTypeMetadata } from "./_agent_type.js";
 function _formatMessages(messages) {
     if (!Array.isArray(messages))
         return messages;
@@ -49,12 +50,6 @@ event, traceRawHttp) {
     }
     return convertMessageToTracedFormat(output);
 }
-function _getLsAgentType(parentRunTree) {
-    if (isRunTree(parentRunTree) && parentRunTree.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-}
 function _hasNonzeroUsageMetadata(runTree) {
     const usageMetadata = runTree.extra?.metadata?.usage_metadata;
     if (!isRecord(usageMetadata))
@@ -197,7 +192,7 @@ export function LangSmithTelemetry(config) {
                 metadata: {
                     ...customMetadata,
                     ai_sdk_method: event.operationId,
-                    ls_agent_type: _getLsAgentType(parentRunTree),
+                    ...vercelLsAgentTypeMetadata(parentRunTree),
                     ls_model_name: event.modelId,
                     ls_integration: "vercel-ai-sdk-telemetry",
                 },

package/dist/experimental/vercel/wrap.cjs

@@ -5,6 +5,7 @@ const middleware_js_1 = require("./middleware.cjs");
 const utils_js_1 = require("./utils.cjs");
 Object.defineProperty(exports, "convertMessageToTracedFormat", { enumerable: true, get: function () { return utils_js_1.convertMessageToTracedFormat; } });
 const traceable_js_1 = require("../../traceable.cjs");
+const _agent_type_js_1 = require("./_agent_type.cjs");
 const _getModelDisplayName = (model) => {
     if (typeof model === "string") {
         return model;
@@ -118,19 +119,12 @@ const _resolveConfigs = (baseLsConfig, runtimeLsConfig) => {
         resolvedToolConfig,
     };
 };
-const _getLsAgentType = () => {
-    const parentRun = (0, traceable_js_1.getCurrentRunTree)(true);
-    if (parentRun != null && parentRun.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-};
 const _getGenerateTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolvedLsConfig, hasExplicitOutput, hasExplicitExperimentalOutput, traceResponseMetadata, }) => {
     return {
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
             ai_sdk_method: aiSdkMethodName ?? "ai.generateText",
             ...resolvedLsConfig?.metadata,
         },
@@ -206,7 +200,7 @@ const _getStreamTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolved
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
             ai_sdk_method: aiSdkMethodName ?? "ai.streamText",
             ...resolvedLsConfig?.metadata,
         },
@@ -409,7 +403,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
                     ai_sdk_method: "ai.generateObject",
                     ...resolvedLsConfig?.metadata,
                 },
@@ -531,7 +525,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...(0, _agent_type_js_1.vercelLsAgentTypeMetadata)(),
                     ai_sdk_method: "ai.streamObject",
                     ...resolvedLsConfig?.metadata,
                 },

package/dist/experimental/vercel/wrap.js

@@ -1,6 +1,7 @@
 import { LangSmithMiddleware, } from "./middleware.js";
 import { convertMessageToTracedFormat } from "./utils.js";
-import { isTraceableFunction, traceable, getCurrentRunTree, } from "../../traceable.js";
+import { isTraceableFunction, traceable } from "../../traceable.js";
+import { vercelLsAgentTypeMetadata } from "./_agent_type.js";
 const _getModelDisplayName = (model) => {
     if (typeof model === "string") {
         return model;
@@ -114,19 +115,12 @@ const _resolveConfigs = (baseLsConfig, runtimeLsConfig) => {
         resolvedToolConfig,
     };
 };
-const _getLsAgentType = () => {
-    const parentRun = getCurrentRunTree(true);
-    if (parentRun != null && parentRun.run_type === "tool") {
-        return "subagent";
-    }
-    return "root";
-};
 const _getGenerateTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolvedLsConfig, hasExplicitOutput, hasExplicitExperimentalOutput, traceResponseMetadata, }) => {
     return {
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...vercelLsAgentTypeMetadata(),
             ai_sdk_method: aiSdkMethodName ?? "ai.generateText",
             ...resolvedLsConfig?.metadata,
         },
@@ -202,7 +196,7 @@ const _getStreamTextWrapperConfig = ({ model, runName, aiSdkMethodName, resolved
         name: runName ?? _getModelDisplayName(model),
         ...resolvedLsConfig,
         metadata: {
-            ls_agent_type: _getLsAgentType(),
+            ...vercelLsAgentTypeMetadata(),
             ai_sdk_method: aiSdkMethodName ?? "ai.streamText",
             ...resolvedLsConfig?.metadata,
         },
@@ -404,7 +398,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...vercelLsAgentTypeMetadata(),
                     ai_sdk_method: "ai.generateObject",
                     ...resolvedLsConfig?.metadata,
                 },
@@ -526,7 +520,7 @@ const wrapAISDK = (ai, baseLsConfig) => {
                 name: _getModelDisplayName(params.model),
                 ...resolvedLsConfig,
                 metadata: {
-                    ls_agent_type: _getLsAgentType(),
+                    ...vercelLsAgentTypeMetadata(),
                     ai_sdk_method: "ai.streamObject",
                     ...resolvedLsConfig?.metadata,
                 },

package/dist/index.cjs

@@ -35,6 +35,6 @@ Object.defineProperty(exports, "UnprocessableEntityError", { enumerable: true, g
 Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return error_js_1.RateLimitError; } });
 Object.defineProperty(exports, "InternalServerError", { enumerable: true, get: function () { return error_js_1.InternalServerError; } });
 // Update using pnpm bump-version
-exports.__version__ = "0.8.9";
+exports.__version__ = "0.8.10";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 exports.LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { computeRunIdForSecondaryReplica, uuid7, uuid7FromTime, } from "./uuid.j
 export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, type CacheConfig, type CacheMetrics, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 export { LangsmithError, APIError, APIUserAbortError, APIConnectionError, APIConnectionTimeoutError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./_openapi_client/core/error.js";
-export declare const __version__ = "0.8.9";
+export declare const __version__ = "0.8.10";
 export declare const LS_MESSAGE_VIEW_EXCLUDE: "ls_message_view_exclude";

package/dist/index.js

@@ -7,6 +7,6 @@ export { isTracingEnabled } from "./utils/guard.js";
 export { Cache, PromptCache, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 export { LangsmithError, APIError, APIUserAbortError, APIConnectionError, APIConnectionTimeoutError, BadRequestError, AuthenticationError, PermissionDeniedError, NotFoundError, ConflictError, UnprocessableEntityError, RateLimitError, InternalServerError, } from "./_openapi_client/core/error.js";
 // Update using pnpm bump-version
-export const __version__ = "0.8.9";
+export const __version__ = "0.8.10";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 export const LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/utils/_git.cjs

@@ -17,6 +17,33 @@ const execGit = (command, exec) => {
         });
     });
 };
+function sanitizeRemoteUrl(remoteUrl) {
+    if (remoteUrl == null) {
+        return remoteUrl;
+    }
+    const schemeSeparator = remoteUrl.indexOf("://");
+    if (schemeSeparator === -1) {
+        return remoteUrl;
+    }
+    const scheme = remoteUrl.slice(0, schemeSeparator).toLowerCase();
+    if (scheme !== "http" && scheme !== "https") {
+        return remoteUrl;
+    }
+    const authorityStart = schemeSeparator + "://".length;
+    let authorityEnd = remoteUrl.length;
+    for (const delimiter of ["/", "?", "#"]) {
+        const delimiterIndex = remoteUrl.indexOf(delimiter, authorityStart);
+        if (delimiterIndex !== -1) {
+            authorityEnd = Math.min(authorityEnd, delimiterIndex);
+        }
+    }
+    const authority = remoteUrl.slice(authorityStart, authorityEnd);
+    const userinfoEnd = authority.lastIndexOf("@");
+    if (userinfoEnd === -1) {
+        return remoteUrl;
+    }
+    return `${remoteUrl.slice(0, authorityStart)}${authority.slice(userinfoEnd + 1)}${remoteUrl.slice(authorityEnd)}`;
+}
 const getGitInfo = async (remote = "origin") => {
     let exec;
     try {
@@ -42,7 +69,7 @@ const getGitInfo = async (remote = "origin") => {
         execGit(["log", "-1", "--format=%ae"], exec),
     ]);
     return {
-        remoteUrl,
+        remoteUrl: sanitizeRemoteUrl(remoteUrl),
         commit,
         commitTime,
         branch,

package/dist/utils/_git.js

@@ -14,6 +14,33 @@ const execGit = (command, exec) => {
         });
     });
 };
+function sanitizeRemoteUrl(remoteUrl) {
+    if (remoteUrl == null) {
+        return remoteUrl;
+    }
+    const schemeSeparator = remoteUrl.indexOf("://");
+    if (schemeSeparator === -1) {
+        return remoteUrl;
+    }
+    const scheme = remoteUrl.slice(0, schemeSeparator).toLowerCase();
+    if (scheme !== "http" && scheme !== "https") {
+        return remoteUrl;
+    }
+    const authorityStart = schemeSeparator + "://".length;
+    let authorityEnd = remoteUrl.length;
+    for (const delimiter of ["/", "?", "#"]) {
+        const delimiterIndex = remoteUrl.indexOf(delimiter, authorityStart);
+        if (delimiterIndex !== -1) {
+            authorityEnd = Math.min(authorityEnd, delimiterIndex);
+        }
+    }
+    const authority = remoteUrl.slice(authorityStart, authorityEnd);
+    const userinfoEnd = authority.lastIndexOf("@");
+    if (userinfoEnd === -1) {
+        return remoteUrl;
+    }
+    return `${remoteUrl.slice(0, authorityStart)}${authority.slice(userinfoEnd + 1)}${remoteUrl.slice(authorityEnd)}`;
+}
 export const getGitInfo = async (remote = "origin") => {
     let exec;
     try {
@@ -39,7 +66,7 @@ export const getGitInfo = async (remote = "origin") => {
         execGit(["log", "-1", "--format=%ae"], exec),
     ]);
     return {
-        remoteUrl,
+        remoteUrl: sanitizeRemoteUrl(remoteUrl),
         commit,
         commitTime,
         branch,

package/dist/utils/ls_agent_type.cjs

@@ -0,0 +1,31 @@
+"use strict";
+// Shared primitives for the `ls_agent_type` metadata tag.
+// Consumed by wrappers/integrations that stamp or inspect `ls_agent_type` on
+// traced runs (wrap_openai, OpenAI Agents SDK, Vercel, future wrappers).
+// Keep this module SDK-agnostic: the caller passes in the parent run tree.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NON_ROOT_LS_AGENT_TYPES = void 0;
+exports.resolveDefaultLsAgentType = resolveDefaultLsAgentType;
+exports.lsAgentTypeMetadata = lsAgentTypeMetadata;
+exports.defaultLsAgentTypeMetadata = defaultLsAgentTypeMetadata;
+const run_trees_js_1 = require("../run_trees.cjs");
+// Non-root tags: preserved against default/structural stamping.
+exports.NON_ROOT_LS_AGENT_TYPES = new Set([
+    "middleware",
+    "subagent",
+    "compaction",
+]);
+// `"root"` at trace root; `undefined` when nested (rely on propagation).
+function resolveDefaultLsAgentType(parentRunTree) {
+    return (0, run_trees_js_1.isRunTree)(parentRunTree) ? undefined : "root";
+}
+// Spread helper: `{ ls_agent_type: tag }` when tag is set, `{}` when undefined.
+function lsAgentTypeMetadata(tag) {
+    return tag !== undefined ? { ls_agent_type: tag } : {};
+}
+// Preserves user-supplied ls_agent_type; stamps default only when key is absent.
+function defaultLsAgentTypeMetadata(existingMetadata, parentRunTree) {
+    if ("ls_agent_type" in existingMetadata)
+        return {};
+    return lsAgentTypeMetadata(resolveDefaultLsAgentType(parentRunTree));
+}

package/dist/utils/ls_agent_type.d.ts

@@ -0,0 +1,9 @@
+export type LsAgentType = "root" | "middleware" | "subagent" | "compaction";
+export declare const NON_ROOT_LS_AGENT_TYPES: ReadonlySet<string>;
+export declare function resolveDefaultLsAgentType(parentRunTree?: unknown): LsAgentType | undefined;
+export declare function lsAgentTypeMetadata(tag: LsAgentType | undefined): {
+    ls_agent_type?: LsAgentType;
+};
+export declare function defaultLsAgentTypeMetadata(existingMetadata: Record<string, unknown>, parentRunTree?: unknown): {
+    ls_agent_type?: LsAgentType;
+};

package/dist/utils/ls_agent_type.js

@@ -0,0 +1,25 @@
+// Shared primitives for the `ls_agent_type` metadata tag.
+// Consumed by wrappers/integrations that stamp or inspect `ls_agent_type` on
+// traced runs (wrap_openai, OpenAI Agents SDK, Vercel, future wrappers).
+// Keep this module SDK-agnostic: the caller passes in the parent run tree.
+import { isRunTree } from "../run_trees.js";
+// Non-root tags: preserved against default/structural stamping.
+export const NON_ROOT_LS_AGENT_TYPES = new Set([
+    "middleware",
+    "subagent",
+    "compaction",
+]);
+// `"root"` at trace root; `undefined` when nested (rely on propagation).
+export function resolveDefaultLsAgentType(parentRunTree) {
+    return isRunTree(parentRunTree) ? undefined : "root";
+}
+// Spread helper: `{ ls_agent_type: tag }` when tag is set, `{}` when undefined.
+export function lsAgentTypeMetadata(tag) {
+    return tag !== undefined ? { ls_agent_type: tag } : {};
+}
+// Preserves user-supplied ls_agent_type; stamps default only when key is absent.
+export function defaultLsAgentTypeMetadata(existingMetadata, parentRunTree) {
+    if ("ls_agent_type" in existingMetadata)
+        return {};
+    return lsAgentTypeMetadata(resolveDefaultLsAgentType(parentRunTree));
+}

package/dist/utils/profiles.cjs

@@ -35,6 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ProfileAuth = exports.DEFAULT_API_URL = void 0;
 exports.hasValue = hasValue;
+exports.resolveTokenEndpoint = resolveTokenEndpoint;
 exports.loadProfileClientConfig = loadProfileClientConfig;
 const env_js_1 = require("./env.cjs");
 const fsUtils = __importStar(require("./fs.cjs"));
@@ -43,6 +44,8 @@ exports.DEFAULT_API_URL = "https://api.smith.langchain.com";
 const OAUTH_CLIENT_ID = "langsmith-cli";
 const TOKEN_REFRESH_LEEWAY_MS = 60_000;
 const TOKEN_REFRESH_TIMEOUT_MS = 10_000;
+const OAUTH_DISCOVERY_TIMEOUT_MS = 5_000;
+const WELL_KNOWN_OAUTH_PATH = "/.well-known/oauth-authorization-server";
 function isBrowserLikeRuntime() {
     const env = (0, env_js_1.getEnv)();
     return env === "browser" || env === "webworker";
@@ -125,6 +128,126 @@ function normalizeConfigUrl(apiUrl) {
         ? normalized.slice(0, -apiV1Suffix.length)
         : normalized;
 }
+/**
+ * Metadata base URLs to probe, most specific first: the configured mount point,
+ * then the self-hosted and SaaS locations, so both a bare origin and an
+ * explicit `/api` resolve.
+ */
+function oauthDiscoveryCandidates(apiUrl) {
+    const given = normalizeConfigUrl(apiUrl);
+    const origin = given.endsWith("/api")
+        ? given.slice(0, -"/api".length)
+        : given;
+    const candidates = [];
+    for (const candidate of [given, `${origin}/api`, origin]) {
+        if (candidate && candidate !== "/api" && !candidates.includes(candidate)) {
+            candidates.push(candidate);
+        }
+    }
+    return candidates;
+}
+/**
+ * Check the document describes the deployment we probed. RFC 8414 requires the
+ * issuer to match the URL the well-known path was built from, and every
+ * endpoint must share the issuer's origin. Refresh tokens are posted to these
+ * endpoints, so an unvalidated document could redirect credentials elsewhere.
+ */
+function isTrustedOAuthMetadata(doc, base) {
+    const { issuer } = doc;
+    if (typeof issuer !== "string" ||
+        issuer.replace(/\/+$/, "") !== base.replace(/\/+$/, "")) {
+        return false;
+    }
+    let issuerUrl;
+    try {
+        issuerUrl = new URL(issuer);
+    }
+    catch {
+        return false;
+    }
+    for (const endpoint of [
+        doc.device_authorization_endpoint,
+        doc.token_endpoint,
+    ]) {
+        if (typeof endpoint !== "string" || !endpoint) {
+            return false;
+        }
+        try {
+            const url = new URL(endpoint);
+            if (url.protocol !== issuerUrl.protocol || url.host !== issuerUrl.host) {
+                return false;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Metadata URLs for an issuer, RFC 8414 form first. RFC 8414 inserts the
+ * well-known segment between the origin and the issuer path, so
+ * `https://host/api` is described at
+ * `https://host/.well-known/oauth-authorization-server/api`. Deployments
+ * commonly also serve the appended form, and for a path-less issuer the two are
+ * identical.
+ */
+function oauthMetadataUrls(base) {
+    const appended = `${base}${WELL_KNOWN_OAUTH_PATH}`;
+    let inserted;
+    try {
+        const url = new URL(base);
+        inserted = `${url.origin}${WELL_KNOWN_OAUTH_PATH}${url.pathname === "/" ? "" : url.pathname}`;
+    }
+    catch {
+        return [appended];
+    }
+    return inserted === appended ? [inserted] : [inserted, appended];
+}
+async function fetchOAuthMetadata(url, base, fetchImplementation) {
+    let response;
+    try {
+        response = await fetchImplementation(url, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(OAUTH_DISCOVERY_TIMEOUT_MS),
+        });
+    }
+    catch {
+        return undefined;
+    }
+    if (!response.ok) {
+        return undefined;
+    }
+    let doc;
+    try {
+        // Self-hosted answers unknown paths with an HTML 200 from the SPA.
+        doc = (await response.json());
+    }
+    catch {
+        return undefined;
+    }
+    if (!doc || typeof doc !== "object" || !isTrustedOAuthMetadata(doc, base)) {
+        return undefined;
+    }
+    return doc;
+}
+/**
+ * Resolve the token endpoint, preferring the deployment's metadata document.
+ * Falls back to `<mount>/oauth/token`, keeping a trailing `/api` because
+ * self-hosted mounts the authorization server under it.
+ */
+async function resolveTokenEndpoint(apiUrl, fetchImplementation) {
+    for (const base of oauthDiscoveryCandidates(apiUrl)) {
+        for (const url of oauthMetadataUrls(base)) {
+            const doc = await fetchOAuthMetadata(url, base, fetchImplementation);
+            if (doc) {
+                return doc.token_endpoint;
+            }
+        }
+    }
+    return `${normalizeConfigUrl(apiUrl)}/oauth/token`;
+}
 function applyTokenResponse(profile, token) {
     profile.oauth ??= {};
     if (token.access_token) {
@@ -262,7 +385,8 @@ class ProfileAuth {
                 client_id: OAUTH_CLIENT_ID,
                 refresh_token: this.state.profile.oauth?.refresh_token ?? refreshToken,
             });
-            const response = await fetchImplementation(`${normalizeConfigUrl(refreshApiUrl)}/oauth/token`, {
+            const tokenEndpoint = await resolveTokenEndpoint(refreshApiUrl, fetchImplementation);
+            const response = await fetchImplementation(tokenEndpoint, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/x-www-form-urlencoded",

package/dist/utils/profiles.d.ts

@@ -33,6 +33,12 @@ export type ProfileClientConfig = {
     profileAuth?: ProfileAuth;
 };
 export declare function hasValue(value?: string | null): boolean;
+/**
+ * Resolve the token endpoint, preferring the deployment's metadata document.
+ * Falls back to `<mount>/oauth/token`, keeping a trailing `/api` because
+ * self-hosted mounts the authorization server under it.
+ */
+export declare function resolveTokenEndpoint(apiUrl: string, fetchImplementation: typeof fetch): Promise<string>;
 export declare function loadProfileClientConfig(): ProfileClientConfig;
 export declare class ProfileAuth {
     private state;

package/dist/utils/profiles.js

@@ -5,6 +5,8 @@ export const DEFAULT_API_URL = "https://api.smith.langchain.com";
 const OAUTH_CLIENT_ID = "langsmith-cli";
 const TOKEN_REFRESH_LEEWAY_MS = 60_000;
 const TOKEN_REFRESH_TIMEOUT_MS = 10_000;
+const OAUTH_DISCOVERY_TIMEOUT_MS = 5_000;
+const WELL_KNOWN_OAUTH_PATH = "/.well-known/oauth-authorization-server";
 function isBrowserLikeRuntime() {
     const env = getEnv();
     return env === "browser" || env === "webworker";
@@ -87,6 +89,126 @@ function normalizeConfigUrl(apiUrl) {
         ? normalized.slice(0, -apiV1Suffix.length)
         : normalized;
 }
+/**
+ * Metadata base URLs to probe, most specific first: the configured mount point,
+ * then the self-hosted and SaaS locations, so both a bare origin and an
+ * explicit `/api` resolve.
+ */
+function oauthDiscoveryCandidates(apiUrl) {
+    const given = normalizeConfigUrl(apiUrl);
+    const origin = given.endsWith("/api")
+        ? given.slice(0, -"/api".length)
+        : given;
+    const candidates = [];
+    for (const candidate of [given, `${origin}/api`, origin]) {
+        if (candidate && candidate !== "/api" && !candidates.includes(candidate)) {
+            candidates.push(candidate);
+        }
+    }
+    return candidates;
+}
+/**
+ * Check the document describes the deployment we probed. RFC 8414 requires the
+ * issuer to match the URL the well-known path was built from, and every
+ * endpoint must share the issuer's origin. Refresh tokens are posted to these
+ * endpoints, so an unvalidated document could redirect credentials elsewhere.
+ */
+function isTrustedOAuthMetadata(doc, base) {
+    const { issuer } = doc;
+    if (typeof issuer !== "string" ||
+        issuer.replace(/\/+$/, "") !== base.replace(/\/+$/, "")) {
+        return false;
+    }
+    let issuerUrl;
+    try {
+        issuerUrl = new URL(issuer);
+    }
+    catch {
+        return false;
+    }
+    for (const endpoint of [
+        doc.device_authorization_endpoint,
+        doc.token_endpoint,
+    ]) {
+        if (typeof endpoint !== "string" || !endpoint) {
+            return false;
+        }
+        try {
+            const url = new URL(endpoint);
+            if (url.protocol !== issuerUrl.protocol || url.host !== issuerUrl.host) {
+                return false;
+            }
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Metadata URLs for an issuer, RFC 8414 form first. RFC 8414 inserts the
+ * well-known segment between the origin and the issuer path, so
+ * `https://host/api` is described at
+ * `https://host/.well-known/oauth-authorization-server/api`. Deployments
+ * commonly also serve the appended form, and for a path-less issuer the two are
+ * identical.
+ */
+function oauthMetadataUrls(base) {
+    const appended = `${base}${WELL_KNOWN_OAUTH_PATH}`;
+    let inserted;
+    try {
+        const url = new URL(base);
+        inserted = `${url.origin}${WELL_KNOWN_OAUTH_PATH}${url.pathname === "/" ? "" : url.pathname}`;
+    }
+    catch {
+        return [appended];
+    }
+    return inserted === appended ? [inserted] : [inserted, appended];
+}
+async function fetchOAuthMetadata(url, base, fetchImplementation) {
+    let response;
+    try {
+        response = await fetchImplementation(url, {
+            method: "GET",
+            headers: { Accept: "application/json" },
+            signal: AbortSignal.timeout(OAUTH_DISCOVERY_TIMEOUT_MS),
+        });
+    }
+    catch {
+        return undefined;
+    }
+    if (!response.ok) {
+        return undefined;
+    }
+    let doc;
+    try {
+        // Self-hosted answers unknown paths with an HTML 200 from the SPA.
+        doc = (await response.json());
+    }
+    catch {
+        return undefined;
+    }
+    if (!doc || typeof doc !== "object" || !isTrustedOAuthMetadata(doc, base)) {
+        return undefined;
+    }
+    return doc;
+}
+/**
+ * Resolve the token endpoint, preferring the deployment's metadata document.
+ * Falls back to `<mount>/oauth/token`, keeping a trailing `/api` because
+ * self-hosted mounts the authorization server under it.
+ */
+export async function resolveTokenEndpoint(apiUrl, fetchImplementation) {
+    for (const base of oauthDiscoveryCandidates(apiUrl)) {
+        for (const url of oauthMetadataUrls(base)) {
+            const doc = await fetchOAuthMetadata(url, base, fetchImplementation);
+            if (doc) {
+                return doc.token_endpoint;
+            }
+        }
+    }
+    return `${normalizeConfigUrl(apiUrl)}/oauth/token`;
+}
 function applyTokenResponse(profile, token) {
     profile.oauth ??= {};
     if (token.access_token) {
@@ -224,7 +346,8 @@ export class ProfileAuth {
                 client_id: OAUTH_CLIENT_ID,
                 refresh_token: this.state.profile.oauth?.refresh_token ?? refreshToken,
             });
-            const response = await fetchImplementation(`${normalizeConfigUrl(refreshApiUrl)}/oauth/token`, {
+            const tokenEndpoint = await resolveTokenEndpoint(refreshApiUrl, fetchImplementation);
+            const response = await fetchImplementation(tokenEndpoint, {
                 method: "POST",
                 headers: {
                     "Content-Type": "application/x-www-form-urlencoded",

package/dist/wrappers/openai.cjs

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.wrapOpenAI = void 0;
 const traceable_js_1 = require("../traceable.cjs");
+const traceable_js_2 = require("../singletons/traceable.cjs");
+const ls_agent_type_js_1 = require("../utils/ls_agent_type.cjs");
 const TRACED_INVOCATION_KEYS = [
     "frequency_penalty",
     "n",
@@ -261,6 +263,7 @@ const getChatModelInvocationParamsFn = (provider, prepopulatedInvocationParams,
                 ...prepopulatedInvocationParams,
                 ...ls_invocation_params,
             },
+            ...(0, ls_agent_type_js_1.defaultLsAgentTypeMetadata)(requestMetadata, (0, traceable_js_2.getCurrentRunTree)(true)),
         };
     };
 };
@@ -416,6 +419,7 @@ const wrapOpenAI = (openai, options) => {
                         ...prepopulatedInvocationParams,
                         ...ls_invocation_params,
                     },
+                    ...(0, ls_agent_type_js_1.defaultLsAgentTypeMetadata)({}, (0, traceable_js_2.getCurrentRunTree)(true)),
                 };
             },
             ...cleanedOptions,

package/dist/wrappers/openai.js

@@ -1,4 +1,6 @@
 import { isTraceableFunction, traceable, } from "../traceable.js";
+import { getCurrentRunTree } from "../singletons/traceable.js";
+import { defaultLsAgentTypeMetadata } from "../utils/ls_agent_type.js";
 const TRACED_INVOCATION_KEYS = [
     "frequency_penalty",
     "n",
@@ -258,6 +260,7 @@ const getChatModelInvocationParamsFn = (provider, prepopulatedInvocationParams,
                 ...prepopulatedInvocationParams,
                 ...ls_invocation_params,
             },
+            ...defaultLsAgentTypeMetadata(requestMetadata, getCurrentRunTree(true)),
         };
     };
 };
@@ -413,6 +416,7 @@ export const wrapOpenAI = (openai, options) => {
                         ...prepopulatedInvocationParams,
                         ...ls_invocation_params,
                     },
+                    ...defaultLsAgentTypeMetadata({}, getCurrentRunTree(true)),
                 };
             },
             ...cleanedOptions,

package/dist/wrappers/openai_agents.cjs

@@ -10,6 +10,7 @@ const node_async_hooks_1 = require("node:async_hooks");
 const run_trees_js_1 = require("../run_trees.cjs");
 const client_js_1 = require("../client.cjs");
 const traceable_js_1 = require("../singletons/traceable.cjs");
+const ls_agent_type_js_1 = require("../utils/ls_agent_type.cjs");
 traceable_js_1.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new node_async_hooks_1.AsyncLocalStorage());
 /**
  * Set the current AsyncLocalStorage store to the given RunTree without a
@@ -521,14 +522,15 @@ class OpenAIAgentsTracingProcessor {
         else {
             runName = "Agent workflow";
         }
-        // Build metadata
-        const runExtra = {
-            metadata: {
-                ...this._metadata,
-                ls_integration: "openai-agents-sdk",
-                ls_agent_type: "root",
-            },
+        // Merge three sources: processor defaults, trace.metadata (user's per-run
+        // ls_agent_type), and force-set ls_integration.
+        const mergedMetadata = {
+            ...this._metadata,
+            ...(trace.metadata ?? {}),
+            ls_integration: "openai-agents-sdk",
         };
+        Object.assign(mergedMetadata, (0, ls_agent_type_js_1.defaultLsAgentTypeMetadata)(mergedMetadata, currentRunTree));
+        const runExtra = { metadata: mergedMetadata };
         const traceDict = trace.toJSON() ?? {};
         const groupId = trace.groupId ??
             traceDict.groupId ??
@@ -589,9 +591,10 @@ class OpenAIAgentsTracingProcessor {
         }
         this._runs.delete(trace.traceId);
         const traceDict = trace.toJSON() ?? {};
+        // trace.metadata may have new keys since onTraceStart; pull them in.
         const metadata = {
-            ...traceDict.metadata,
             ...this._metadata,
+            ...traceDict.metadata,
         };
         try {
             // Update run with final inputs/outputs
@@ -695,10 +698,10 @@ class OpenAIAgentsTracingProcessor {
                 if (!childRun.extra.metadata) {
                     childRun.extra.metadata = {};
                 }
-                childRun.extra.metadata = {
-                    ...childRun.extra.metadata,
-                    ls_agent_type: "subagent",
-                };
+                const meta = childRun.extra.metadata;
+                if (!ls_agent_type_js_1.NON_ROOT_LS_AGENT_TYPES.has(meta.ls_agent_type)) {
+                    meta.ls_agent_type = "subagent";
+                }
             }
         }
         // Track span data type for parent lookups

package/dist/wrappers/openai_agents.js

@@ -7,6 +7,7 @@ import { AsyncLocalStorage } from "node:async_hooks";
 import { RunTree } from "../run_trees.js";
 import { Client } from "../client.js";
 import { AsyncLocalStorageProviderSingleton, getCurrentRunTree, } from "../singletons/traceable.js";
+import { NON_ROOT_LS_AGENT_TYPES, defaultLsAgentTypeMetadata, } from "../utils/ls_agent_type.js";
 AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new AsyncLocalStorage());
 /**
  * Set the current AsyncLocalStorage store to the given RunTree without a
@@ -518,14 +519,15 @@ export class OpenAIAgentsTracingProcessor {
         else {
             runName = "Agent workflow";
         }
-        // Build metadata
-        const runExtra = {
-            metadata: {
-                ...this._metadata,
-                ls_integration: "openai-agents-sdk",
-                ls_agent_type: "root",
-            },
+        // Merge three sources: processor defaults, trace.metadata (user's per-run
+        // ls_agent_type), and force-set ls_integration.
+        const mergedMetadata = {
+            ...this._metadata,
+            ...(trace.metadata ?? {}),
+            ls_integration: "openai-agents-sdk",
         };
+        Object.assign(mergedMetadata, defaultLsAgentTypeMetadata(mergedMetadata, currentRunTree));
+        const runExtra = { metadata: mergedMetadata };
         const traceDict = trace.toJSON() ?? {};
         const groupId = trace.groupId ??
             traceDict.groupId ??
@@ -586,9 +588,10 @@ export class OpenAIAgentsTracingProcessor {
         }
         this._runs.delete(trace.traceId);
         const traceDict = trace.toJSON() ?? {};
+        // trace.metadata may have new keys since onTraceStart; pull them in.
         const metadata = {
-            ...traceDict.metadata,
             ...this._metadata,
+            ...traceDict.metadata,
         };
         try {
             // Update run with final inputs/outputs
@@ -692,10 +695,10 @@ export class OpenAIAgentsTracingProcessor {
                 if (!childRun.extra.metadata) {
                     childRun.extra.metadata = {};
                 }
-                childRun.extra.metadata = {
-                    ...childRun.extra.metadata,
-                    ls_agent_type: "subagent",
-                };
+                const meta = childRun.extra.metadata;
+                if (!NON_ROOT_LS_AGENT_TYPES.has(meta.ls_agent_type)) {
+                    meta.ls_agent_type = "subagent";
+                }
             }
         }
         // Track span data type for parent lookups

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.8.9",
+  "version": "0.8.10",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "pnpm@10.33.0",
   "files": [