langsmith 0.10.4 → 0.10.6

package/dist/utils/agent_addressing.js

@@ -0,0 +1,83 @@
+import { EnvAddressError, addressFromEnv, envNames, normalizeAddress, toWire, wireKeys, } 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. */
+export function checkAddress(address) {
+    return address == null ? undefined : normalizeAddress(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.`);
+    }
+}
+/** The highest level naming a project or an address, whichever it names. */
+export function firstNamed(...tiers) {
+    for (const [project, address] of tiers) {
+        rejectConflicting(project, address);
+        if (project || address) {
+            return [project || undefined, address];
+        }
+    }
+    return [undefined, undefined];
+}
+function getEnvProject() {
+    return (getLangSmithEnvironmentVariable("PROJECT") ||
+        getEnvironmentVariable("LANGCHAIN_SESSION") ||
+        undefined);
+}
+/**
+ * The env's destination: its address, else its project, else "default".
+ * @throws {EnvAddressError} For half an address, or an address and a project.
+ */
+export function resolveFromEnv() {
+    const project = getEnvProject();
+    const address = addressFromEnv();
+    if (project && address) {
+        throw new EnvAddressError("LANGSMITH_AGENT_* and a project are both set in the environment.");
+    }
+    return address ? [undefined, address] : [project ?? "default", undefined];
+}
+export function logUntraced(error) {
+    warnOnce(`LangSmith is not tracing this call: ${error.message}`);
+}
+/** Warn once, at client construction, if the env can't address runs. */
+export function warnOnEnv() {
+    if (!envNames().some((name) => getEnvironmentVariable(name))) {
+        return;
+    }
+    try {
+        resolveFromEnv();
+    }
+    catch (e) {
+        warnOnce(`${e.message} Runs that name no destination in code are ` +
+            "not traced.");
+    }
+}
+/**
+ * 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.
+ *
+ * @throws {EnvAddressError} If the env names half an address.
+ */
+export function applyToPayload(run, { update = false } = {}) {
+    const payload = run;
+    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) {
+        address = addressFromEnv();
+    }
+    if (!address) {
+        return;
+    }
+    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));
+    if (!namedProject) {
+        delete payload.session_name;
+        delete payload.session_id;
+    }
+}

package/dist/utils/env.cjs

@@ -113,6 +113,8 @@ function getLangSmithEnvVarsMetadata() {
         "LANGSMITH_CONFIG_FILE",
         "LANGSMITH_PROJECT",
         "LANGSMITH_SESSION",
+        "LANGSMITH_AGENT_ID",
+        "LANGSMITH_AGENT_ENVIRONMENT",
     ];
     for (const [key, value] of Object.entries(allEnvVars)) {
         if (typeof value === "string" &&

package/dist/utils/env.js

@@ -95,6 +95,8 @@ export function getLangSmithEnvVarsMetadata() {
         "LANGSMITH_CONFIG_FILE",
         "LANGSMITH_PROJECT",
         "LANGSMITH_SESSION",
+        "LANGSMITH_AGENT_ID",
+        "LANGSMITH_AGENT_ENVIRONMENT",
     ];
     for (const [key, value] of Object.entries(allEnvVars)) {
         if (typeof value === "string" &&

package/dist/utils/error.cjs

@@ -140,32 +140,27 @@ async function raiseForStatus(response, context, consumeOnSuccess) {
         }
         return;
     }
+    try {
+        errorBody = await response.text();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    }
+    catch (_e) {
+        errorBody = "";
+    }
     if (response.status === 403) {
+        let errorData;
         try {
-            const errorData = await response.json();
-            const errorCode = errorData?.error;
-            if (errorCode === "org_scoped_key_requires_workspace") {
-                errorBody =
-                    "This API key is org-scoped and requires workspace specification. " +
-                        "Please provide 'workspaceId' parameter, " +
-                        "or set LANGSMITH_WORKSPACE_ID environment variable.";
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        }
-        catch (_e) {
-            const errorWithStatus = new Error(`${response.status} ${response.statusText}`);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            errorWithStatus.status = response?.status;
-            throw errorWithStatus;
+            errorData = JSON.parse(errorBody);
         }
-    }
-    if (errorBody === undefined) {
-        try {
-            errorBody = await response.text();
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        catch {
+            // Non-JSON body (e.g. a proxy in front of a self-hosted instance):
+            // fall through and surface the raw body like every other status.
         }
-        catch (_e) {
-            errorBody = "";
+        if (errorData?.error === "org_scoped_key_requires_workspace") {
+            errorBody =
+                "This API key is org-scoped and requires workspace specification. " +
+                    "Please provide 'workspaceId' parameter, " +
+                    "or set LANGSMITH_WORKSPACE_ID environment variable.";
         }
     }
     const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Message: ${errorBody}`;

package/dist/utils/error.js

@@ -129,32 +129,27 @@ export async function raiseForStatus(response, context, consumeOnSuccess) {
         }
         return;
     }
+    try {
+        errorBody = await response.text();
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    }
+    catch (_e) {
+        errorBody = "";
+    }
     if (response.status === 403) {
+        let errorData;
         try {
-            const errorData = await response.json();
-            const errorCode = errorData?.error;
-            if (errorCode === "org_scoped_key_requires_workspace") {
-                errorBody =
-                    "This API key is org-scoped and requires workspace specification. " +
-                        "Please provide 'workspaceId' parameter, " +
-                        "or set LANGSMITH_WORKSPACE_ID environment variable.";
-            }
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        }
-        catch (_e) {
-            const errorWithStatus = new Error(`${response.status} ${response.statusText}`);
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            errorWithStatus.status = response?.status;
-            throw errorWithStatus;
+            errorData = JSON.parse(errorBody);
         }
-    }
-    if (errorBody === undefined) {
-        try {
-            errorBody = await response.text();
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        catch {
+            // Non-JSON body (e.g. a proxy in front of a self-hosted instance):
+            // fall through and surface the raw body like every other status.
         }
-        catch (_e) {
-            errorBody = "";
+        if (errorData?.error === "org_scoped_key_requires_workspace") {
+            errorBody =
+                "This API key is org-scoped and requires workspace specification. " +
+                    "Please provide 'workspaceId' parameter, " +
+                    "or set LANGSMITH_WORKSPACE_ID environment variable.";
         }
     }
     const fullMessage = `Failed to ${context}. Received status [${response.status}]: ${response.statusText}. Message: ${errorBody}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.10.4",
+  "version": "0.10.6",
   "description": "Client library to connect to the LangSmith Observability and Evaluation Platform.",
   "packageManager": "pnpm@10.33.0",
   "files": [
@@ -486,13 +486,13 @@
       "brace-expansion@<1.1.16": "1.1.16",
       "brace-expansion@>=2.0.0 <2.1.2": "2.1.2",
       "brace-expansion@>=3.0.0 <5.0.7": "5.0.7",
-      "fast-uri": "3.1.6",
+      "fast-uri": "3.1.8",
       "postcss": "8.5.23",
       "js-yaml": "4.3.2",
       "hono": "4.13.5",
-      "ip-address": "10.3.1",
-      "undici@>=7.0.0 <8.0.0": "7.29.0",
-      "undici@>=8.0.0 <9.0.0": "8.9.0",
+      "ip-address": "10.7.1",
+      "undici@>=7.0.0 <8.0.0": "7.29.1",
+      "undici@>=8.0.0 <9.0.0": "8.10.2",
       "vite": "^7.3.2",
       "form-data": "4.0.6",
       "langsmith": "0.6.0",