langsmith 0.10.6 → 0.10.8

package/dist/address.cjs

@@ -1,31 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EnvAddressError = void 0;
-exports.normalizeAddress = normalizeAddress;
-exports.wireKeys = wireKeys;
+exports.address = exports.EnvAddressError = void 0;
+exports.agent = agent;
+exports.parse = parse;
+exports.fromEnv = fromEnv;
 exports.envNames = envNames;
-exports.toWire = toWire;
-exports.fromWire = fromWire;
-exports.addressFromEnv = addressFromEnv;
-exports.seed = seed;
-exports.sameAddress = sameAddress;
-// Wire key per field; env var is `LANGSMITH_<WIRE KEY>`.
-const FIELDS = {
-    agentId: "agent_id",
-    agentEnvironment: "agent_environment",
-};
+/**
+ * (beta) Addresses that name where runs are sent instead of a project.
+ * Enabled per workspace; a workspace without it rejects the runs.
+ *
+ * An address is a plain string, `lrn:agents/{id}/environments/{environment}`,
+ * typed as a template literal so a literal is checked at compile time. A
+ * dynamic `string` goes through `address.parse`, which validates it at
+ * runtime (JS callers are validated the same way). The environment is always
+ * rendered lowercase.
+ *
+ * @example
+ * ```ts
+ * import { address, traceable } from "langsmith";
+ *
+ * const support = address.agent("customer-support", "production");
+ * const handle = traceable(fn, { address: support });
+ * // or a literal: { address: "lrn:agents/customer-support/environments/staging" }
+ * ```
+ */
+const env_js_1 = require("./utils/env.cjs");
 // The server's agent id rule: a DNS label, so a hostname can carry the id.
 const AGENT_ID_PATTERN = /^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/;
