langsmith 0.5.22 → 0.5.24

package/dist/evaluation/evaluate_comparative.js

@@ -1,4 +1,4 @@
-import { v4 as uuid4, validate } from "uuid";
+import { v4 as uuid4, validate } from "../utils/uuid/src/index.js";
 import { Client } from "../index.js";
 import { shuffle } from "../utils/shuffle.js";
 import { AsyncCaller } from "../utils/async_caller.js";

package/dist/evaluation/evaluator.cjs

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamicRunEvaluator = void 0;
 exports.runEvaluator = runEvaluator;
-const uuid_1 = require("uuid");
+const index_js_1 = require("../utils/uuid/src/index.cjs");
 const traceable_js_1 = require("../traceable.cjs");
 /**
  * Wraps an evaluator function + implements the RunEvaluator interface.
@@ -67,7 +67,7 @@ class DynamicRunEvaluator {
      * @returns A promise that extracts to the evaluation result.
      */
     async evaluateRun(run, example, options) {
-        let sourceRunId = (0, uuid_1.v7)();
+        let sourceRunId = (0, index_js_1.v7)();
         const metadata = {
             targetRunId: run.id,
         };

package/dist/evaluation/evaluator.js

@@ -1,4 +1,4 @@
-import { v7 as uuidv7 } from "uuid";
+import { v7 as uuidv7 } from "../utils/uuid/src/index.js";
 import { traceable } from "../traceable.js";
 /**
  * Wraps an evaluator function + implements the RunEvaluator interface.

package/dist/index.cjs

@@ -18,4 +18,4 @@ Object.defineProperty(exports, "PromptCache", { enumerable: true, get: function
 Object.defineProperty(exports, "configureGlobalPromptCache", { enumerable: true, get: function () { return index_js_1.configureGlobalPromptCache; } });
 Object.defineProperty(exports, "promptCacheSingleton", { enumerable: true, get: function () { return index_js_1.promptCacheSingleton; } });
 // Update using pnpm bump-version
-exports.__version__ = "0.5.22";
+exports.__version__ = "0.5.24";

package/dist/index.d.ts

@@ -5,4 +5,4 @@ export { overrideFetchImplementation } from "./singletons/fetch.js";
 export { getDefaultProjectName } from "./utils/project.js";
 export { uuid7, uuid7FromTime } from "./uuid.js";
 export { Cache, PromptCache, type CacheConfig, type CacheMetrics, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
-export declare const __version__ = "0.5.22";
+export declare const __version__ = "0.5.24";

package/dist/index.js

@@ -5,4 +5,4 @@ export { getDefaultProjectName } from "./utils/project.js";
 export { uuid7, uuid7FromTime } from "./uuid.js";
 export { Cache, PromptCache, configureGlobalPromptCache, promptCacheSingleton, } from "./utils/prompt_cache/index.js";
 // Update using pnpm bump-version
-export const __version__ = "0.5.22";
+export const __version__ = "0.5.24";

package/dist/run_trees.cjs

@@ -14,7 +14,7 @@ const project_js_1 = require("./utils/project.cjs");
 const env_js_3 = require("./utils/env.cjs");
 const warn_js_1 = require("./utils/warn.cjs");
 const _uuid_js_1 = require("./utils/_uuid.cjs");
-const uuid_1 = require("uuid");
+const index_js_1 = require("./utils/uuid/src/index.cjs");
 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";
@@ -26,7 +26,7 @@ function getReplicaKey(replica) {
     const keyData = sortedKeys
         .map((key) => `${key}:${replica[key] ?? ""}`)
         .join("|");
-    return (0, uuid_1.v5)(keyData, UUID_NAMESPACE_DNS);
+    return (0, index_js_1.v5)(keyData, UUID_NAMESPACE_DNS);
 }
 function stripNonAlphanumeric(input) {
     return input.replace(/[-:.]/g, "");
@@ -691,8 +691,7 @@ class RunTree {
         try {
             const runtimeEnv = (0, env_js_2.getRuntimeEnvironment)();
             if (this.replicas && this.replicas.length > 0) {
-                for (const { projectName, apiKey, apiUrl, workspaceId, reroot } of this
-                    .replicas) {
+                for (const { projectName, apiKey, apiUrl, workspaceId, reroot, client: replicaClient, } of this.replicas) {
                     const runCreate = this._remapForProject({
                         projectName: projectName ?? this.project_name,
                         runtimeEnv,
@@ -703,7 +702,8 @@ class RunTree {
                         apiKey,
                         workspaceId,
                     });
-                    await this.client.createRun(runCreate, {
+                    const targetClient = replicaClient ?? this.client;
+                    await targetClient.createRun(runCreate, {
                         apiKey,
                         apiUrl,
                         workspaceId,
@@ -728,7 +728,7 @@ class RunTree {
     }
     async patchRun(options) {
         if (this.replicas && this.replicas.length > 0) {
-            for (const { projectName, apiKey, apiUrl, workspaceId, updates, reroot, } of this.replicas) {
+            for (const { projectName, apiKey, apiUrl, workspaceId, updates, reroot, client: replicaClient, } of this.replicas) {
                 const runData = this._remapForProject({
                     projectName: projectName ?? this.project_name,
                     runtimeEnv: undefined,
@@ -764,7 +764,8 @@ class RunTree {
                 if (!options?.excludeInputs) {
                     updatePayload.inputs = runData.inputs;
                 }
-                await this.client.updateRun(runData.id, updatePayload, {
+                const targetClient = replicaClient ?? this.client;
+                await targetClient.updateRun(runData.id, updatePayload, {
                     apiKey,
                     apiUrl,
                     workspaceId,

package/dist/run_trees.d.ts

@@ -63,6 +63,13 @@ type WriteReplica = {
     updates?: KVMap | undefined;
     fromEnv?: boolean;
     reroot?: boolean;
+    /**
+     * Optional dedicated Client for this replica.
+     * When set, the replica's runs are dispatched through this client
+     * (and its tracing mode) instead of the RunTree's default client.
+     * Not serialized in distributed-tracing baggage headers.
+     */
+    client?: Client;
 };
 type Replica = ProjectReplica | WriteReplica;
 export declare class RunTree implements BaseRun {

package/dist/run_trees.js

@@ -8,7 +8,7 @@ import { getDefaultProjectName } from "./utils/project.js";
 import { getLangSmithEnvironmentVariable } from "./utils/env.js";
 import { warnOnce } from "./utils/warn.js";
 import { uuid7FromTime, nonCryptographicUuid7Deterministic, } from "./utils/_uuid.js";
-import { v5 as uuidv5 } from "uuid";
+import { v5 as uuidv5 } from "./utils/uuid/src/index.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";
@@ -685,8 +685,7 @@ export class RunTree {
         try {
             const runtimeEnv = getRuntimeEnvironment();
             if (this.replicas && this.replicas.length > 0) {
-                for (const { projectName, apiKey, apiUrl, workspaceId, reroot } of this
-                    .replicas) {
+                for (const { projectName, apiKey, apiUrl, workspaceId, reroot, client: replicaClient, } of this.replicas) {
                     const runCreate = this._remapForProject({
                         projectName: projectName ?? this.project_name,
                         runtimeEnv,
@@ -697,7 +696,8 @@ export class RunTree {
                         apiKey,
                         workspaceId,
                     });
-                    await this.client.createRun(runCreate, {
+                    const targetClient = replicaClient ?? this.client;
+                    await targetClient.createRun(runCreate, {
                         apiKey,
                         apiUrl,
                         workspaceId,
@@ -722,7 +722,7 @@ export class RunTree {
     }
     async patchRun(options) {
         if (this.replicas && this.replicas.length > 0) {
-            for (const { projectName, apiKey, apiUrl, workspaceId, updates, reroot, } of this.replicas) {
+            for (const { projectName, apiKey, apiUrl, workspaceId, updates, reroot, client: replicaClient, } of this.replicas) {
                 const runData = this._remapForProject({
                     projectName: projectName ?? this.project_name,
                     runtimeEnv: undefined,
@@ -758,7 +758,8 @@ export class RunTree {
                 if (!options?.excludeInputs) {
                     updatePayload.inputs = runData.inputs;
                 }
-                await this.client.updateRun(runData.id, updatePayload, {
+                const targetClient = replicaClient ?? this.client;
+                await targetClient.updateRun(runData.id, updatePayload, {
                     apiKey,
                     apiUrl,
                     workspaceId,

package/dist/schemas.d.ts

@@ -435,6 +435,60 @@ export type PromptSortField = "num_downloads" | "num_views" | "updated_at" | "nu
 export interface LikePromptResponse {
     likes: number;
 }
+export interface FileEntry {
+    type: "file";
+    content: string;
+}
+export interface AgentEntry {
+    type: "agent";
+    repo_handle: string;
+    commit_id?: string;
+    owner?: string;
+    commit_hash?: string;
+}
+export interface SkillEntry {
+    type: "skill";
+    repo_handle: string;
+    commit_id?: string;
+    owner?: string;
+    commit_hash?: string;
+}
+export type Entry = FileEntry | AgentEntry | SkillEntry;
+/** The type of a non-prompt hub repo. */
+export type HubRepoType = "agent" | "skill";
+/**
+ * An agent pulled from hub.
+ */
+export interface AgentContext {
+    /** The commit ID. */
+    commit_id: string;
+    /** The commit hash. */
+    commit_hash: string;
+    /** The files in the agent. */
+    files: Record<string, Entry>;
+}
+/**
+ * A skill pulled from hub.
+ */
+export interface SkillContext {
+    /** The commit ID. */
+    commit_id: string;
+    /** The commit hash. */
+    commit_hash: string;
+    /** The files in the skill. */
+    files: Record<string, Entry>;
+}
+/** Response body for `POST /directories/commits`. */
+export interface DirectoryCommitResponse {
+    commit: {
+        /** The commit ID. */
+        id: string;
+        /** The commit hash. */
+        commit_hash: string;
+        /** When the commit was created. */
+        created_at: string;
+    };
+}
 export interface LangSmithSettings {
     id: string;
     display_name: string;

package/dist/singletons/otel.cjs

@@ -18,8 +18,9 @@ class MockTracer {
         });
     }
     startActiveSpan(_name, ...args) {
-        if (!this.hasWarned && (0, env_js_1.getOtelEnabled)()) {
-            console.warn("You have enabled OTEL export via the `OTEL_ENABLED` or `LANGSMITH_OTEL_ENABLED` environment variable, but have not initialized the required OTEL instances. " +
+        if (!this.hasWarned && (0, env_js_1.resolveTracingMode)() === "otel") {
+            console.warn("OTel tracing mode is active (via LANGSMITH_TRACING_MODE, OTEL_ENABLED, or " +
+                "LANGSMITH_OTEL_ENABLED), but the required OTEL instances have not been initialized. " +
                 'Please add:\n```\nimport { initializeOTEL } from "langsmith/experimental/otel/setup";\ninitializeOTEL();\n```\nat the beginning of your code.');
             this.hasWarned = true;
         }

package/dist/singletons/otel.js

@@ -1,5 +1,5 @@
 // Should not import any OTEL packages to avoid pulling in optional deps.
-import { getOtelEnabled } from "../utils/env.js";
+import { resolveTracingMode } from "../utils/env.js";
 class MockTracer {
     constructor() {
         Object.defineProperty(this, "hasWarned", {
@@ -10,8 +10,9 @@ class MockTracer {
         });
     }
     startActiveSpan(_name, ...args) {
-        if (!this.hasWarned && getOtelEnabled()) {
-            console.warn("You have enabled OTEL export via the `OTEL_ENABLED` or `LANGSMITH_OTEL_ENABLED` environment variable, but have not initialized the required OTEL instances. " +
+        if (!this.hasWarned && resolveTracingMode() === "otel") {
+            console.warn("OTel tracing mode is active (via LANGSMITH_TRACING_MODE, OTEL_ENABLED, or " +
+                "LANGSMITH_OTEL_ENABLED), but the required OTEL instances have not been initialized. " +
                 'Please add:\n```\nimport { initializeOTEL } from "langsmith/experimental/otel/setup";\ninitializeOTEL();\n```\nat the beginning of your code.');
             this.hasWarned = true;
         }

package/dist/traceable.cjs

@@ -8,7 +8,6 @@ const env_js_1 = require("./env.cjs");
 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 env_js_2 = require("./utils/env.cjs");
 const index_js_1 = require("./index.cjs");
 const otel_js_1 = require("./singletons/otel.cjs");
 const utils_js_1 = require("./experimental/otel/utils.cjs");
@@ -20,7 +19,7 @@ traceable_js_1.AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new n
 function maybeCreateOtelContext(runTree, projectName, tracer
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
-    if (!runTree || !(0, env_js_2.getOtelEnabled)()) {
+    if (!runTree || runTree.client.tracingMode !== "otel") {
         return;
     }
     const otel_trace = (0, otel_js_1.getOTELTrace)();

package/dist/traceable.js

@@ -4,7 +4,6 @@ import { isTracingEnabled } from "./env.js";
 import { ROOT, AsyncLocalStorageProviderSingleton, getCurrentRunTree, } from "./singletons/traceable.js";
 import { _LC_CHILD_RUN_END_PROMISES_KEY, _LC_CONTEXT_VARIABLES_KEY, } from "./singletons/constants.js";
 import { isKVMap, isReadableStream, isAsyncIterable, isIteratorLike, isThenable, isGenerator, isPromiseMethod, } from "./utils/asserts.js";
-import { getOtelEnabled } from "./utils/env.js";
 import { __version__ } from "./index.js";
 import { getOTELTrace, getOTELContext } from "./singletons/otel.js";
 import { getUuidFromOtelSpanId } from "./experimental/otel/utils.js";
@@ -16,7 +15,7 @@ AsyncLocalStorageProviderSingleton.initializeGlobalInstance(new AsyncLocalStorag
 function maybeCreateOtelContext(runTree, projectName, tracer
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {
-    if (!runTree || !getOtelEnabled()) {
+    if (!runTree || runTree.client.tracingMode !== "otel") {
         return;
     }
     const otel_trace = getOTELTrace();

package/dist/utils/_uuid.cjs

@@ -7,7 +7,7 @@ exports.warnIfNotUuidV7 = warnIfNotUuidV7;
 exports.nonCryptographicUuid7Deterministic = nonCryptographicUuid7Deterministic;
 // Relaxed UUID validation regex (allows any valid UUID format including nil UUIDs)
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const uuid_1 = require("uuid");
+const index_js_1 = require("./uuid/src/index.cjs");
 const warn_js_1 = require("./warn.cjs");
 const xxhash_js_1 = require("./xxhash/xxhash.cjs");
 let UUID7_WARNING_EMITTED = false;
@@ -34,7 +34,7 @@ function uuid7FromTime(timestamp) {
     // may not set the internal timestamp used for stringification.
     // Providing a seq ensures the implementation updates its internal state
     // and encodes the provided milliseconds into the UUID bytes.
-    return (0, uuid_1.v7)({ msecs, seq: 0 });
+    return (0, index_js_1.v7)({ msecs, seq: 0 });
 }
 /**
  * Get the version of a UUID string.

package/dist/utils/_uuid.js

@@ -1,6 +1,6 @@
 // Relaxed UUID validation regex (allows any valid UUID format including nil UUIDs)
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-import { v7 as uuidv7 } from "uuid";
+import { v7 as uuidv7 } from "./uuid/src/index.js";
 import { warnOnce } from "./warn.js";
 import { XXH3_128, xxh128ToBytes } from "./xxhash/xxhash.js";
 let UUID7_WARNING_EMITTED = false;

package/dist/utils/env.cjs

@@ -9,6 +9,7 @@ exports.getLangSmithEnvironmentVariable = getLangSmithEnvironmentVariable;
 exports.setEnvironmentVariable = setEnvironmentVariable;
 exports.getShas = getShas;
 exports.getOtelEnabled = getOtelEnabled;
+exports.resolveTracingMode = resolveTracingMode;
 // Inlined from https://github.com/flexdinesh/browser-or-node
 const index_js_1 = require("../index.cjs");
 let globalEnv;
@@ -218,3 +219,35 @@ function getOtelEnabled() {
     return (getEnvironmentVariable("OTEL_ENABLED") === "true" ||
         getLangSmithEnvironmentVariable("OTEL_ENABLED") === "true");
 }
+const _VALID_TRACING_MODES = new Set(["langsmith", "otel"]);
+/**
+ * Resolve the effective tracing mode from an explicit config value and
+ * environment variables.
+ *
+ * Priority: explicit argument > `LANGSMITH_TRACING_MODE` env var >
+ * legacy `OTEL_ENABLED` / `LANGSMITH_OTEL_ENABLED` env vars > `"langsmith"`.
+ */
+function resolveTracingMode(configValue) {
+    if (configValue !== undefined) {
+        return configValue;
+    }
+    const envMode = getLangSmithEnvironmentVariable("TRACING_MODE");
+    if (envMode !== undefined && envMode !== "") {
+        const lower = envMode.toLowerCase();
+        if (!_VALID_TRACING_MODES.has(lower)) {
+            throw new Error(`Invalid LANGSMITH_TRACING_MODE=${JSON.stringify(envMode)}. ` +
+                `Must be one of: ${[..._VALID_TRACING_MODES].sort().join(", ")}`);
+        }
+        if (getOtelEnabled()) {
+            console.warn("Both LANGSMITH_TRACING_MODE and the legacy OTEL_ENABLED / " +
+                "LANGSMITH_OTEL_ENABLED env vars are set. " +
+                "LANGSMITH_TRACING_MODE takes precedence.");
+        }
+        return lower;
+    }
+    // Fall back to legacy env var
+    if (getOtelEnabled()) {
+        return "otel";
+    }
+    return "langsmith";
+}

package/dist/utils/env.d.ts

@@ -48,4 +48,13 @@ interface ICommitSHAs {
  */
 export declare function getShas(): ICommitSHAs;
 export declare function getOtelEnabled(): boolean;
+export type TracingMode = "langsmith" | "otel";
+/**
+ * Resolve the effective tracing mode from an explicit config value and
+ * environment variables.
+ *
+ * Priority: explicit argument > `LANGSMITH_TRACING_MODE` env var >
+ * legacy `OTEL_ENABLED` / `LANGSMITH_OTEL_ENABLED` env vars > `"langsmith"`.
+ */
+export declare function resolveTracingMode(configValue?: TracingMode): TracingMode;
 export {};

package/dist/utils/env.js

@@ -201,3 +201,35 @@ export function getOtelEnabled() {
     return (getEnvironmentVariable("OTEL_ENABLED") === "true" ||
         getLangSmithEnvironmentVariable("OTEL_ENABLED") === "true");
 }
+const _VALID_TRACING_MODES = new Set(["langsmith", "otel"]);
+/**
+ * Resolve the effective tracing mode from an explicit config value and
+ * environment variables.
+ *
+ * Priority: explicit argument > `LANGSMITH_TRACING_MODE` env var >
+ * legacy `OTEL_ENABLED` / `LANGSMITH_OTEL_ENABLED` env vars > `"langsmith"`.
+ */
+export function resolveTracingMode(configValue) {
+    if (configValue !== undefined) {
+        return configValue;
+    }
+    const envMode = getLangSmithEnvironmentVariable("TRACING_MODE");
+    if (envMode !== undefined && envMode !== "") {
+        const lower = envMode.toLowerCase();
+        if (!_VALID_TRACING_MODES.has(lower)) {
+            throw new Error(`Invalid LANGSMITH_TRACING_MODE=${JSON.stringify(envMode)}. ` +
+                `Must be one of: ${[..._VALID_TRACING_MODES].sort().join(", ")}`);
+        }
+        if (getOtelEnabled()) {
+            console.warn("Both LANGSMITH_TRACING_MODE and the legacy OTEL_ENABLED / " +
+                "LANGSMITH_OTEL_ENABLED env vars are set. " +
+                "LANGSMITH_TRACING_MODE takes precedence.");
+        }
+        return lower;
+    }
+    // Fall back to legacy env var
+    if (getOtelEnabled()) {
+        return "otel";
+    }
+    return "langsmith";
+}

package/dist/utils/error.cjs

@@ -4,6 +4,7 @@ exports.ConflictingEndpointsError = exports.LangSmithNotFoundError = exports.Lan
 exports.getInvalidPromptIdentifierMsg = getInvalidPromptIdentifierMsg;
 exports.printErrorStackTrace = printErrorStackTrace;
 exports.isLangSmithNotFoundError = isLangSmithNotFoundError;
+exports.isLangSmithConflictError = isLangSmithConflictError;
 exports.raiseForStatus = raiseForStatus;
 exports.isConflictingEndpointsError = isConflictingEndpointsError;
 /**
@@ -115,6 +116,12 @@ function isLangSmithNotFoundError(error) {
         "name" in error &&
         error?.name === "LangSmithNotFoundError");
 }
+function isLangSmithConflictError(error) {
+    return (error != null &&
+        typeof error === "object" &&
+        "name" in error &&
+        error?.name === "LangSmithConflictError");
+}
 /**
  * Throws an appropriate error based on the response status and body.
  *

package/dist/utils/error.d.ts

@@ -55,6 +55,7 @@ export declare class LangSmithNotFoundError extends Error {
     constructor(message: string);
 }
 export declare function isLangSmithNotFoundError(error: unknown): error is LangSmithNotFoundError;
+export declare function isLangSmithConflictError(error: unknown): error is LangSmithConflictError;
 /**
  * Throws an appropriate error based on the response status and body.
  *

package/dist/utils/error.js

@@ -105,6 +105,12 @@ export function isLangSmithNotFoundError(error) {
         "name" in error &&
         error?.name === "LangSmithNotFoundError");
 }
+export function isLangSmithConflictError(error) {
+    return (error != null &&
+        typeof error === "object" &&
+        "name" in error &&
+        error?.name === "LangSmithConflictError");
+}
 /**
  * Throws an appropriate error based on the response status and body.
  *