langsmith 0.10.8 → 0.10.9

package/dist/sandbox/sandbox.cjs

@@ -8,6 +8,7 @@ const uuid_js_1 = require("../uuid.cjs");
 const errors_js_1 = require("./errors.cjs");
 const helpers_js_1 = require("./helpers.cjs");
 const command_handle_js_1 = require("./command_handle.cjs");
+const tracing_js_1 = require("./tracing.cjs");
 const ws_execute_js_1 = require("./ws_execute.cjs");
 /**
  * Represents an active sandbox for running commands and file operations.
@@ -195,6 +196,7 @@ class Sandbox {
      * @throws LangSmithDataplaneNotConfiguredError if dataplane_url is not configured.
      */
     requireDataplaneUrl() {
+        (0, tracing_js_1.addSandboxMetadata)(this.id);
         if (!this.dataplane_url) {
             throw new errors_js_1.LangSmithDataplaneNotConfiguredError(`Sandbox '${this.name}' does not have a dataplane_url configured. ` +
                 "Runtime operations require a dataplane URL.");
@@ -593,6 +595,7 @@ class Sandbox {
      * ```
      */
     async generateDownloadURL(path, options = {}) {
+        (0, tracing_js_1.addSandboxMetadata)(this.id);
         return this._client.generateDownloadURL(this.name, path, options);
     }
     /**
@@ -609,6 +612,7 @@ class Sandbox {
      * ```
      */
     async delete() {
+        (0, tracing_js_1.addSandboxMetadata)(this.id);
         await this._client.deleteSandbox(this.name);
     }
     /**
@@ -619,6 +623,7 @@ class Sandbox {
      * @param timeout - Timeout in seconds when waiting for ready. Default: 120.
      */
     async start(options = {}) {
+        (0, tracing_js_1.addSandboxMetadata)(this.id);
         const refreshed = await this._client.startSandbox(this.name, options);
         this.status = refreshed.status;
         this.dataplane_url = refreshed.dataplane_url;
@@ -627,6 +632,7 @@ class Sandbox {
      * Stop a running sandbox (preserves sandbox files for later restart).
      */
     async stop() {
+        (0, tracing_js_1.addSandboxMetadata)(this.id);
         await this._client.stopSandbox(this.name);
         // dataplane_url stays set: it is stable across stop/start and a request on
         // it resumes the sandbox.
@@ -640,6 +646,7 @@ class Sandbox {
      * @returns Snapshot in "ready" status.
      */
     async captureSnapshot(name, options = {}) {
+        (0, tracing_js_1.addSandboxMetadata)(this.id);
         return this._client.captureSnapshot(this.name, name, options);
     }
 }

package/dist/sandbox/sandbox.js

@@ -5,6 +5,7 @@ import { uuid7 } from "../uuid.js";
 import { LangSmithDataplaneNotConfiguredError, LangSmithSandboxRetryableConnectionError, LangSmithStreamEndedBeforeStartedError, } from "./errors.js";
 import { assertRunConfigNotCombined, buildRangeHeader, fileChunkFromResponse, fileStatFromResponse, handleFileHttpError, handleSandboxHttpError, resolveCloseInput, } from "./helpers.js";
 import { CommandHandle } from "./command_handle.js";
+import { addSandboxMetadata } from "./tracing.js";
 import { connectDeadline, isWsAvailable, openTimeoutFor, reconnectWsStream, remainingBudget, runWsStream, } from "./ws_execute.js";
 /**
  * Represents an active sandbox for running commands and file operations.
@@ -192,6 +193,7 @@ export class Sandbox {
      * @throws LangSmithDataplaneNotConfiguredError if dataplane_url is not configured.
      */
     requireDataplaneUrl() {
+        addSandboxMetadata(this.id);
         if (!this.dataplane_url) {
             throw new LangSmithDataplaneNotConfiguredError(`Sandbox '${this.name}' does not have a dataplane_url configured. ` +
                 "Runtime operations require a dataplane URL.");
@@ -590,6 +592,7 @@ export class Sandbox {
      * ```
      */
     async generateDownloadURL(path, options = {}) {
+        addSandboxMetadata(this.id);
         return this._client.generateDownloadURL(this.name, path, options);
     }
     /**
@@ -606,6 +609,7 @@ export class Sandbox {
      * ```
      */
     async delete() {
+        addSandboxMetadata(this.id);
         await this._client.deleteSandbox(this.name);
     }
     /**
@@ -616,6 +620,7 @@ export class Sandbox {
      * @param timeout - Timeout in seconds when waiting for ready. Default: 120.
      */
     async start(options = {}) {
+        addSandboxMetadata(this.id);
         const refreshed = await this._client.startSandbox(this.name, options);
         this.status = refreshed.status;
         this.dataplane_url = refreshed.dataplane_url;
@@ -624,6 +629,7 @@ export class Sandbox {
      * Stop a running sandbox (preserves sandbox files for later restart).
      */
     async stop() {
+        addSandboxMetadata(this.id);
         await this._client.stopSandbox(this.name);
         // dataplane_url stays set: it is stable across stop/start and a request on
         // it resumes the sandbox.
@@ -637,6 +643,7 @@ export class Sandbox {
      * @returns Snapshot in "ready" status.
      */
     async captureSnapshot(name, options = {}) {
+        addSandboxMetadata(this.id);
         return this._client.captureSnapshot(this.name, name, options);
     }
 }

package/dist/sandbox/service_url.cjs

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceLoginUrl = exports.ServiceUrl = exports.SERVICE_TOKEN_HEADER = void 0;
+const tracing_js_1 = require("./tracing.cjs");
 /** Header the sandbox router reads the minted service token from. */
 exports.SERVICE_TOKEN_HEADER = "X-Langsmith-Sandbox-Service-Token";
 /** Refresh this many seconds before the token actually expires. */
@@ -11,7 +12,13 @@ const REFRESH_MARGIN_SECONDS = 60;
  * Accessors are async because a refresh is a network call.
  */
 class ServiceUrl {
-    constructor(data, refresher) {
+    constructor(data, refresher, _sandboxId) {
+        Object.defineProperty(this, "_sandboxId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: _sandboxId
+        });
         Object.defineProperty(this, "_browserUrl", {
             enumerable: true,
             configurable: true,
@@ -87,6 +94,7 @@ class ServiceUrl {
     }
     /** Fetch a path on the service with the token header injected. */
     async fetch(path = "/", init = {}) {
+        (0, tracing_js_1.addSandboxMetadata)(this._sandboxId);
         const base = (await this.serviceUrl()).replace(/\/+$/, "");
         const url = `${base}/${path.replace(/^\/+/, "")}`;
         const headers = new Headers(init.headers);

package/dist/sandbox/service_url.d.ts

@@ -15,12 +15,13 @@ export interface ServiceUrlData {
  * Accessors are async because a refresh is a network call.
  */
 export declare class ServiceUrl {
+    private readonly _sandboxId?;
     private _browserUrl;
     private _serviceUrl;
     private _token;
     private _expiresAt;
     private readonly _refresher?;
-    constructor(data: ServiceUrlData, refresher?: () => Promise<ServiceUrl>);
+    constructor(data: ServiceUrlData, refresher?: () => Promise<ServiceUrl>, _sandboxId?: string | undefined);
     private _shouldRefresh;
     private _maybeRefresh;
     /** The signed token, refreshed if near expiry. */

package/dist/sandbox/service_url.js

@@ -1,3 +1,4 @@
+import { addSandboxMetadata } from "./tracing.js";
 /** Header the sandbox router reads the minted service token from. */
 export const SERVICE_TOKEN_HEADER = "X-Langsmith-Sandbox-Service-Token";
 /** Refresh this many seconds before the token actually expires. */
@@ -8,7 +9,13 @@ const REFRESH_MARGIN_SECONDS = 60;
  * Accessors are async because a refresh is a network call.
  */
 export class ServiceUrl {
-    constructor(data, refresher) {
+    constructor(data, refresher, _sandboxId) {
+        Object.defineProperty(this, "_sandboxId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: _sandboxId
+        });
         Object.defineProperty(this, "_browserUrl", {
             enumerable: true,
             configurable: true,
@@ -84,6 +91,7 @@ export class ServiceUrl {
     }
     /** Fetch a path on the service with the token header injected. */
     async fetch(path = "/", init = {}) {
+        addSandboxMetadata(this._sandboxId);
         const base = (await this.serviceUrl()).replace(/\/+$/, "");
         const url = `${base}/${path.replace(/^\/+/, "")}`;
         const headers = new Headers(init.headers);

package/dist/sandbox/tracing.cjs

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addSandboxMetadata = addSandboxMetadata;
+const run_trees_js_1 = require("../run_trees.cjs");
+const traceable_js_1 = require("../singletons/traceable.cjs");
+function addSandboxMetadata(sandboxId) {
+    if (!sandboxId)
+        return;
+    const run = (0, traceable_js_1.getCurrentRunTree)(true);
+    if ((0, run_trees_js_1.isRunTree)(run)) {
+        run.metadata = { sandbox_id: sandboxId };
+    }
+}

package/dist/sandbox/tracing.d.ts

@@ -0,0 +1 @@
+export declare function addSandboxMetadata(sandboxId?: string): void;

package/dist/sandbox/tracing.js

@@ -0,0 +1,10 @@
+import { isRunTree } from "../run_trees.js";
+import { getCurrentRunTree } from "../singletons/traceable.js";
+export function addSandboxMetadata(sandboxId) {
+    if (!sandboxId)
+        return;
+    const run = getCurrentRunTree(true);
+    if (isRunTree(run)) {
+        run.metadata = { sandbox_id: sandboxId };
+    }
+}

package/dist/schemas.d.ts

@@ -1,4 +1,4 @@
-import type { Address } from "./address.js";
+import type { AgentAddress } from "./address.js";
 export interface TracerSession {
     tenant_id: string;
     id: string;
@@ -150,7 +150,7 @@ export interface RunCreate extends BaseRun {
     revision_id?: string;
     child_runs?: this[];
     session_name?: string;
-    address?: Address;
+    address?: AgentAddress;
 }
 export interface RunUpdate {
     id?: string;
@@ -169,7 +169,7 @@ export interface RunUpdate {
     events?: KVMap[];
     session_id?: string;
     session_name?: string;
-    address?: Address;
+    address?: AgentAddress;
     /** Unique ID assigned to every run within this nested trace. **/
     trace_id?: string;
     /**

package/dist/traceable.cjs

@@ -9,7 +9,8 @@ const traceable_js_1 = require("./singletons/traceable.cjs");
 const constants_js_1 = require("./singletons/constants.cjs");
 const asserts_js_1 = require("./utils/asserts.cjs");
 const index_js_1 = require("./index.cjs");
-const agent_addressing_js_1 = require("./utils/agent_addressing.cjs");
+const address_js_1 = require("./address.cjs");
+const addressing_js_1 = require("./utils/addressing.cjs");
 const otel_js_1 = require("./singletons/otel.cjs");
 const utils_js_1 = require("./experimental/otel/utils.cjs");
 const constants_js_2 = require("./experimental/otel/constants.cjs");
@@ -473,8 +474,8 @@ const convertSerializableArg = (arg, options) => {
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function traceable(wrappedFunc, config) {
     const { aggregator, argsConfigPath, __finalTracedIteratorKey, processInputs, processOutputs, extractAttachments, on_start, ...runTreeConfig } = config ?? {};
-    runTreeConfig.address = (0, agent_addressing_js_1.checkAddress)(runTreeConfig.address);
-    (0, agent_addressing_js_1.rejectConflicting)(runTreeConfig.project_name, runTreeConfig.address);
+    runTreeConfig.address = (0, address_js_1.ensureAgent)(runTreeConfig.address);
+    (0, addressing_js_1.rejectConflicting)(runTreeConfig.project_name, runTreeConfig.address);
     const processInputsFn = processInputs ?? ((x) => x);
     const processOutputsFn = processOutputs ?? ((x) => x);
     const extractAttachmentsFn = extractAttachments ?? ((...x) => [undefined, runInputsToMap(x)]);
@@ -526,7 +527,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, (0, agent_addressing_js_1.checkAddress)(runtimeConfig?.address)], [runTreeConfig.project_name, runTreeConfig.address]);
+        [ensuredConfig.project_name, ensuredConfig.address] = (0, addressing_js_1.firstNamed)([runtimeConfig?.project_name, (0, address_js_1.ensureAgent)(runtimeConfig?.address)], [runTreeConfig.project_name, (0, address_js_1.ensureAgent)(runTreeConfig.address)]);
         let runEndedPromiseResolver;
         const runEndedPromise = new Promise((resolve) => {
             runEndedPromiseResolver = resolve;

package/dist/traceable.js

@@ -5,7 +5,8 @@ import { ROOT, AsyncLocalStorageProviderSingleton, getCurrentRunTree, } from "./
 import { _LC_CHILD_RUN_END_PROMISES_KEY, _LC_CONTEXT_VARIABLES_KEY, _PROCESSING_FAILED_KEY, _processingFailed, } from "./singletons/constants.js";
 import { isKVMap, isReadableStream, isAsyncIterable, isIteratorLike, isThenable, isGenerator, isPromiseMethod, } from "./utils/asserts.js";
 import { __version__ } from "./index.js";
-import { checkAddress, firstNamed, rejectConflicting, } from "./utils/agent_addressing.js";
+import { ensureAgent } from "./address.js";
+import { firstNamed, rejectConflicting } from "./utils/addressing.js";
 import { getOTELTrace, getOTELContext } from "./singletons/otel.js";
 import { getUuidFromOtelSpanId } from "./experimental/otel/utils.js";
 import { LANGSMITH_REFERENCE_EXAMPLE_ID, LANGSMITH_SESSION_NAME, LANGSMITH_TRACEABLE, } from "./experimental/otel/constants.js";
@@ -469,7 +470,7 @@ const convertSerializableArg = (arg, options) => {
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function traceable(wrappedFunc, config) {
     const { aggregator, argsConfigPath, __finalTracedIteratorKey, processInputs, processOutputs, extractAttachments, on_start, ...runTreeConfig } = config ?? {};
-    runTreeConfig.address = checkAddress(runTreeConfig.address);
+    runTreeConfig.address = ensureAgent(runTreeConfig.address);
     rejectConflicting(runTreeConfig.project_name, runTreeConfig.address);
     const processInputsFn = processInputs ?? ((x) => x);
     const processOutputsFn = processOutputs ?? ((x) => x);
@@ -522,7 +523,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, checkAddress(runtimeConfig?.address)], [runTreeConfig.project_name, runTreeConfig.address]);
+        [ensuredConfig.project_name, ensuredConfig.address] = firstNamed([runtimeConfig?.project_name, ensureAgent(runtimeConfig?.address)], [runTreeConfig.project_name, ensureAgent(runTreeConfig.address)]);
         let runEndedPromiseResolver;
         const runEndedPromise = new Promise((resolve) => {
             runEndedPromiseResolver = resolve;

package/dist/utils/{agent_addressing.cjs → addressing.cjs}

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.checkAddress = checkAddress;
 exports.rejectConflicting = rejectConflicting;
 exports.firstNamed = firstNamed;
 exports.resolveFromEnv = resolveFromEnv;
@@ -10,14 +9,10 @@ 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 and normalise an address at an entry point; the SDK carries the result. */
-function checkAddress(address) {
-    return address == null ? undefined : (0, address_js_1.parse)(address);
-}
 function rejectConflicting(project, address) {
     if (project && address) {
         throw new Error(`A run is sent to a project (${JSON.stringify(project)}) or to an ` +
-            `address (${JSON.stringify(address)}), not both.`);
+            "address, not both.");
     }
 }
 /** The highest level naming a project or an address, whichever it names. */
@@ -41,7 +36,7 @@ function getEnvProject() {
  */
 function resolveFromEnv() {
     const project = getEnvProject();
-    const address = (0, address_js_1.fromEnv)();
+    const address = address_js_1.AgentAddress.fromEnv();
     if (project && address) {
         throw new address_js_1.EnvAddressError("LANGSMITH_AGENT_* and a project are both set in the environment.");
     }
@@ -64,25 +59,39 @@ function warnOnEnv() {
     }
 }
 /**
- * Put the run's address in its payload field, as one lowercase string.
+ * Put the run's address in its payload field, in its wire form.
  * Without one, a create naming no project takes the env address.
  *
  * @throws {EnvAddressError} If the env names half an address.
  */
 function applyToPayload(run, { update = false } = {}) {
     const payload = run;
-    let address = checkAddress(payload.address);
+    let address;
+    if (typeof payload.address === "string") {
+        // Wire data already applied: a queued run is applied again when its batch
+        // is sent. It is parsed again, so a malformed one cannot fail the whole
+        // batch in the backend.
+        try {
+            address = address_js_1.AgentAddress._fromLrn(payload.address);
+        }
+        catch {
+            throw new Error("The run's `address` is not a valid agent address.");
+        }
+    }
+    else {
+        address = (0, address_js_1.ensureAgent)(payload.address);
+    }
     delete payload.address;
     const namedProject = payload.session_id != null || payload.session_name != null;
     if (!address && !update && !namedProject) {
-        address = (0, address_js_1.fromEnv)();
+        address = address_js_1.AgentAddress.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.");
-    payload.address = address;
+    payload.address = address._toLrn();
     if (!namedProject) {
         delete payload.session_name;
         delete payload.session_id;

package/dist/utils/{agent_addressing.d.ts → addressing.d.ts}

@@ -1,8 +1,6 @@
-import { type Address, EnvAddressError } from "../address.js";
+import { AgentAddress, EnvAddressError } from "../address.js";
 /** One precedence level: the `[project, address]` it names. */
-export type Tier = [string | undefined, 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 type Tier = [string | undefined, AgentAddress | 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,13 +13,13 @@ export declare function logUntraced(error: EnvAddressError): void;
 /** Warn once, at client construction, if the env can't address runs. */
 export declare function warnOnEnv(): void;
 /**
- * Put the run's address in its payload field, as one lowercase string.
+ * Put the run's address in its payload field, in its wire form.
  * Without one, a create naming no project takes the env address.
  *
  * @throws {EnvAddressError} If the env names half an address.
  */
 export declare function applyToPayload(run: {
-    address?: Address;
+    address?: AgentAddress;
     session_id?: string;
     session_name?: string;
 }, { update }?: {

package/dist/utils/{agent_addressing.js → addressing.js}

@@ -1,14 +1,10 @@
-import { EnvAddressError, envNames, fromEnv as addressFromEnv, parse, } from "../address.js";
+import { AgentAddress, EnvAddressError, ensureAgent, envNames, } from "../address.js";
 import { getEnvironmentVariable, getLangSmithEnvironmentVariable, } from "./env.js";
 import { warnOnce } from "./warn.js";
-/** Validate and normalise an address at an entry point; the SDK carries the result. */
-export function checkAddress(address) {
-    return address == null ? undefined : parse(address);
-}
 export function rejectConflicting(project, address) {
     if (project && address) {
         throw new Error(`A run is sent to a project (${JSON.stringify(project)}) or to an ` +
-            `address (${JSON.stringify(address)}), not both.`);
+            "address, not both.");
     }
 }
 /** The highest level naming a project or an address, whichever it names. */
@@ -32,7 +28,7 @@ function getEnvProject() {
  */
 export function resolveFromEnv() {
     const project = getEnvProject();
-    const address = addressFromEnv();
+    const address = AgentAddress.fromEnv();
     if (project && address) {
         throw new EnvAddressError("LANGSMITH_AGENT_* and a project are both set in the environment.");
     }
@@ -55,25 +51,39 @@ export function warnOnEnv() {
     }
 }
 /**
- * Put the run's address in its payload field, as one lowercase string.
+ * Put the run's address in its payload field, in its wire form.
  * Without one, a create naming no project takes the env address.
  *
  * @throws {EnvAddressError} If the env names half an address.
  */
 export function applyToPayload(run, { update = false } = {}) {
     const payload = run;
-    let address = checkAddress(payload.address);
+    let address;
+    if (typeof payload.address === "string") {
+        // Wire data already applied: a queued run is applied again when its batch
+        // is sent. It is parsed again, so a malformed one cannot fail the whole
+        // batch in the backend.
+        try {
+            address = AgentAddress._fromLrn(payload.address);
+        }
+        catch {
+            throw new Error("The run's `address` is not a valid agent address.");
+        }
+    }
+    else {
+        address = ensureAgent(payload.address);
+    }
     delete payload.address;
     const namedProject = payload.session_id != null || payload.session_name != null;
     if (!address && !update && !namedProject) {
-        address = addressFromEnv();
+        address = AgentAddress.fromEnv();
     }
     if (!address) {
         return;
     }
     warnOnce("Sending runs to an `address` is in beta and enabled per workspace; a " +
         "workspace without it rejects the runs.");
-    payload.address = address;
+    payload.address = address._toLrn();
     if (!namedProject) {
         delete payload.session_name;
         delete payload.session_id;

package/dist/utils/env.cjs

@@ -120,14 +120,16 @@ function getLangSmithEnvVarsMetadata() {
         if (typeof value === "string" &&
             !excluded.includes(key) &&
             !isSensitiveEnvVarName(key)) {
-            if (key === "LANGCHAIN_REVISION_ID") {
-                envVars["revision_id"] = value;
-            }
-            else {
+            // LANGCHAIN_REVISION_ID is the legacy name for LANGSMITH_REVISION_ID.
+            if (key !== "LANGSMITH_REVISION_ID" && key !== "LANGCHAIN_REVISION_ID") {
                 envVars[key] = value;
             }
         }
     }
+    const revisionId = allEnvVars.LANGSMITH_REVISION_ID || allEnvVars.LANGCHAIN_REVISION_ID;
+    if (revisionId) {
+        envVars["revision_id"] = revisionId;
+    }
     return envVars;
 }
 /**

package/dist/utils/env.js

@@ -102,14 +102,16 @@ export function getLangSmithEnvVarsMetadata() {
         if (typeof value === "string" &&
             !excluded.includes(key) &&
             !isSensitiveEnvVarName(key)) {
-            if (key === "LANGCHAIN_REVISION_ID") {
-                envVars["revision_id"] = value;
-            }
-            else {
+            // LANGCHAIN_REVISION_ID is the legacy name for LANGSMITH_REVISION_ID.
+            if (key !== "LANGSMITH_REVISION_ID" && key !== "LANGCHAIN_REVISION_ID") {
                 envVars[key] = value;
             }
         }
     }
+    const revisionId = allEnvVars.LANGSMITH_REVISION_ID || allEnvVars.LANGCHAIN_REVISION_ID;
+    if (revisionId) {
+        envVars["revision_id"] = revisionId;
+    }
     return envVars;
 }
 /**

package/package.json

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