langsmith 0.10.11 → 0.10.13

package/lib/address.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EvaluatorAddress = exports.ExperimentAddress = exports.AgentAddress = exports.EnvAddressError = void 0;
-exports.ensureAgent = ensureAgent;
+exports.EnvAddressError = exports.EvaluatorAddress = exports.ExperimentAddress = exports.AgentAddress = void 0;
 exports.ensureAddress = ensureAddress;
+exports.ensureAgent = ensureAgent;
+exports.addressToLrn = addressToLrn;
+exports.addressFromLrn = addressFromLrn;
+exports.addressFromEnv = addressFromEnv;
 exports.envNames = envNames;
 /**
  * (beta) Addresses that name where runs are sent instead of a project.
@@ -22,16 +25,40 @@ exports.envNames = envNames;
  * ```
  */
 const env_js_1 = require("./utils/env.js");
+/** (beta) Construct and validate an agent address; plain objects are also accepted. */
+class AgentAddress {
+    constructor(id, environment) {
+        const address = ensureAgent({ kind: "AGENT", id, environment });
+        this.kind = address.kind;
+        this.id = address.id;
+        this.environment = address.environment;
+        Object.freeze(this);
+    }
+}
+exports.AgentAddress = AgentAddress;
+/** (beta) Construct and validate an experiment address. */
+class ExperimentAddress {
+    constructor(id) {
+        const address = ensureAddress({ kind: "EXPERIMENT", id });
+        this.kind = address.kind;
+        this.id = address.id;
+        Object.freeze(this);
+    }
+}
+exports.ExperimentAddress = ExperimentAddress;
+/** (beta) Construct the workspace's evaluators address. */
+class EvaluatorAddress {
+    constructor() {
+        this.kind = "EVALUATOR";
+        Object.freeze(this);
+    }
+}
+exports.EvaluatorAddress = EvaluatorAddress;
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 // 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])?$/;
-const ENVIRONMENTS = [
-    "local",
-    "development",
-    "staging",
-    "production",
-];
-// The wire form of an agent address. The parts are validated by `AgentAddress`.
+const ENVIRONMENTS = ["local", "development", "staging", "production"];
+// The wire form of an agent address. The parts are validated at entrypoints.
 const LRN_PATTERN = /^lrn:agents\/([^/]+)\/environments\/([^/]+)$/;
 const ENV_NAMES = ["LANGSMITH_AGENT_ID", "LANGSMITH_AGENT_ENVIRONMENT"];
 /** (beta) The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
@@ -42,169 +69,77 @@ class EnvAddressError extends Error {
     }
 }
 exports.EnvAddressError = EnvAddressError;
-/**
- * (beta) The address of an agent's environment.
- *
- * @example
- * ```ts
- * new AgentAddress("customer-support", "production");
- * ```
- */
-class AgentAddress {
-    /**
-     * @param id 1 to 63 lowercase ASCII letters, digits or hyphens, starting
-     *   with a letter and ending with a letter or digit. The server creates the
-     *   agent on first use.
-     * @param environment One of `local`, `development`, `staging` or `production`, in
-     *   any case.
-     * @throws If a value is invalid.
-     */
-    constructor(id, environment) {
-        Object.defineProperty(this, "id", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /** Always lowercase. */
-        Object.defineProperty(this, "environment", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        if (typeof id !== "string" || !AGENT_ID_PATTERN.test(id)) {
-            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(id)}. Use an id such as "support-agent".`);
-        }
-        const normalized = typeof environment === "string" ? environment.toLowerCase() : undefined;
-        if (normalized === undefined || !ENVIRONMENTS.includes(normalized)) {
-            throw new Error(`Address environment must be one of ${ENVIRONMENTS.join(", ")}, got ` +
-                `${JSON.stringify(environment)}.`);
-        }
-        this.id = id;
-        this.environment = normalized;
-        Object.freeze(this);
-    }
-    toApiAddress() {
-        return {
-            kind: "AGENT",
-            id: this.id,
-            environment: this.environment.toUpperCase(),
-        };
-    }
-    /** @internal */
-    _toLrn() {
-        return `lrn:agents/${this.id}/environments/${this.environment}`;
-    }
-    /**
-     * @internal Parse an LRN read from the wire, such as a `baggage` header. The
-     * value is untrusted, so it is not echoed in the error.
-     * @throws If `value` is not an agent LRN, or names an invalid id or environment.
-     */
-    static _fromLrn(value) {
-        const match = typeof value === "string" ? LRN_PATTERN.exec(value) : null;
-        if (match === null) {
-            throw new Error("Not an agent address.");
-        }
-        return new AgentAddress(match[1], match[2]);
-    }
-    /**
-     * Read the agent 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.
-     */
-    static fromEnv() {
-        const values = ENV_NAMES.map((name) => (0, env_js_1.getEnvironmentVariable)(name));
-        if (!values.some(Boolean)) {
-            return undefined;
-        }
-        try {
-            const missing = ENV_NAMES.filter((_, i) => !values[i]);
-            if (missing.length > 0) {
-                throw new Error(`An address needs ${missing.join(" and ")} as well.`);
-            }
-            return new AgentAddress(values[0], values[1]);
-        }
-        catch (e) {
-            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}`);
-        }
+function ensureAddress(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value !== "object") {
+        throw new Error("address must be an AgentAddress, ExperimentAddress or EvaluatorAddress object.");
     }
-}
-exports.AgentAddress = AgentAddress;
-/** (beta) The address of an experiment's tracing project. */
-class ExperimentAddress {
-    /**
-     * @param id The experiment's UUID.
-     * @throws If `id` is not a UUID.
-     */
-    constructor(id) {
-        /** Always lowercase. */
-        Object.defineProperty(this, "id", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+    const { kind, id, environment } = value;
+    if (kind === "EVALUATOR")
+        return { kind };
+    if (kind === "EXPERIMENT") {
         if (typeof id !== "string" || !UUID_PATTERN.test(id)) {
             throw new Error(`Experiment id must be a UUID, got ${JSON.stringify(id)}.`);
         }
-        this.id = id.toLowerCase();
-        Object.freeze(this);
+        return { kind, id: id.toLowerCase() };
     }
-    toApiAddress() {
-        return { kind: "EXPERIMENT", id: this.id };
+    if (kind !== "AGENT") {
+        throw new Error("address must be an AgentAddress, ExperimentAddress or EvaluatorAddress object.");
     }
-}
-exports.ExperimentAddress = ExperimentAddress;
-/** (beta) The address of the workspace's shared evaluators project. */
-class EvaluatorAddress {
-    constructor() {
-        Object.freeze(this);
+    if (typeof id !== "string" || !AGENT_ID_PATTERN.test(id)) {
+        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(id)}. Use an id such as "support-agent".`);
     }
-    toApiAddress() {
-        return { kind: "EVALUATOR" };
+    const normalized = typeof environment === "string" ? environment.toLowerCase() : undefined;
+    if (normalized === undefined || !ENVIRONMENTS.includes(normalized)) {
+        throw new Error(`Address environment must be one of ${ENVIRONMENTS.join(", ")}, got ${JSON.stringify(environment)}.`);
     }
+    return {
+        kind,
+        id,
+        environment: normalized.toUpperCase(),
+    };
 }
-exports.EvaluatorAddress = EvaluatorAddress;
-/**
- * @internal The ingestion entry-point guard: `value` must be an `AgentAddress` (or
- * absent), and is returned as is. Other addresses and strings are rejected.
- * @throws If `value` is not an `AgentAddress`.
- */
 function ensureAgent(value) {
-    if (value == null) {
-        return undefined;
-    }
-    if (value instanceof AgentAddress) {
-        return value;
+    const address = ensureAddress(value);
+    if (address && address.kind !== "AGENT") {
+        throw new Error(`Only an AgentAddress can receive traces, got ${address.kind}.`);
     }
-    if (typeof value === "object" &&
-        typeof value.toApiAddress === "function") {
-        throw new Error(`Only an AgentAddress can receive traces, got ${value.constructor?.name ?? "an unknown address"}.`);
-    }
-    throw new Error("address must be an AgentAddress such as `new AgentAddress(id, environment)`, got " +
-        `${typeof value === "string" ? JSON.stringify(value) : typeof value}.`);
+    return address;
 }
-/**
- * Return `value` if it is an `Address` of any kind, as a lookup takes it.
- * For the calls that only resolve an address to its project, such as
- * `getRunUrl`. Whatever receives traces takes `ensureAgent`.
- */
-function ensureAddress(value) {
-    if (value == null) {
+/** @internal Convert a validated address to the ingestion wire format. */
+function addressToLrn(address) {
+    return `lrn:agents/${address.id}/environments/${address.environment.toLowerCase()}`;
+}
+/** @internal Parse and validate an address from untrusted wire data. */
+function addressFromLrn(value) {
+    const match = typeof value === "string" ? LRN_PATTERN.exec(value) : null;
+    if (!match)
+        throw new Error("Not an agent address.");
+    return ensureAgent({ kind: "AGENT", id: match[1], environment: match[2] });
+}
+/** @internal Read and validate the address named by environment variables. */
+function addressFromEnv() {
+    const values = ENV_NAMES.map((name) => (0, env_js_1.getEnvironmentVariable)(name));
+    if (!values.some(Boolean))
         return undefined;
+    try {
+        const missing = ENV_NAMES.filter((_, i) => !values[i]);
+        if (missing.length)
+            throw new Error(`An address needs ${missing.join(" and ")} as well.`);
+        return ensureAgent({
+            kind: "AGENT",
+            id: values[0],
+            environment: values[1],
+        });
     }
-    if (typeof value === "object" &&
-        typeof value.toApiAddress === "function") {
-        return value;
+    catch (e) {
+        throw new EnvAddressError(`The LANGSMITH_AGENT_* env vars can't address a run: ${e.message}`);
     }
-    throw new Error("address must be an AgentAddress, ExperimentAddress or EvaluatorAddress, got " +
-        `${typeof value === "string" ? JSON.stringify(value) : typeof value}.`);
 }
-/** @internal The `LANGSMITH_AGENT_*` env var names an address reads. */
+/** @internal The environment variable names an address reads. */
 function envNames() {
     return ENV_NAMES;
 }

package/lib/address.js.map

@@ -1 +1 @@
-{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"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"}

package/lib/address.mjs

@@ -16,16 +16,37 @@
  * ```
  */
 import { getEnvironmentVariable } from "./utils/env.mjs";
+/** (beta) Construct and validate an agent address; plain objects are also accepted. */
+export class AgentAddress {
+    constructor(id, environment) {
+        const address = ensureAgent({ kind: "AGENT", id, environment });
+        this.kind = address.kind;
+        this.id = address.id;
+        this.environment = address.environment;
+        Object.freeze(this);
+    }
+}
+/** (beta) Construct and validate an experiment address. */
+export class ExperimentAddress {
+    constructor(id) {
+        const address = ensureAddress({ kind: "EXPERIMENT", id });
+        this.kind = address.kind;
+        this.id = address.id;
+        Object.freeze(this);
+    }
+}
+/** (beta) Construct the workspace's evaluators address. */
+export class EvaluatorAddress {
+    constructor() {
+        this.kind = "EVALUATOR";
+        Object.freeze(this);
+    }
+}
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 // 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])?$/;
-const ENVIRONMENTS = [
-    "local",
-    "development",
-    "staging",
-    "production",
-];
-// The wire form of an agent address. The parts are validated by `AgentAddress`.
+const ENVIRONMENTS = ["local", "development", "staging", "production"];
+// The wire form of an agent address. The parts are validated at entrypoints.
 const LRN_PATTERN = /^lrn:agents\/([^/]+)\/environments\/([^/]+)$/;
 const ENV_NAMES = ["LANGSMITH_AGENT_ID", "LANGSMITH_AGENT_ENVIRONMENT"];
 /** (beta) The `LANGSMITH_AGENT_*` / project env vars name half an address, or both. */
@@ -35,166 +56,77 @@ export class EnvAddressError extends Error {
         this.name = "EnvAddressError";
     }
 }
-/**
- * (beta) The address of an agent's environment.
- *
- * @example
- * ```ts
- * new AgentAddress("customer-support", "production");
- * ```
- */
-export class AgentAddress {
-    /**
-     * @param id 1 to 63 lowercase ASCII letters, digits or hyphens, starting
-     *   with a letter and ending with a letter or digit. The server creates the
-     *   agent on first use.
-     * @param environment One of `local`, `development`, `staging` or `production`, in
-     *   any case.
-     * @throws If a value is invalid.
-     */
-    constructor(id, environment) {
-        Object.defineProperty(this, "id", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        /** Always lowercase. */
-        Object.defineProperty(this, "environment", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        if (typeof id !== "string" || !AGENT_ID_PATTERN.test(id)) {
-            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(id)}. Use an id such as "support-agent".`);
-        }
-        const normalized = typeof environment === "string" ? environment.toLowerCase() : undefined;
-        if (normalized === undefined || !ENVIRONMENTS.includes(normalized)) {
-            throw new Error(`Address environment must be one of ${ENVIRONMENTS.join(", ")}, got ` +
-                `${JSON.stringify(environment)}.`);
-        }
-        this.id = id;
-        this.environment = normalized;
-        Object.freeze(this);
-    }
-    toApiAddress() {
-        return {
-            kind: "AGENT",
-            id: this.id,
-            environment: this.environment.toUpperCase(),
-        };
-    }
-    /** @internal */
-    _toLrn() {
-        return `lrn:agents/${this.id}/environments/${this.environment}`;
-    }
-    /**
-     * @internal Parse an LRN read from the wire, such as a `baggage` header. The
-     * value is untrusted, so it is not echoed in the error.
-     * @throws If `value` is not an agent LRN, or names an invalid id or environment.
-     */
-    static _fromLrn(value) {
-        const match = typeof value === "string" ? LRN_PATTERN.exec(value) : null;
-        if (match === null) {
-            throw new Error("Not an agent address.");
-        }
-        return new AgentAddress(match[1], match[2]);
-    }
-    /**
-     * Read the agent 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.
-     */
-    static fromEnv() {
-        const values = ENV_NAMES.map((name) => getEnvironmentVariable(name));
-        if (!values.some(Boolean)) {
-            return undefined;
-        }
-        try {
-            const missing = ENV_NAMES.filter((_, i) => !values[i]);
-            if (missing.length > 0) {
-                throw new Error(`An address needs ${missing.join(" and ")} as well.`);
-            }
-            return new AgentAddress(values[0], values[1]);
-        }
-        catch (e) {
-            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}`);
-        }
+export function ensureAddress(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value !== "object") {
+        throw new Error("address must be an AgentAddress, ExperimentAddress or EvaluatorAddress object.");
     }
-}
-/** (beta) The address of an experiment's tracing project. */
-export class ExperimentAddress {
-    /**
-     * @param id The experiment's UUID.
-     * @throws If `id` is not a UUID.
-     */
-    constructor(id) {
-        /** Always lowercase. */
-        Object.defineProperty(this, "id", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+    const { kind, id, environment } = value;
+    if (kind === "EVALUATOR")
+        return { kind };
+    if (kind === "EXPERIMENT") {
         if (typeof id !== "string" || !UUID_PATTERN.test(id)) {
             throw new Error(`Experiment id must be a UUID, got ${JSON.stringify(id)}.`);
         }
-        this.id = id.toLowerCase();
-        Object.freeze(this);
+        return { kind, id: id.toLowerCase() };
     }
-    toApiAddress() {
-        return { kind: "EXPERIMENT", id: this.id };
+    if (kind !== "AGENT") {
+        throw new Error("address must be an AgentAddress, ExperimentAddress or EvaluatorAddress object.");
     }
-}
-/** (beta) The address of the workspace's shared evaluators project. */
-export class EvaluatorAddress {
-    constructor() {
-        Object.freeze(this);
+    if (typeof id !== "string" || !AGENT_ID_PATTERN.test(id)) {
+        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(id)}. Use an id such as "support-agent".`);
     }