-// Not `utils/env`: it imports the package index, which imports this module.
-function getEnv(name) {
-    try {
-        // eslint-disable-next-line no-process-env
-        return typeof process !== "undefined" ? process.env?.[name] : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
+const ENVIRONMENTS = [
+    "local",
+    "development",
+    "staging",
+    "production",
+];
+const ADDRESS_PATTERN = /^lrn:agents\/([^/]*)\/environments\/([^/]*)$/;
+const ENV_NAMES = ["LANGSMITH_AGENT_ID", "LANGSMITH_AGENT_ENVIRONMENT"];
 /** The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
 class EnvAddressError extends Error {
     constructor(message) {
@@ -35,85 +44,66 @@ class EnvAddressError extends Error {
 }
 exports.EnvAddressError = EnvAddressError;
 /**
- * @internal Validate `value` and return a frozen copy of its fields.
- * @throws If it isn't an object with exactly the address fields, or a value is invalid.
+ * (beta) Build the address of an agent's environment.
+ * @param agentId 1 to 63 lowercase ASCII letters, digits or hyphens, starting
+ *   with a letter and ending with a letter or digit.
+ * @param agentEnvironment One of `local`, `development`, `staging` or
+ *   `production`, in any case.
+ * @throws If a value is invalid.
  */
-function normalizeAddress(value) {
-    if (value == null || typeof value !== "object" || Array.isArray(value)) {
-        throw new Error("`address` must be an object: { agentId, agentEnvironment }.");
-    }
-    const fields = value;
-    const unknown = Object.keys(fields).filter((key) => !(key in FIELDS));
-    if (unknown.length > 0) {
-        throw new Error(`Unknown address fields: ${unknown.join(", ")}.`);
-    }
-    for (const name of Object.keys(FIELDS)) {
-        const field = fields[name];
-        if (typeof field !== "string" || field === "") {
-            throw new Error(`Address ${name} must be a non-empty string.`);
-        }
-    }
-    const { agentId, agentEnvironment } = fields;
-    if (!AGENT_ID_PATTERN.test(agentId)) {
-        throw new Error("Address agentId must be 1 to 63 lowercase ASCII letters, digits, or " +
+function agent(agentId, agentEnvironment) {
+    if (typeof agentId !== "string" || !AGENT_ID_PATTERN.test(agentId)) {
+        throw new Error("Address agent id must be 1 to 63 lowercase ASCII letters, digits, or " +
             "hyphens, start with a letter, and end with a letter or digit, got " +
             `${JSON.stringify(agentId)}. Use an id such as "support-agent".`);
     }
-    return Object.freeze({ agentId, agentEnvironment });
-}
-/** @internal */
-function wireKeys() {
-    return Object.values(FIELDS);
-}
-/** @internal */
-function envNames() {
-    return wireKeys().map((key) => `LANGSMITH_${key.toUpperCase()}`);
-}
-/** @internal */
-function toWire(address) {
-    return {
-        [FIELDS.agentId]: address.agentId,
-        [FIELDS.agentEnvironment]: address.agentEnvironment,
-    };
-}
-/** @internal `undefined` if no field is set; throws if only some are. */
-function fromWire(values) {
-    const fields = Object.fromEntries(Object.entries(FIELDS).map(([name, key]) => [
-        name,
-        values[key] ?? undefined,
-    ]));
-    const missing = Object.entries(FIELDS)
-        .filter(([name]) => fields[name] === undefined)
-        .map(([, key]) => key);
-    if (missing.length === Object.keys(FIELDS).length) {
-        return undefined;
+    const environment = typeof agentEnvironment === "string"
+        ? agentEnvironment.toLowerCase()
+        : undefined;
+    if (environment === undefined || !ENVIRONMENTS.includes(environment)) {
+        throw new Error(`Address environment must be one of ${ENVIRONMENTS.join(", ")}, got ` +
+            `${JSON.stringify(agentEnvironment)}.`);
     }
-    if (missing.length > 0) {
-        throw new Error(`An address needs ${missing.join(" and ")} as well.`);
+    return `lrn:agents/${agentId}/environments/${environment}`;
+}
+/**
+ * (beta) Validate an address string, lowercasing its environment.
+ * Only agent addresses, `lrn:agents/{id}/environments/{environment}`, exist.
+ * @throws If `value` is not a valid agent address.
+ */
+function parse(value) {
+    const match = typeof value === "string" ? ADDRESS_PATTERN.exec(value) : undefined;
+    if (!match) {
+        throw new Error("An address must be a string like " +
+            `"lrn:agents/{id}/environments/{environment}", got ${JSON.stringify(value)}.`);
     }
-    return normalizeAddress(fields);
+    return agent(match[1], match[2]);
 }
 /**
- * @internal
- * @throws {EnvAddressError} If only some `LANGSMITH_AGENT_*` vars are set, or one is invalid.
+ * (beta) Read the address named by `LANGSMITH_AGENT_ID` and
+ * `LANGSMITH_AGENT_ENVIRONMENT`; `undefined` if neither is set.
+ * @throws {EnvAddressError} If only one is set, or a value is invalid.
  */
-function addressFromEnv() {
-    const values = Object.fromEntries(wireKeys().map((key, i) => [key, getEnv(envNames()[i]) || undefined]));
+function fromEnv() {
+    const values = ENV_NAMES.map((name) => (0, env_js_1.getEnvironmentVariable)(name));
+    if (!values.some(Boolean)) {
+        return undefined;
+    }
     try {
-        return fromWire(values);
+        const missing = ENV_NAMES.filter((_, i) => !values[i]);
+        if (missing.length > 0) {
+            throw new Error(`An address needs ${missing.join(" and ")} as well.`);
+        }
+        return agent(values[0], values[1]);
     }
     catch (e) {
-        throw new EnvAddressError(`The LANGSMITH_AGENT_* env vars can't address a run: ${e.message}`);
+        const present = ENV_NAMES.flatMap((name, i) => values[i] ? [`${name}=${JSON.stringify(values[i])}`] : []).join(", ");
+        throw new EnvAddressError(`The LANGSMITH_AGENT_* env vars can't address a run (${present}): ${e.message}`);
     }
 }
-/** @internal Replica id derivation seed. */
-function seed(address) {
-    return ["agent", ...Object.values(toWire(address))].join("/");
-}
-/** @internal */
-function sameAddress(a, b) {
-    if (!a || !b) {
-        return a === b;
-    }
-    return a.agentId === b.agentId && a.agentEnvironment === b.agentEnvironment;
+/** (beta) Build, validate and read addresses. */
+exports.address = { agent, parse, fromEnv };
+/** @internal The `LANGSMITH_AGENT_*` env var names an address reads. */
+function envNames() {
+    return ENV_NAMES;
 }

package/dist/address.d.ts

@@ -1,13 +1,35 @@
-/**
- * (beta) An address that runs are sent to instead of a project.
- * Enabled per workspace; a workspace without it rejects the runs.
- */
-export interface Address {
-    /** 1 to 63 lowercase ASCII letters, digits or hyphens; starts with a letter. */
-    agentId: string;
-    agentEnvironment: string;
-}
+/** (beta) An agent environment. */
+export type Environment = "local" | "development" | "staging" | "production";
+/** (beta) An address string, `lrn:agents/{id}/environments/{environment}`. */
+export type Address = `lrn:agents/${string}/environments/${Environment}`;
 /** The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
 export declare class EnvAddressError extends Error {
     constructor(message: string);
 }
+/**
+ * (beta) Build the address of an agent's environment.
+ * @param agentId 1 to 63 lowercase ASCII letters, digits or hyphens, starting
+ *   with a letter and ending with a letter or digit.
+ * @param agentEnvironment One of `local`, `development`, `staging` or
+ *   `production`, in any case.
+ * @throws If a value is invalid.
+ */
+export declare function agent(agentId: string, agentEnvironment: Environment | (string & {})): Address;
+/**
+ * (beta) Validate an address string, lowercasing its environment.
+ * Only agent addresses, `lrn:agents/{id}/environments/{environment}`, exist.
+ * @throws If `value` is not a valid agent address.
+ */
+export declare function parse(value: string): Address;
+/**
+ * (beta) Read the address named by `LANGSMITH_AGENT_ID` and
+ * `LANGSMITH_AGENT_ENVIRONMENT`; `undefined` if neither is set.
+ * @throws {EnvAddressError} If only one is set, or a value is invalid.
+ */
+export declare function fromEnv(): Address | undefined;
+/** (beta) Build, validate and read addresses. */
+export declare const address: {
+    agent: typeof agent;
+    parse: typeof parse;
+    fromEnv: typeof fromEnv;
+};

package/dist/address.js

@@ -1,20 +1,33 @@
-// Wire key per field; env var is `LANGSMITH_<WIRE KEY>`.
-const FIELDS = {
-    agentId: "agent_id",
-    agentEnvironment: "agent_environment",
-};
+/**
+ * (beta) Addresses that name where runs are sent instead of a project.
+ * Enabled per workspace; a workspace without it rejects the runs.
+ *
+ * An address is a plain string, `lrn:agents/{id}/environments/{environment}`,
+ * typed as a template literal so a literal is checked at compile time. A
+ * dynamic `string` goes through `address.parse`, which validates it at
+ * runtime (JS callers are validated the same way). The environment is always
+ * rendered lowercase.
+ *
+ * @example
+ * ```ts
+ * import { address, traceable } from "langsmith";
+ *
+ * const support = address.agent("customer-support", "production");
+ * const handle = traceable(fn, { address: support });
+ * // or a literal: { address: "lrn:agents/customer-support/environments/staging" }
+ * ```
+ */
+import { getEnvironmentVariable } from "./utils/env.js";
 // The server's agent id rule: a DNS label, so a hostname can carry the id.
 const AGENT_ID_PATTERN = /^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$/;
-// Not `utils/env`: it imports the package index, which imports this module.
-function getEnv(name) {
-    try {
-        // eslint-disable-next-line no-process-env
-        return typeof process !== "undefined" ? process.env?.[name] : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
+const ENVIRONMENTS = [
+    "local",
+    "development",
+    "staging",
+    "production",
+];
+const ADDRESS_PATTERN = /^lrn:agents\/([^/]*)\/environments\/([^/]*)$/;
+const ENV_NAMES = ["LANGSMITH_AGENT_ID", "LANGSMITH_AGENT_ENVIRONMENT"];
 /** The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
 export class EnvAddressError extends Error {
     constructor(message) {
@@ -23,85 +36,66 @@ export class EnvAddressError extends Error {
     }
 }
 /**
- * @internal Validate `value` and return a frozen copy of its fields.
- * @throws If it isn't an object with exactly the address fields, or a value is invalid.
+ * (beta) Build the address of an agent's environment.
+ * @param agentId 1 to 63 lowercase ASCII letters, digits or hyphens, starting
+ *   with a letter and ending with a letter or digit.
+ * @param agentEnvironment One of `local`, `development`, `staging` or
+ *   `production`, in any case.
+ * @throws If a value is invalid.
  */
-export function normalizeAddress(value) {
-    if (value == null || typeof value !== "object" || Array.isArray(value)) {
-        throw new Error("`address` must be an object: { agentId, agentEnvironment }.");
-    }
-    const fields = value;
-    const unknown = Object.keys(fields).filter((key) => !(key in FIELDS));
-    if (unknown.length > 0) {
-        throw new Error(`Unknown address fields: ${unknown.join(", ")}.`);
-    }
-    for (const name of Object.keys(FIELDS)) {
-        const field = fields[name];
-        if (typeof field !== "string" || field === "") {
-            throw new Error(`Address ${name} must be a non-empty string.`);
-        }
-    }
-    const { agentId, agentEnvironment } = fields;
-    if (!AGENT_ID_PATTERN.test(agentId)) {
-        throw new Error("Address agentId must be 1 to 63 lowercase ASCII letters, digits, or " +
+export function agent(agentId, agentEnvironment) {
+    if (typeof agentId !== "string" || !AGENT_ID_PATTERN.test(agentId)) {
+        throw new Error("Address agent id must be 1 to 63 lowercase ASCII letters, digits, or " +
             "hyphens, start with a letter, and end with a letter or digit, got " +
             `${JSON.stringify(agentId)}. Use an id such as "support-agent".`);
     }
-    return Object.freeze({ agentId, agentEnvironment });
-}
-/** @internal */
-export function wireKeys() {
-    return Object.values(FIELDS);
-}
-/** @internal */
-export function envNames() {
-    return wireKeys().map((key) => `LANGSMITH_${key.toUpperCase()}`);
-}
-/** @internal */
-export function toWire(address) {
-    return {
-        [FIELDS.agentId]: address.agentId,
-        [FIELDS.agentEnvironment]: address.agentEnvironment,
-    };
-}
-/** @internal `undefined` if no field is set; throws if only some are. */
-export function fromWire(values) {
-    const fields = Object.fromEntries(Object.entries(FIELDS).map(([name, key]) => [
-        name,
-        values[key] ?? undefined,
-    ]));
-    const missing = Object.entries(FIELDS)
-        .filter(([name]) => fields[name] === undefined)
-        .map(([, key]) => key);
-    if (missing.length === Object.keys(FIELDS).length) {
-        return undefined;
+    const environment = typeof agentEnvironment === "string"
+        ? agentEnvironment.toLowerCase()
+        : undefined;
+    if (environment === undefined || !ENVIRONMENTS.includes(environment)) {
+        throw new Error(`Address environment must be one of ${ENVIRONMENTS.join(", ")}, got ` +
+            `${JSON.stringify(agentEnvironment)}.`);
     }
-    if (missing.length > 0) {
-        throw new Error(`An address needs ${missing.join(" and ")} as well.`);
+    return `lrn:agents/${agentId}/environments/${environment}`;
+}
+/**
+ * (beta) Validate an address string, lowercasing its environment.
+ * Only agent addresses, `lrn:agents/{id}/environments/{environment}`, exist.
+ * @throws If `value` is not a valid agent address.
+ */
+export function parse(value) {
+    const match = typeof value === "string" ? ADDRESS_PATTERN.exec(value) : undefined;
+    if (!match) {
+        throw new Error("An address must be a string like " +
+            `"lrn:agents/{id}/environments/{environment}", got ${JSON.stringify(value)}.`);
     }
-    return normalizeAddress(fields);
+    return agent(match[1], match[2]);
 }
 /**
- * @internal
- * @throws {EnvAddressError} If only some `LANGSMITH_AGENT_*` vars are set, or one is invalid.
+ * (beta) Read the address named by `LANGSMITH_AGENT_ID` and
+ * `LANGSMITH_AGENT_ENVIRONMENT`; `undefined` if neither is set.
+ * @throws {EnvAddressError} If only one is set, or a value is invalid.
  */
-export function addressFromEnv() {
-    const values = Object.fromEntries(wireKeys().map((key, i) => [key, getEnv(envNames()[i]) || undefined]));
+export function fromEnv() {
+    const values = ENV_NAMES.map((name) => getEnvironmentVariable(name));
+    if (!values.some(Boolean)) {
+        return undefined;
+    }
     try {
-        return fromWire(values);
+        const missing = ENV_NAMES.filter((_, i) => !values[i]);
+        if (missing.length > 0) {
+            throw new Error(`An address needs ${missing.join(" and ")} as well.`);
+        }
+        return agent(values[0], values[1]);
     }
     catch (e) {
-        throw new EnvAddressError(`The LANGSMITH_AGENT_* env vars can't address a run: ${e.message}`);
+        const present = ENV_NAMES.flatMap((name, i) => values[i] ? [`${name}=${JSON.stringify(values[i])}`] : []).join(", ");
+        throw new EnvAddressError(`The LANGSMITH_AGENT_* env vars can't address a run (${present}): ${e.message}`);
     }
 }
-/** @internal Replica id derivation seed. */
-export function seed(address) {
-    return ["agent", ...Object.values(toWire(address))].join("/");
-}
-/** @internal */
-export function sameAddress(a, b) {
-    if (!a || !b) {
-        return a === b;
-    }
-    return a.agentId === b.agentId && a.agentEnvironment === b.agentEnvironment;
+/** (beta) Build, validate and read addresses. */
+export const address = { agent, parse, fromEnv };
+/** @internal The `LANGSMITH_AGENT_*` env var names an address reads. */
+export function envNames() {
+    return ENV_NAMES;
 }

package/dist/client.cjs

@@ -3987,7 +3987,7 @@ class Client {
         if (samplingId != null && !this._shouldSample(samplingId)) {
             return feedback;
         }
-        const body = JSON.stringify(address ? { ...feedback, ...(0, address_js_1.toWire)(address) } : feedback);
+        const body = JSON.stringify(address ? { ...feedback, address } : feedback);
         const url = `${this.apiUrl}/feedback`;
         await this.caller.call(async () => {
             const res = await this._fetch(url, {

package/dist/client.js

@@ -9,7 +9,7 @@ import { Langsmith as OpenAPILangsmith } from "./_openapi_client/index.js";
 import { assertUuid } from "./utils/_uuid.js";
 import { isSampledById } from "./utils/sampling.js";
 import { warnOnce } from "./utils/warn.js";
-import { EnvAddressError, toWire } from "./address.js";
+import { EnvAddressError } from "./address.js";
 import { applyToPayload, checkAddress, logUntraced, rejectConflicting, resolveFromEnv, warnOnEnv, } from "./utils/agent_addressing.js";
 import { getQueryBackend, QueryBackend } from "./utils/v2_migration.js";
 import { parseHubIdentifier } from "./utils/prompts.js";
@@ -3948,7 +3948,7 @@ export class Client {
         if (samplingId != null && !this._shouldSample(samplingId)) {
             return feedback;
         }
-        const body = JSON.stringify(address ? { ...feedback, ...toWire(address) } : feedback);
+        const body = JSON.stringify(address ? { ...feedback, address } : feedback);
         const url = `${this.apiUrl}/feedback`;
         await this.caller.call(async () => {
             const res = await this._fetch(url, {

package/dist/experimental/otel/exporter.cjs

@@ -39,6 +39,7 @@ const constants = __importStar(require("./constants.cjs"));
 const env_js_1 = require("../../env.cjs");
 const env_js_2 = require("../../utils/env.cjs");
 const vercel_js_1 = require("../../utils/vercel.cjs");
+const warn_js_1 = require("../../utils/warn.cjs");
 /**
  * Convert headers string in format "name=value,name2=value2" to object
  */
@@ -60,8 +61,10 @@ function parseHeadersString(headersStr) {
  *
  * This exporter automatically configures itself with LangSmith endpoints and API keys,
  * based on your LANGSMITH_API_KEY and LANGSMITH_PROJECT environment variables.
- * Will also respect OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_EXPORTER_OTLP_HEADERS environment
- * variables if set.
+ * OTEL_EXPORTER_OTLP_TRACES_ENDPOINT is a full traces URL and takes precedence over
+ * OTEL_EXPORTER_OTLP_ENDPOINT, a base URL to which /v1/traces is appended unless
+ * it already ends in /traces for compatibility.
+ * Also respects OTEL_EXPORTER_OTLP_HEADERS if set.
  *
  * @param config - Optional configuration object that accepts all OTLPTraceExporter parameters.
  *                 If not provided, uses default LangSmith configuration:
@@ -74,8 +77,22 @@ class LangSmithOTLPTraceExporter extends exporter_trace_otlp_proto_1.OTLPTraceEx
         const defaultLsEndpoint = (0, env_js_2.getLangSmithEnvironmentVariable)("ENDPOINT") ||
             "https://api.smith.langchain.com";
         const defaultBaseUrl = defaultLsEndpoint.replace(/\/$/, "");
-        const defaultUrl = (0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_ENDPOINT") ??
-            `${defaultBaseUrl}/otel/v1/traces`;
+        const baseEndpoint = (0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_ENDPOINT") ||
+            `${defaultBaseUrl}/otel`;
+        const defaultUrl = (0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_TRACES_ENDPOINT") ||
+            (baseEndpoint.endsWith("/traces")
+                ? baseEndpoint
+                : `${baseEndpoint.replace(/\/$/, "")}/v1/traces`);
+        if (config?.url === undefined &&
+            !(0, env_js_2.getEnvironmentVariable)("OTEL_EXPORTER_OTLP_TRACES_ENDPOINT") &&
+            baseEndpoint.endsWith("/traces")) {
+            (0, warn_js_1.warnOnce)("LangSmith now treats OTEL_EXPORTER_OTLP_ENDPOINT as a base URL and " +
+                "appends /v1/traces. Your value ends in /traces, so it is being " +
+                "preserved unchanged for compatibility. This fallback will be " +
+                "removed in the v1 release of the SDK. Move this full URL to " +
+                "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT to use standard OpenTelemetry " +
+                "configuration.");
+        }
         // Configure headers with API key and project if available
         let headers = config?.headers;
         if (headers === undefined) {

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

@@ -43,8 +43,10 @@ export type LangSmithOTLPTraceExporterConfig = ConstructorParameters<typeof OTLP
  *
  * This exporter automatically configures itself with LangSmith endpoints and API keys,
  * based on your LANGSMITH_API_KEY and LANGSMITH_PROJECT environment variables.
- * Will also respect OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_EXPORTER_OTLP_HEADERS environment
- * variables if set.
+ * OTEL_EXPORTER_OTLP_TRACES_ENDPOINT is a full traces URL and takes precedence over
+ * OTEL_EXPORTER_OTLP_ENDPOINT, a base URL to which /v1/traces is appended unless
+ * it already ends in /traces for compatibility.
+ * Also respects OTEL_EXPORTER_OTLP_HEADERS if set.
  *
  * @param config - Optional configuration object that accepts all OTLPTraceExporter parameters.
  *                 If not provided, uses default LangSmith configuration:

package/dist/experimental/otel/exporter.js

@@ -3,6 +3,7 @@ import * as constants from "./constants.js";
 import { isEnvTracingEnabled } from "../../env.js";
 import { getEnvironmentVariable, getLangSmithEnvironmentVariable, } from "../../utils/env.js";
 import { extractUsageMetadata } from "../../utils/vercel.js";
+import { warnOnce } from "../../utils/warn.js";
 /**
  * Convert headers string in format "name=value,name2=value2" to object
  */
@@ -24,8 +25,10 @@ function parseHeadersString(headersStr) {
  *
  * This exporter automatically configures itself with LangSmith endpoints and API keys,
  * based on your LANGSMITH_API_KEY and LANGSMITH_PROJECT environment variables.
- * Will also respect OTEL_EXPORTER_OTLP_ENDPOINT or OTEL_EXPORTER_OTLP_HEADERS environment
- * variables if set.
+ * OTEL_EXPORTER_OTLP_TRACES_ENDPOINT is a full traces URL and takes precedence over
+ * OTEL_EXPORTER_OTLP_ENDPOINT, a base URL to which /v1/traces is appended unless
+ * it already ends in /traces for compatibility.
+ * Also respects OTEL_EXPORTER_OTLP_HEADERS if set.
  *
  * @param config - Optional configuration object that accepts all OTLPTraceExporter parameters.
  *                 If not provided, uses default LangSmith configuration:
@@ -38,8 +41,22 @@ export class LangSmithOTLPTraceExporter extends OTLPTraceExporter {
         const defaultLsEndpoint = getLangSmithEnvironmentVariable("ENDPOINT") ||
             "https://api.smith.langchain.com";
         const defaultBaseUrl = defaultLsEndpoint.replace(/\/$/, "");
-        const defaultUrl = getEnvironmentVariable("OTEL_EXPORTER_OTLP_ENDPOINT") ??
-            `${defaultBaseUrl}/otel/v1/traces`;
+        const baseEndpoint = getEnvironmentVariable("OTEL_EXPORTER_OTLP_ENDPOINT") ||
+            `${defaultBaseUrl}/otel`;
+        const defaultUrl = getEnvironmentVariable("OTEL_EXPORTER_OTLP_TRACES_ENDPOINT") ||
+            (baseEndpoint.endsWith("/traces")
+                ? baseEndpoint
+                : `${baseEndpoint.replace(/\/$/, "")}/v1/traces`);
+        if (config?.url === undefined &&
+            !getEnvironmentVariable("OTEL_EXPORTER_OTLP_TRACES_ENDPOINT") &&
+            baseEndpoint.endsWith("/traces")) {
+            warnOnce("LangSmith now treats OTEL_EXPORTER_OTLP_ENDPOINT as a base URL and " +
+                "appends /v1/traces. Your value ends in /traces, so it is being " +
+                "preserved unchanged for compatibility. This fallback will be " +
+                "removed in the v1 release of the SDK. Move this full URL to " +
+                "OTEL_EXPORTER_OTLP_TRACES_ENDPOINT to use standard OpenTelemetry " +
+                "configuration.");
+        }
         // Configure headers with API key and project if available
         let headers = config?.headers;
         if (headers === undefined) {

package/dist/index.cjs

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LS_MESSAGE_VIEW_EXCLUDE = exports.__version__ = exports.InternalServerError = exports.RateLimitError = exports.UnprocessableEntityError = exports.ConflictError = exports.NotFoundError = exports.PermissionDeniedError = exports.AuthenticationError = exports.BadRequestError = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.APIUserAbortError = exports.APIError = exports.LangsmithError = exports.promptCacheSingleton = exports.configureGlobalPromptCache = exports.PromptCache = exports.Cache = exports.isTracingEnabled = exports.uuid7FromTime = exports.uuid7 = exports.computeRunIdForSecondaryReplica = exports.getDefaultProjectName = exports.overrideFetchImplementation = exports.EnvAddressError = exports.RunTree = exports.Client = void 0;
+exports.LS_MESSAGE_VIEW_EXCLUDE = exports.__version__ = exports.InternalServerError = exports.RateLimitError = exports.UnprocessableEntityError = exports.ConflictError = exports.NotFoundError = exports.PermissionDeniedError = exports.AuthenticationError = exports.BadRequestError = exports.APIConnectionTimeoutError = exports.APIConnectionError = exports.APIUserAbortError = exports.APIError = exports.LangsmithError = exports.promptCacheSingleton = exports.configureGlobalPromptCache = exports.PromptCache = exports.Cache = exports.isTracingEnabled = exports.uuid7FromTime = exports.uuid7 = exports.computeRunIdForSecondaryReplica = exports.getDefaultProjectName = exports.overrideFetchImplementation = exports.EnvAddressError = exports.address = exports.RunTree = exports.Client = void 0;
 var client_js_1 = require("./client.cjs");
 Object.defineProperty(exports, "Client", { enumerable: true, get: function () { return client_js_1.Client; } });
 var run_trees_js_1 = require("./run_trees.cjs");
 Object.defineProperty(exports, "RunTree", { enumerable: true, get: function () { return run_trees_js_1.RunTree; } });
 var address_js_1 = require("./address.cjs");
+Object.defineProperty(exports, "address", { enumerable: true, get: function () { return address_js_1.address; } });
 Object.defineProperty(exports, "EnvAddressError", { enumerable: true, get: function () { return address_js_1.EnvAddressError; } });
 var fetch_js_1 = require("./singletons/fetch.cjs");
 Object.defineProperty(exports, "overrideFetchImplementation", { enumerable: true, get: function () { return fetch_js_1.overrideFetchImplementation; } });
@@ -37,6 +38,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.10.6";
+exports.__version__ = "0.10.8";
 // 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

@@ -1,12 +1,12 @@
 export { Client, type ClientConfig, type LangSmithTracingClientInterface, } from "./client.js";
 export type { Dataset, Example, TracerSession, Run, Feedback, FeedbackConfigSchema, RetrieverOutput, } from "./schemas.js";
 export { RunTree, type RunTreeConfig, type WriteReplica } from "./run_trees.js";
-export { type Address, EnvAddressError } from "./address.js";
+export { address, type Address, type Environment, EnvAddressError, } from "./address.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 export { computeRunIdForSecondaryReplica, uuid7, uuid7FromTime, } from "./uuid.js";
 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.10.6";
+export declare const __version__ = "0.10.8";
 export declare const LS_MESSAGE_VIEW_EXCLUDE: "ls_message_view_exclude";

package/dist/index.js

@@ -1,6 +1,6 @@
 export { Client, } from "./client.js";
 export { RunTree } from "./run_trees.js";
-export { EnvAddressError } from "./address.js";
+export { address, EnvAddressError, } from "./address.js";
 export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 export { computeRunIdForSecondaryReplica, uuid7, uuid7FromTime, } from "./uuid.js";
@@ -8,6 +8,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.10.6";
+export const __version__ = "0.10.8";
 // Metadata key to hide a traced run from LangSmith's Messages View.
 export const LS_MESSAGE_VIEW_EXCLUDE = "ls_message_view_exclude";

package/dist/run_trees.cjs

@@ -50,29 +50,22 @@ const HEADER_SAFE_REPLICA_FIELDS = new Set([
     "primary",
     "updates",
     "reroot",
-    ...(0, address_js_1.wireKeys)(),
+    "address",
 ]);
-// URL-encoded JSON of the address's wire fields.
+// The address string, URL-encoded.
 const LANGSMITH_ADDRESS = "langsmith-address";
-/** Pops the address wire keys off untrusted `values`; never throws. */
-function takeHeaderAddress(values) {
-    const wire = {};
-    for (const key of (0, address_js_1.wireKeys)()) {
-        if (key in values) {
-            wire[key] = values[key];
-            delete values[key];
-        }
+/** Validates an untrusted header address; `undefined` if unusable. */
+function addressFromHeader(value) {
+    if (value == null) {
+        return undefined;
     }
     try {
-        return {
-            named: Object.keys(wire).length > 0,
-            address: (0, address_js_1.fromWire)(wire),
-        };
+        return (0, address_js_1.parse)(value);
     }
     catch {
         // Values are untrusted, so not logged.
-        console.warn("Ignoring an invalid address in a `baggage` header.");
-        return { named: true };
+        console.warn("Ignoring an unusable address in a `baggage` header.");
+        return undefined;
     }
 }
 function filterReplicaForHeaders(replica) {
@@ -148,16 +141,7 @@ class Baggage {
                 project_name = value;
             }
             else if (key === LANGSMITH_ADDRESS) {
-                let parsed;
-                try {
-                    parsed = JSON.parse(value);
-                }
-                catch {
-                    parsed = undefined;
-                }
-                if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-                    address = takeHeaderAddress({ ...parsed }).address;
-                }
+                address = addressFromHeader(value);
             }
             else if (key === "langsmith-replicas") {
                 const parsed = JSON.parse(value);
@@ -166,10 +150,12 @@ class Baggage {
                         return [replica];
                     }
                     const filtered = filterReplicaForHeaders(replica);
-                    const { named, address } = takeHeaderAddress(filtered);
+                    const raw = filtered.address;
+                    delete filtered.address;
+                    const address = addressFromHeader(raw);
                     // A project wins over an address; a replica with an invalid
                     // address and no project is dropped.
-                    if (filtered.projectName || !named) {
+                    if (filtered.projectName || raw == null) {
                         return [filtered];
                     }
                     return address ? [{ ...filtered, address }] : [];
@@ -190,7 +176,7 @@ class Baggage {
             items.push(`langsmith-project=${encodeURIComponent(this.project_name)}`);
         }
         if (this.address) {
-            items.push(`${LANGSMITH_ADDRESS}=${encodeURIComponent(JSON.stringify((0, address_js_1.toWire)(this.address)))}`);
+            items.push(`${LANGSMITH_ADDRESS}=${encodeURIComponent(this.address)}`);
         }
         return items.join(",");
     }
@@ -683,14 +669,14 @@ class RunTree {
         if (primary === undefined &&
             !this.replicas?.some((r) => r.primary === true) &&
             projectName === this.project_name &&
-            (0, address_js_1.sameAddress)(address, this.address)) {
+            address === this.address) {
             return {
                 ...baseRun,
                 session_name: projectName,
                 address,
             };
         }
-        const seed = projectName ?? (address ? (0, address_js_1.seed)(address) : undefined) ?? "agent//";
+        const seed = projectName ?? address ?? "agent//";
         // Apply reroot logic before ID remapping
         if (reroot) {
             if (distributedParentId) {

package/dist/run_trees.js

@@ -9,7 +9,7 @@ import { warnOnce } from "./utils/warn.js";
 import { uuid7FromTime, nonCryptographicUuid7Deterministic, } from "./utils/_uuid.js";
 import { v5 as uuidv5 } from "./utils/uuid/src/index.js";
 import { checkAddress, logUntraced, rejectConflicting, resolveFromEnv, } from "./utils/agent_addressing.js";
-import { EnvAddressError, fromWire, sameAddress, seed as addressSeed, toWire, wireKeys, } from "./address.js";
+import { EnvAddressError, parse as parseAddress, } from "./address.js";
 const TIMESTAMP_LENGTH = 36;
 // DNS namespace for UUID v5 (same as Python's uuid.NAMESPACE_DNS)
 const UUID_NAMESPACE_DNS = "6ba7b810-9dad-11d1-80b4-00c04fd430c8";
@@ -44,29 +44,22 @@ const HEADER_SAFE_REPLICA_FIELDS = new Set([
     "primary",
     "updates",
     "reroot",
-    ...wireKeys(),
+    "address",
 ]);
-// URL-encoded JSON of the address's wire fields.
+// The address string, URL-encoded.
 const LANGSMITH_ADDRESS = "langsmith-address";
-/** Pops the address wire keys off untrusted `values`; never throws. */
-function takeHeaderAddress(values) {
-    const wire = {};
-    for (const key of wireKeys()) {
-        if (key in values) {
-            wire[key] = values[key];
-            delete values[key];
-        }
+/** Validates an untrusted header address; `undefined` if unusable. */
+function addressFromHeader(value) {
+    if (value == null) {
+        return undefined;
     }
     try {
-        return {
-            named: Object.keys(wire).length > 0,
-            address: fromWire(wire),
-        };
+        return parseAddress(value);
     }
     catch {
         // Values are untrusted, so not logged.
-        console.warn("Ignoring an invalid address in a `baggage` header.");
-        return { named: true };
+        console.warn("Ignoring an unusable address in a `baggage` header.");
+        return undefined;
     }
 }
 function filterReplicaForHeaders(replica) {
@@ -142,16 +135,7 @@ class Baggage {
                 project_name = value;
             }
             else if (key === LANGSMITH_ADDRESS) {
-                let parsed;
-                try {
-                    parsed = JSON.parse(value);
-                }
-                catch {
-                    parsed = undefined;
-                }
-                if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-                    address = takeHeaderAddress({ ...parsed }).address;
-                }
+                address = addressFromHeader(value);
             }
             else if (key === "langsmith-replicas") {
                 const parsed = JSON.parse(value);
@@ -160,10 +144,12 @@ class Baggage {
                         return [replica];
                     }
                     const filtered = filterReplicaForHeaders(replica);
-                    const { named, address } = takeHeaderAddress(filtered);
+                    const raw = filtered.address;
+                    delete filtered.address;
+                    const address = addressFromHeader(raw);
                     // A project wins over an address; a replica with an invalid
                     // address and no project is dropped.
-                    if (filtered.projectName || !named) {
+                    if (filtered.projectName || raw == null) {
                         return [filtered];
                     }
                     return address ? [{ ...filtered, address }] : [];
@@ -184,7 +170,7 @@ class Baggage {
             items.push(`langsmith-project=${encodeURIComponent(this.project_name)}`);
         }
         if (this.address) {
-            items.push(`${LANGSMITH_ADDRESS}=${encodeURIComponent(JSON.stringify(toWire(this.address)))}`);
+            items.push(`${LANGSMITH_ADDRESS}=${encodeURIComponent(this.address)}`);
         }
         return items.join(",");
     }
@@ -677,14 +663,14 @@ export class RunTree {
         if (primary === undefined &&
             !this.replicas?.some((r) => r.primary === true) &&
             projectName === this.project_name &&
-            sameAddress(address, this.address)) {
+            address === this.address) {
             return {
                 ...baseRun,
                 session_name: projectName,
                 address,
             };
         }
-        const seed = projectName ?? (address ? addressSeed(address) : undefined) ?? "agent//";
+        const seed = projectName ?? address ?? "agent//";
         // Apply reroot logic before ID remapping
         if (reroot) {
             if (distributedParentId) {

package/dist/schemas.d.ts

@@ -150,7 +150,6 @@ export interface RunCreate extends BaseRun {
     revision_id?: string;
     child_runs?: this[];
     session_name?: string;
-    /** (beta) Sent as `agent_id` / `agent_environment`. */
     address?: Address;
 }
 export interface RunUpdate {
@@ -170,7 +169,6 @@ export interface RunUpdate {
     events?: KVMap[];
     session_id?: string;
     session_name?: string;
-    /** (beta) Sent as `agent_id` / `agent_environment`. */
     address?: Address;
     /** Unique ID assigned to every run within this nested trace. **/
     trace_id?: string;

package/dist/traceable.cjs

@@ -526,7 +526,7 @@ function traceable(wrappedFunc, config) {
             runtimeConfig = undefined;
         }
         // Runtime config outranks decorator config, whichever mode each names.
-        [ensuredConfig.project_name, ensuredConfig.address] = (0, agent_addressing_js_1.firstNamed)([runtimeConfig?.project_name, runtimeConfig?.address], [runTreeConfig.project_name, runTreeConfig.address]);
+        [ensuredConfig.project_name, ensuredConfig.address] = (0, agent_addressing_js_1.firstNamed)([runtimeConfig?.project_name, (0, agent_addressing_js_1.checkAddress)(runtimeConfig?.address)], [runTreeConfig.project_name, runTreeConfig.address]);
         let runEndedPromiseResolver;
         const runEndedPromise = new Promise((resolve) => {
             runEndedPromiseResolver = resolve;
@@ -651,9 +651,28 @@ function traceable(wrappedFunc, config) {
                     async start(controller) {
                         // eslint-disable-next-line no-constant-condition
                         while (true) {
-                            const result = await (snapshot
-                                ? snapshot(() => otel_context.with(capturedOtelContext, () => reader.read()))
-                                : otel_context.with(capturedOtelContext, () => reader.read()));
+                            let result;
+                            try {
+                                result = await (snapshot
+                                    ? snapshot(() => otel_context.with(capturedOtelContext, () => reader.read()))
+                                    : otel_context.with(capturedOtelContext, () => reader.read()));
+                            }
+                            catch (e) {
+                                // The source stream errored: end the run with the error and the
+                                // chunks received so far instead of leaving it pending.
+                                finished = true;
+                                await currentRunTree?.end(undefined, String(e));
+                                await handleRunOutputs({
+                                    runTree: currentRunTree,
+                                    rawOutputs: await handleChunks(chunks),
+                                    processOutputsFn,
+                                    on_end,
+                                    postRunPromise,
+                                    deferredInputs,
+                                    skipChildPromiseDelay: true,
+                                });
+                                throw e;
+                            }
                             if (result.done) {
                                 finished = true;
                                 await handleRunOutputs({

package/dist/traceable.js

@@ -522,7 +522,7 @@ export function traceable(wrappedFunc, config) {
             runtimeConfig = undefined;
         }
         // Runtime config outranks decorator config, whichever mode each names.
-        [ensuredConfig.project_name, ensuredConfig.address] = firstNamed([runtimeConfig?.project_name, runtimeConfig?.address], [runTreeConfig.project_name, runTreeConfig.address]);
+        [ensuredConfig.project_name, ensuredConfig.address] = firstNamed([runtimeConfig?.project_name, checkAddress(runtimeConfig?.address)], [runTreeConfig.project_name, runTreeConfig.address]);
         let runEndedPromiseResolver;
         const runEndedPromise = new Promise((resolve) => {
             runEndedPromiseResolver = resolve;
@@ -647,9 +647,28 @@ export function traceable(wrappedFunc, config) {
                     async start(controller) {
                         // eslint-disable-next-line no-constant-condition
                         while (true) {
-                            const result = await (snapshot
-                                ? snapshot(() => otel_context.with(capturedOtelContext, () => reader.read()))
-                                : otel_context.with(capturedOtelContext, () => reader.read()));
+                            let result;
+                            try {
+                                result = await (snapshot
+                                    ? snapshot(() => otel_context.with(capturedOtelContext, () => reader.read()))
+                                    : otel_context.with(capturedOtelContext, () => reader.read()));
+                            }
+                            catch (e) {
+                                // The source stream errored: end the run with the error and the
+                                // chunks received so far instead of leaving it pending.
+                                finished = true;
+                                await currentRunTree?.end(undefined, String(e));
+                                await handleRunOutputs({
+                                    runTree: currentRunTree,
+                                    rawOutputs: await handleChunks(chunks),
+                                    processOutputsFn,
+                                    on_end,
+                                    postRunPromise,
+                                    deferredInputs,
+                                    skipChildPromiseDelay: true,
+                                });
+                                throw e;
+                            }
                             if (result.done) {
                                 finished = true;
                                 await handleRunOutputs({

package/dist/utils/agent_addressing.cjs

@@ -10,9 +10,9 @@ exports.applyToPayload = applyToPayload;
 const address_js_1 = require("../address.cjs");
 const env_js_1 = require("./env.cjs");
 const warn_js_1 = require("./warn.cjs");
-/** Validate an address at an entry point; the SDK carries the frozen copy. */
+/** Validate and normalise an address at an entry point; the SDK carries the result. */
 function checkAddress(address) {
-    return address == null ? undefined : (0, address_js_1.normalizeAddress)(address);
+    return address == null ? undefined : (0, address_js_1.parse)(address);
 }
 function rejectConflicting(project, address) {
     if (project && address) {
@@ -41,7 +41,7 @@ function getEnvProject() {
  */
 function resolveFromEnv() {
     const project = getEnvProject();
-    const address = (0, address_js_1.addressFromEnv)();
+    const address = (0, address_js_1.fromEnv)();
     if (project && address) {
         throw new address_js_1.EnvAddressError("LANGSMITH_AGENT_* and a project are both set in the environment.");
     }
@@ -64,9 +64,8 @@ function warnOnEnv() {
     }
 }
 /**
- * Render `address` into its wire fields, in place. Without one, a create
- * naming no project takes the env address. Already-rendered payloads (runs
- * re-prepared when batched) are left alone.
+ * Put the run's address in its payload field, as one lowercase string.
+ * Without one, a create naming no project takes the env address.
  *
  * @throws {EnvAddressError} If the env names half an address.
  */
@@ -75,16 +74,15 @@ function applyToPayload(run, { update = false } = {}) {
     let address = checkAddress(payload.address);
     delete payload.address;
     const namedProject = payload.session_id != null || payload.session_name != null;
-    const rendered = (0, address_js_1.wireKeys)().some((key) => payload[key] != null);
-    if (!address && !update && !namedProject && !rendered) {
-        address = (0, address_js_1.addressFromEnv)();
+    if (!address && !update && !namedProject) {
+        address = (0, address_js_1.fromEnv)();
     }
     if (!address) {
         return;
     }
     (0, warn_js_1.warnOnce)("Sending runs to an `address` is in beta and enabled per workspace; a " +
         "workspace without it rejects the runs.");
-    Object.assign(payload, (0, address_js_1.toWire)(address));
+    payload.address = address;
     if (!namedProject) {
         delete payload.session_name;
         delete payload.session_id;

package/dist/utils/agent_addressing.d.ts

@@ -1,8 +1,8 @@
 import { type Address, EnvAddressError } from "../address.js";
 /** One precedence level: the `[project, address]` it names. */
 export type Tier = [string | undefined, Address | undefined];
-/** Validate an address at an entry point; the SDK carries the frozen copy. */
-export declare function checkAddress(address: unknown): Readonly<Address> | undefined;
+/** Validate and normalise an address at an entry point; the SDK carries the result. */
+export declare function checkAddress(address: unknown): Address | undefined;
 export declare function rejectConflicting(project: unknown, address: unknown): void;
 /** The highest level naming a project or an address, whichever it names. */
 export declare function firstNamed(...tiers: Tier[]): Tier;
@@ -15,9 +15,8 @@ export declare function logUntraced(error: EnvAddressError): void;
 /** Warn once, at client construction, if the env can't address runs. */
 export declare function warnOnEnv(): void;
 /**
- * Render `address` into its wire fields, in place. Without one, a create
- * naming no project takes the env address. Already-rendered payloads (runs
- * re-prepared when batched) are left alone.
+ * Put the run's address in its payload field, as one lowercase string.
+ * Without one, a create naming no project takes the env address.
  *
  * @throws {EnvAddressError} If the env names half an address.
  */

package/dist/utils/agent_addressing.js

@@ -1,9 +1,9 @@
-import { EnvAddressError, addressFromEnv, envNames, normalizeAddress, toWire, wireKeys, } from "../address.js";
+import { EnvAddressError, envNames, fromEnv as addressFromEnv, parse, } from "../address.js";
 import { getEnvironmentVariable, getLangSmithEnvironmentVariable, } from "./env.js";
 import { warnOnce } from "./warn.js";
-/** Validate an address at an entry point; the SDK carries the frozen copy. */
+/** Validate and normalise an address at an entry point; the SDK carries the result. */
 export function checkAddress(address) {
-    return address == null ? undefined : normalizeAddress(address);
+    return address == null ? undefined : parse(address);
 }
 export function rejectConflicting(project, address) {
     if (project && address) {
@@ -55,9 +55,8 @@ export function warnOnEnv() {
     }
 }
 /**
- * Render `address` into its wire fields, in place. Without one, a create
- * naming no project takes the env address. Already-rendered payloads (runs
- * re-prepared when batched) are left alone.
+ * Put the run's address in its payload field, as one lowercase string.
+ * Without one, a create naming no project takes the env address.
  *
  * @throws {EnvAddressError} If the env names half an address.
  */
@@ -66,8 +65,7 @@ export function applyToPayload(run, { update = false } = {}) {
     let address = checkAddress(payload.address);
     delete payload.address;
     const namedProject = payload.session_id != null || payload.session_name != null;
-    const rendered = wireKeys().some((key) => payload[key] != null);
-    if (!address && !update && !namedProject && !rendered) {
+    if (!address && !update && !namedProject) {
         address = addressFromEnv();
     }
     if (!address) {
@@ -75,7 +73,7 @@ export function applyToPayload(run, { update = false } = {}) {
     }
     warnOnce("Sending runs to an `address` is in beta and enabled per workspace; a " +
         "workspace without it rejects the runs.");
-    Object.assign(payload, toWire(address));
+    payload.address = address;
     if (!namedProject) {
         delete payload.session_name;
         delete payload.session_id;

package/package.json

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