langsmith 0.10.9 → 0.10.10

package/dist/utils/addressing.d.ts

@@ -1,27 +0,0 @@
-import { AgentAddress, EnvAddressError } from "../address.js";
-/** One precedence level: the `[project, address]` it names. */
-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;
-/**
- * The env's destination: its address, else its project, else "default".
- * @throws {EnvAddressError} For half an address, or an address and a project.
- */
-export declare function resolveFromEnv(): Tier;
-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, 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?: AgentAddress;
-    session_id?: string;
-    session_name?: string;
-}, { update }?: {
-    update?: boolean;
-}): void;

package/dist/utils/addressing.js

@@ -1,91 +0,0 @@
-import { AgentAddress, EnvAddressError, ensureAgent, envNames, } from "../address.js";
-import { getEnvironmentVariable, getLangSmithEnvironmentVariable, } from "./env.js";
-import { warnOnce } from "./warn.js";
-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, 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 = AgentAddress.fromEnv();
-    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.");
-    }
-}
-/**
- * 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;
-    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 = 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._toLrn();
-    if (!namedProject) {
-        delete payload.session_name;
-        delete payload.session_id;
-    }
-}

package/dist/utils/asserts.cjs

@@ -1,47 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isReadableStream = exports.isThenable = exports.isGenerator = exports.isIteratorLike = exports.isAsyncIterable = void 0;
-exports.isPromiseMethod = isPromiseMethod;
-exports.isKVMap = isKVMap;
-function isPromiseMethod(x) {
-    if (x === "then" || x === "catch" || x === "finally") {
-        return true;
-    }
-    return false;
-}
-function isKVMap(x) {
-    if (typeof x !== "object" || x == null) {
-        return false;
-    }
-    const prototype = Object.getPrototypeOf(x);
-    return ((prototype === null ||
-        prototype === Object.prototype ||
-        Object.getPrototypeOf(prototype) === null) &&
-        !(Symbol.toStringTag in x) &&
-        !(Symbol.iterator in x));
-}
-const isAsyncIterable = (x) => x != null &&
-    typeof x === "object" &&
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    typeof x[Symbol.asyncIterator] === "function";
-exports.isAsyncIterable = isAsyncIterable;
-const isIteratorLike = (x) => x != null &&
-    typeof x === "object" &&
-    "next" in x &&
-    typeof x.next === "function";
-exports.isIteratorLike = isIteratorLike;
-const GeneratorFunction = function* () { }.constructor;
-const isGenerator = (x) => 
-// eslint-disable-next-line no-instanceof/no-instanceof
-x != null && typeof x === "function" && x instanceof GeneratorFunction;
-exports.isGenerator = isGenerator;
-const isThenable = (x) => x != null &&
-    typeof x === "object" &&
-    "then" in x &&
-    typeof x.then === "function";
-exports.isThenable = isThenable;
-const isReadableStream = (x) => x != null &&
-    typeof x === "object" &&
-    "getReader" in x &&
-    typeof x.getReader === "function";
-exports.isReadableStream = isReadableStream;

package/dist/utils/asserts.d.ts

@@ -1,7 +0,0 @@
-export declare function isPromiseMethod(x: string | symbol): x is "then" | "catch" | "finally";
-export declare function isKVMap(x: unknown): x is Record<string, unknown>;
-export declare const isAsyncIterable: (x: unknown) => x is AsyncIterable<unknown>;
-export declare const isIteratorLike: (x: unknown) => x is Iterator<unknown>;
-export declare const isGenerator: (x: unknown) => x is Generator;
-export declare const isThenable: (x: unknown) => x is Promise<unknown>;
-export declare const isReadableStream: (x: unknown) => x is ReadableStream;

package/dist/utils/asserts.js

@@ -1,37 +0,0 @@
-export function isPromiseMethod(x) {
-    if (x === "then" || x === "catch" || x === "finally") {
-        return true;
-    }
-    return false;
-}
-export function isKVMap(x) {
-    if (typeof x !== "object" || x == null) {
-        return false;
-    }
-    const prototype = Object.getPrototypeOf(x);
-    return ((prototype === null ||
-        prototype === Object.prototype ||
-        Object.getPrototypeOf(prototype) === null) &&
-        !(Symbol.toStringTag in x) &&
-        !(Symbol.iterator in x));
-}
-export const isAsyncIterable = (x) => x != null &&
-    typeof x === "object" &&
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    typeof x[Symbol.asyncIterator] === "function";
-export const isIteratorLike = (x) => x != null &&
-    typeof x === "object" &&
-    "next" in x &&
-    typeof x.next === "function";
-const GeneratorFunction = function* () { }.constructor;
-export const isGenerator = (x) => 
-// eslint-disable-next-line no-instanceof/no-instanceof
-x != null && typeof x === "function" && x instanceof GeneratorFunction;
-export const isThenable = (x) => x != null &&
-    typeof x === "object" &&
-    "then" in x &&
-    typeof x.then === "function";
-export const isReadableStream = (x) => x != null &&
-    typeof x === "object" &&
-    "getReader" in x &&
-    typeof x.getReader === "function";

package/dist/utils/async_caller.cjs

@@ -1,160 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AsyncCaller = void 0;
-const index_js_1 = __importDefault(require("../utils/p-retry/index.cjs"));
-const p_queue_js_1 = require("./p-queue.cjs");
-const STATUS_RETRYABLE = [
-    408, // Request Timeout
-    425, // Too Early
-    429, // Too Many Requests
-    500, // Internal Server Error
-    502, // Bad Gateway
-    503, // Service Unavailable
-    504, // Gateway Timeout
-];
-/**
- * A class that can be used to make async calls with concurrency and retry logic.
- *
- * This is useful for making calls to any kind of "expensive" external resource,
- * be it because it's rate-limited, subject to network issues, etc.
- *
- * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults
- * to `Infinity`. This means that by default, all calls will be made in parallel.
- *
- * Retries are limited by the `maxRetries` parameter, which defaults to 6. This
- * means that by default, each call will be retried up to 6 times, with an
- * exponential backoff between each attempt.
- */
-class AsyncCaller {
-    constructor(params) {
-        Object.defineProperty(this, "maxConcurrency", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxRetries", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxQueueSizeBytes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "queue", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onFailedResponseHook", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "queueSizeBytes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
-        this.maxConcurrency = params.maxConcurrency ?? Infinity;
-        this.maxRetries = params.maxRetries ?? 6;
-        this.maxQueueSizeBytes = params.maxQueueSizeBytes;
-        this.queue = new p_queue_js_1.PQueue({ concurrency: this.maxConcurrency });
-        this.onFailedResponseHook = params?.onFailedResponseHook;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    call(callable, ...args) {
-        return this.callWithOptions({}, callable, ...args);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    callWithOptions(options, callable, ...args) {
-        const sizeBytes = options.sizeBytes ?? 0;
-        // Check if adding this call would exceed the byte size limit
-        if (this.maxQueueSizeBytes !== undefined &&
-            sizeBytes > 0 &&
-            this.queueSizeBytes + sizeBytes > this.maxQueueSizeBytes) {
-            return Promise.reject(new Error(`Queue size limit (${this.maxQueueSizeBytes} bytes) exceeded. ` +
-                `Current queue size: ${this.queueSizeBytes} bytes, attempted addition: ${sizeBytes} bytes.`));
-        }
-        // Add to queue size tracking
-        if (sizeBytes > 0) {
-            this.queueSizeBytes += sizeBytes;
-        }
-        const onFailedResponseHook = this.onFailedResponseHook;
-        let promise = this.queue.add(() => (0, index_js_1.default)(() => callable(...args).catch((error) => {
-            // eslint-disable-next-line no-instanceof/no-instanceof
-            if (error instanceof Error) {
-                throw error;
-            }
-            else {
-                throw new Error(error);
-            }
-        }), {
-            async onFailedAttempt({ error }) {
-                // Rethrow the value if it's not an object
-                if (typeof error !== "object" || error == null)
-                    throw error;
-                const errorMessage = "message" in error && typeof error.message === "string"
-                    ? error.message
-                    : undefined;
-                if (errorMessage?.startsWith("Cancel") ||
-                    errorMessage?.startsWith("TimeoutError") ||
-                    errorMessage?.startsWith("AbortError")) {
-                    throw error;
-                }
-                if ("name" in error && error.name === "TimeoutError") {
-                    throw error;
-                }
-                if ("code" in error && error.code === "ECONNABORTED") {
-                    throw error;
-                }
-                const response = "response" in error
-                    ? error.response
-                    : undefined;
-                if (onFailedResponseHook) {
-                    const handled = await onFailedResponseHook(response);
-                    if (handled)
-                        return;
-                }
-                const status = response?.status ??
-                    ("status" in error ? error.status : undefined);
-                if (status != null &&
-                    (typeof status === "number" || typeof status === "string") &&
-                    !STATUS_RETRYABLE.includes(+status)) {
-                    throw error;
-                }
-            },
-            retries: this.maxRetries,
-            randomize: true,
-        }), { throwOnTimeout: true });
-        // Decrement queue size when the call completes (success or failure)
-        if (sizeBytes > 0) {
-            promise = promise.finally(() => {
-                this.queueSizeBytes -= sizeBytes;
-            });
-        }
-        // Handle signal cancellation
-        if (options.signal) {
-            return Promise.race([
-                promise,
-                new Promise((_, reject) => {
-                    options.signal?.addEventListener("abort", () => {
-                        reject(new Error("AbortError"));
-                    });
-                }),
-            ]);
-        }
-        return promise;
-    }
-}
-exports.AsyncCaller = AsyncCaller;

package/dist/utils/async_caller.d.ts

@@ -1,55 +0,0 @@
-import { PQueueType } from "./p-queue.js";
-type ResponseCallback = (response?: Response) => Promise<boolean>;
-export interface AsyncCallerParams {
-    /**
-     * The maximum number of concurrent calls that can be made.
-     * Defaults to `Infinity`, which means no limit.
-     */
-    maxConcurrency?: number;
-    /**
-     * The maximum number of retries that can be made for a single call,
-     * with an exponential backoff between each attempt. Defaults to 6.
-     */
-    maxRetries?: number;
-    /**
-     * The maximum size of the queue buffer in bytes. When the queue reaches this size,
-     * new calls will be dropped instead of queued.
-     * If not specified, no limit is enforced.
-     */
-    maxQueueSizeBytes?: number;
-    onFailedResponseHook?: ResponseCallback;
-    debug?: boolean;
-}
-export interface AsyncCallerCallOptions {
-    signal?: AbortSignal;
-    /**
-     * The size of this call in bytes, used for queue size tracking.
-     * If not provided, size tracking is skipped for this call.
-     */
-    sizeBytes?: number;
-}
-/**
- * A class that can be used to make async calls with concurrency and retry logic.
- *
- * This is useful for making calls to any kind of "expensive" external resource,
- * be it because it's rate-limited, subject to network issues, etc.
- *
- * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults
- * to `Infinity`. This means that by default, all calls will be made in parallel.
- *
- * Retries are limited by the `maxRetries` parameter, which defaults to 6. This
- * means that by default, each call will be retried up to 6 times, with an
- * exponential backoff between each attempt.
- */
-export declare class AsyncCaller {
-    protected maxConcurrency: AsyncCallerParams["maxConcurrency"];
-    protected maxRetries: AsyncCallerParams["maxRetries"];
-    protected maxQueueSizeBytes: AsyncCallerParams["maxQueueSizeBytes"];
-    queue: PQueueType;
-    private onFailedResponseHook?;
-    private queueSizeBytes;
-    constructor(params: AsyncCallerParams);
-    call<A extends any[], T extends (...args: A) => Promise<any>>(callable: T, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;
-    callWithOptions<A extends any[], T extends (...args: A) => Promise<any>>(options: AsyncCallerCallOptions, callable: T, ...args: Parameters<T>): Promise<Awaited<ReturnType<T>>>;
-}
-export {};

package/dist/utils/async_caller.js

@@ -1,153 +0,0 @@
-import pRetry from "../utils/p-retry/index.js";
-import { PQueue } from "./p-queue.js";
-const STATUS_RETRYABLE = [
-    408, // Request Timeout
-    425, // Too Early
-    429, // Too Many Requests
-    500, // Internal Server Error
-    502, // Bad Gateway
-    503, // Service Unavailable
-    504, // Gateway Timeout
-];
-/**
- * A class that can be used to make async calls with concurrency and retry logic.
- *
- * This is useful for making calls to any kind of "expensive" external resource,
- * be it because it's rate-limited, subject to network issues, etc.
- *
- * Concurrent calls are limited by the `maxConcurrency` parameter, which defaults
- * to `Infinity`. This means that by default, all calls will be made in parallel.
- *
- * Retries are limited by the `maxRetries` parameter, which defaults to 6. This
- * means that by default, each call will be retried up to 6 times, with an
- * exponential backoff between each attempt.
- */
-export class AsyncCaller {
-    constructor(params) {
-        Object.defineProperty(this, "maxConcurrency", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxRetries", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "maxQueueSizeBytes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "queue", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "onFailedResponseHook", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "queueSizeBytes", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: 0
-        });
-        this.maxConcurrency = params.maxConcurrency ?? Infinity;
-        this.maxRetries = params.maxRetries ?? 6;
-        this.maxQueueSizeBytes = params.maxQueueSizeBytes;
-        this.queue = new PQueue({ concurrency: this.maxConcurrency });
-        this.onFailedResponseHook = params?.onFailedResponseHook;
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    call(callable, ...args) {
-        return this.callWithOptions({}, callable, ...args);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    callWithOptions(options, callable, ...args) {
-        const sizeBytes = options.sizeBytes ?? 0;
-        // Check if adding this call would exceed the byte size limit
-        if (this.maxQueueSizeBytes !== undefined &&
-            sizeBytes > 0 &&
-            this.queueSizeBytes + sizeBytes > this.maxQueueSizeBytes) {
-            return Promise.reject(new Error(`Queue size limit (${this.maxQueueSizeBytes} bytes) exceeded. ` +
-                `Current queue size: ${this.queueSizeBytes} bytes, attempted addition: ${sizeBytes} bytes.`));
-        }
-        // Add to queue size tracking
-        if (sizeBytes > 0) {
-            this.queueSizeBytes += sizeBytes;
-        }
-        const onFailedResponseHook = this.onFailedResponseHook;
-        let promise = this.queue.add(() => pRetry(() => callable(...args).catch((error) => {
-            // eslint-disable-next-line no-instanceof/no-instanceof
-            if (error instanceof Error) {
-                throw error;
-            }
-            else {
-                throw new Error(error);
-            }
-        }), {
-            async onFailedAttempt({ error }) {
-                // Rethrow the value if it's not an object
-                if (typeof error !== "object" || error == null)
-                    throw error;
-                const errorMessage = "message" in error && typeof error.message === "string"
-                    ? error.message
-                    : undefined;
-                if (errorMessage?.startsWith("Cancel") ||
-                    errorMessage?.startsWith("TimeoutError") ||
-                    errorMessage?.startsWith("AbortError")) {
-                    throw error;
-                }
-                if ("name" in error && error.name === "TimeoutError") {
-                    throw error;
-                }
-                if ("code" in error && error.code === "ECONNABORTED") {
-                    throw error;
-                }
-                const response = "response" in error
-                    ? error.response
-                    : undefined;
-                if (onFailedResponseHook) {
-                    const handled = await onFailedResponseHook(response);
-                    if (handled)
-                        return;
-                }
-                const status = response?.status ??
-                    ("status" in error ? error.status : undefined);
-                if (status != null &&
-                    (typeof status === "number" || typeof status === "string") &&
-                    !STATUS_RETRYABLE.includes(+status)) {
-                    throw error;
-                }
-            },
-            retries: this.maxRetries,
-            randomize: true,
-        }), { throwOnTimeout: true });
-        // Decrement queue size when the call completes (success or failure)
-        if (sizeBytes > 0) {
-            promise = promise.finally(() => {
-                this.queueSizeBytes -= sizeBytes;
-            });
-        }
-        // Handle signal cancellation
-        if (options.signal) {
-            return Promise.race([
-                promise,
-                new Promise((_, reject) => {
-                    options.signal?.addEventListener("abort", () => {
-                        reject(new Error("AbortError"));
-                    });
-                }),
-            ]);
-        }
-        return promise;
-    }
-}

package/dist/utils/atee.cjs

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.atee = atee;
-function atee(iter, length = 2) {
-    const buffers = Array.from({ length }, () => []);
-    return buffers.map(async function* makeIter(buffer) {
-        while (true) {
-            if (buffer.length === 0) {
-                const result = await iter.next();
-                for (const buffer of buffers) {
-                    buffer.push(result);
-                }
-            }
-            else if (buffer[0].done) {
-                return;
-            }
-            else {
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                yield buffer.shift().value;
-            }
-        }
-    });
-}

package/dist/utils/atee.d.ts

@@ -1 +0,0 @@
-export declare function atee<T>(iter: AsyncGenerator<T>, length?: number): AsyncGenerator<T>[];

package/dist/utils/atee.js

@@ -1,20 +0,0 @@
-export function atee(iter, length = 2) {
-    const buffers = Array.from({ length }, () => []);
-    return buffers.map(async function* makeIter(buffer) {
-        while (true) {
-            if (buffer.length === 0) {
-                const result = await iter.next();
-                for (const buffer of buffers) {
-                    buffer.push(result);
-                }
-            }
-            else if (buffer[0].done) {
-                return;
-            }
-            else {
-                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-                yield buffer.shift().value;
-            }
-        }
-    });
-}