-    toApiAddress() {
-        return { kind: "EVALUATOR" };
+    const normalized = typeof environment === "string" ? environment.toLowerCase() : undefined;
+    if (normalized === undefined || !ENVIRONMENTS.includes(normalized)) {
+        throw new Error(`Address environment must be one of ${ENVIRONMENTS.join(", ")}, got ${JSON.stringify(environment)}.`);
     }
+    return {
+        kind,
+        id,
+        environment: normalized.toUpperCase(),
+    };
 }
-/**
- * @internal The ingestion entry-point guard: `value` must be an `AgentAddress` (or
- * absent), and is returned as is. Other addresses and strings are rejected.
- * @throws If `value` is not an `AgentAddress`.
- */
 export function ensureAgent(value) {
-    if (value == null) {
-        return undefined;
-    }
-    if (value instanceof AgentAddress) {
-        return value;
-    }
-    if (typeof value === "object" &&
-        typeof value.toApiAddress === "function") {
-        throw new Error(`Only an AgentAddress can receive traces, got ${value.constructor?.name ?? "an unknown address"}.`);
+    const address = ensureAddress(value);
+    if (address && address.kind !== "AGENT") {
+        throw new Error(`Only an AgentAddress can receive traces, got ${address.kind}.`);
     }
-    throw new Error("address must be an AgentAddress such as `new AgentAddress(id, environment)`, got " +
-        `${typeof value === "string" ? JSON.stringify(value) : typeof value}.`);
+    return address;
 }
-/**
- * Return `value` if it is an `Address` of any kind, as a lookup takes it.
- * For the calls that only resolve an address to its project, such as
- * `getRunUrl`. Whatever receives traces takes `ensureAgent`.
- */
-export function ensureAddress(value) {
-    if (value == null) {
+/** @internal Convert a validated address to the ingestion wire format. */
+export function addressToLrn(address) {
+    return `lrn:agents/${address.id}/environments/${address.environment.toLowerCase()}`;
+}
+/** @internal Parse and validate an address from untrusted wire data. */
+export function addressFromLrn(value) {
+    const match = typeof value === "string" ? LRN_PATTERN.exec(value) : null;
+    if (!match)
+        throw new Error("Not an agent address.");
+    return ensureAgent({ kind: "AGENT", id: match[1], environment: match[2] });
+}
+/** @internal Read and validate the address named by environment variables. */
+export function addressFromEnv() {
+    const values = ENV_NAMES.map((name) => getEnvironmentVariable(name));
+    if (!values.some(Boolean))
         return undefined;
+    try {
+        const missing = ENV_NAMES.filter((_, i) => !values[i]);
+        if (missing.length)
+            throw new Error(`An address needs ${missing.join(" and ")} as well.`);
+        return ensureAgent({
+            kind: "AGENT",
+            id: values[0],
+            environment: values[1],
+        });
     }
-    if (typeof value === "object" &&
-        typeof value.toApiAddress === "function") {
-        return value;
+    catch (e) {
+        throw new EnvAddressError(`The LANGSMITH_AGENT_* env vars can't address a run: ${e.message}`);
     }
-    throw new Error("address must be an AgentAddress, ExperimentAddress or EvaluatorAddress, got " +
-        `${typeof value === "string" ? JSON.stringify(value) : typeof value}.`);
 }
-/** @internal The `LANGSMITH_AGENT_*` env var names an address reads. */
+/** @internal The environment variable names an address reads. */
 export function envNames() {
     return ENV_NAMES;
 }

package/lib/address.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"address.mjs","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"address.mjs","sourceRoot":"","sources":["../src/lib/address.ts"],"names":[],"mappings":"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"}

package/lib/client.d.mts

@@ -637,7 +637,7 @@ export declare class Client implements LangSmithTracingClientInterface {
     get traces(): Traces;
     /**
      * (beta) Access the sessions resource, which resolves an address to the
-     * project its traces go to: `client.sessions.resolve(address.toApiAddress())`.
+     * project its traces go to: `client.sessions.resolve(address)`.
      */
     get sessions(): Sessions;
     /** Access the public shared-run resource. */