langsmith 0.0.38 → 0.0.40

package/dist/client.cjs

@@ -84,6 +84,12 @@ class Client {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "webUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "caller", {
             enumerable: true,
             configurable: true,
@@ -96,9 +102,16 @@ class Client {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "_tenantId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
         const defaultConfig = Client.getDefaultClientConfig();
         this.apiUrl = trimQuotes(config.apiUrl ?? defaultConfig.apiUrl) ?? "";
         this.apiKey = trimQuotes(config.apiKey ?? defaultConfig.apiKey);
+        this.webUrl = trimQuotes(config.webUrl ?? defaultConfig.webUrl);
         this.validateApiKeyIfHosted();
         this.timeout_ms = config.timeout_ms ?? 4000;
         this.caller = new async_caller_js_1.AsyncCaller(config.callerOptions ?? {});
@@ -110,6 +123,7 @@ class Client {
         return {
             apiUrl: apiUrl,
             apiKey: apiKey,
+            webUrl: undefined,
         };
     }
     validateApiKeyIfHosted() {
@@ -119,13 +133,19 @@ class Client {
         }
     }
     getHostUrl() {
-        if (isLocalhost(this.apiUrl)) {
+        if (this.webUrl) {
+            return this.webUrl;
+        }
+        else if (isLocalhost(this.apiUrl)) {
+            this.webUrl = "http://localhost";
             return "http://localhost";
         }
         else if (this.apiUrl.split(".", 1)[0].includes("dev")) {
+            this.webUrl = "https://dev.smith.langchain.com";
             return "https://dev.smith.langchain.com";
         }
         else {
+            this.webUrl = "https://smith.langchain.com";
             return "https://smith.langchain.com";
         }
     }
@@ -227,19 +247,45 @@ class Client {
         }
         return run;
     }
-    async getRunUrl({ runId, }) {
-        const run = await this.readRun(runId);
-        if (!run.app_path) {
-            return undefined;
+    async getRunUrl({ runId, run, projectOpts, }) {
+        if (run !== undefined) {
+            let sessionId;
+            if (run.session_id) {
+                sessionId = run.session_id;
+            }
+            else if (projectOpts?.projectName) {
+                sessionId = (await this.readProject({ projectName: projectOpts?.projectName })).id;
+            }
+            else if (projectOpts?.projectId) {
+                sessionId = projectOpts?.projectId;
+            }
+            else {
+                const project = await this.readProject({
+                    projectName: (0, env_js_1.getEnvironmentVariable)("LANGCHAIN_PROJECT") || "default",
+                });
+                sessionId = project.id;
+            }
+            const tenantId = await this._getTenantId();
+            return `${this.getHostUrl()}/o/${tenantId}/projects/p/${sessionId}/r/${run.id}?poll=true`;
+        }
+        else if (runId !== undefined) {
+            const run_ = await this.readRun(runId);
+            if (!run_.app_path) {
+                throw new Error(`Run ${runId} has no app_path`);
+            }
+            const baseUrl = this.getHostUrl();
+            return `${baseUrl}${run_.app_path}`;
+        }
+        else {
+            throw new Error("Must provide either runId or run");
         }
-        const baseUrl = this.getHostUrl();
-        return `${baseUrl}${run.app_path}`;
     }
     async _loadChildRuns(run) {
         const childRuns = await toArray(this.listRuns({ id: run.child_run_ids }));
         const treemap = {};
         const runs = {};
-        childRuns.sort((a, b) => a.execution_order - b.execution_order);
+        // TODO: make dotted order required when the migration finishes
+        childRuns.sort((a, b) => (a?.dotted_order ?? "").localeCompare(b?.dotted_order ?? ""));
         for (const childRun of childRuns) {
             if (childRun.parent_run_id === null ||
                 childRun.parent_run_id === undefined) {
@@ -399,6 +445,17 @@ class Client {
         }
         return result;
     }
+    async _getTenantId() {
+        if (this._tenantId !== null) {
+            return this._tenantId;
+        }
+        const queryParams = new URLSearchParams({ limit: "1" });
+        for await (const projects of this._getPaginated("/sessions", queryParams)) {
+            this._tenantId = projects[0].tenant_id;
+            return projects[0].tenant_id;
+        }
+        throw new Error("No projects found to resolve tenant.");
+    }
     async *listProjects({ projectIds, name, nameContains, referenceDatasetId, referenceDatasetName, referenceFree, } = {}) {
         const params = new URLSearchParams();
         if (projectIds !== undefined) {

package/dist/client.d.ts

@@ -6,6 +6,7 @@ interface ClientConfig {
     apiKey?: string;
     callerOptions?: AsyncCallerParams;
     timeout_ms?: number;
+    webUrl?: string;
 }
 interface ListRunsParams {
     projectId?: string;
@@ -48,6 +49,10 @@ interface CreateRunParams {
     parent_run_id?: string;
     project_name?: string;
 }
+interface projectOptions {
+    projectName?: string;
+    projectId?: string;
+}
 export type FeedbackSourceType = "model" | "api" | "app";
 export type CreateExampleOptions = {
     datasetId?: string;
@@ -58,12 +63,15 @@ export type CreateExampleOptions = {
 export declare class Client {
     private apiKey?;
     private apiUrl;
+    private webUrl?;
     private caller;
     private timeout_ms;
+    private _tenantId;
     constructor(config?: ClientConfig);
     static getDefaultClientConfig(): {
         apiUrl: string;
         apiKey?: string;
+        webUrl?: string;
     };
     private validateApiKeyIfHosted;
     private getHostUrl;
@@ -75,9 +83,11 @@ export declare class Client {
     readRun(runId: string, { loadChildRuns }?: {
         loadChildRuns: boolean;
     }): Promise<Run>;
-    getRunUrl({ runId, }: {
-        runId: string;
-    }): Promise<string | undefined>;
+    getRunUrl({ runId, run, projectOpts, }: {
+        runId?: string;
+        run?: Run;
+        projectOpts?: projectOptions;
+    }): Promise<string>;
     private _loadChildRuns;
     listRuns({ projectId, projectName, parentRunId, referenceExampleId, startTime, executionOrder, runType, error, id, limit, offset, query, filter, }: ListRunsParams): AsyncIterable<Run>;
     shareRun(runId: string, { shareId }?: {
@@ -95,6 +105,7 @@ export declare class Client {
         projectId?: string;
         projectName?: string;
     }): Promise<TracerSessionResult>;
+    private _getTenantId;
     listProjects({ projectIds, name, nameContains, referenceDatasetId, referenceDatasetName, referenceFree, }?: {
         projectIds?: string[];
         name?: string;

package/dist/client.js

@@ -58,6 +58,12 @@ export class Client {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "webUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "caller", {
             enumerable: true,
             configurable: true,
@@ -70,9 +76,16 @@ export class Client {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "_tenantId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
         const defaultConfig = Client.getDefaultClientConfig();
         this.apiUrl = trimQuotes(config.apiUrl ?? defaultConfig.apiUrl) ?? "";
         this.apiKey = trimQuotes(config.apiKey ?? defaultConfig.apiKey);
+        this.webUrl = trimQuotes(config.webUrl ?? defaultConfig.webUrl);
         this.validateApiKeyIfHosted();
         this.timeout_ms = config.timeout_ms ?? 4000;
         this.caller = new AsyncCaller(config.callerOptions ?? {});
@@ -84,6 +97,7 @@ export class Client {
         return {
             apiUrl: apiUrl,
             apiKey: apiKey,
+            webUrl: undefined,
         };
     }
     validateApiKeyIfHosted() {
@@ -93,13 +107,19 @@ export class Client {
         }
     }
     getHostUrl() {
-        if (isLocalhost(this.apiUrl)) {
+        if (this.webUrl) {
+            return this.webUrl;
+        }
+        else if (isLocalhost(this.apiUrl)) {
+            this.webUrl = "http://localhost";
             return "http://localhost";
         }
         else if (this.apiUrl.split(".", 1)[0].includes("dev")) {
+            this.webUrl = "https://dev.smith.langchain.com";
             return "https://dev.smith.langchain.com";
         }
         else {
+            this.webUrl = "https://smith.langchain.com";
             return "https://smith.langchain.com";
         }
     }
@@ -201,19 +221,45 @@ export class Client {
         }
         return run;
     }
-    async getRunUrl({ runId, }) {
-        const run = await this.readRun(runId);
-        if (!run.app_path) {
-            return undefined;
+    async getRunUrl({ runId, run, projectOpts, }) {
+        if (run !== undefined) {
+            let sessionId;
+            if (run.session_id) {
+                sessionId = run.session_id;
+            }
+            else if (projectOpts?.projectName) {
+                sessionId = (await this.readProject({ projectName: projectOpts?.projectName })).id;
+            }
+            else if (projectOpts?.projectId) {
+                sessionId = projectOpts?.projectId;
+            }
+            else {
+                const project = await this.readProject({
+                    projectName: getEnvironmentVariable("LANGCHAIN_PROJECT") || "default",
+                });
+                sessionId = project.id;
+            }
+            const tenantId = await this._getTenantId();
+            return `${this.getHostUrl()}/o/${tenantId}/projects/p/${sessionId}/r/${run.id}?poll=true`;
+        }
+        else if (runId !== undefined) {
+            const run_ = await this.readRun(runId);
+            if (!run_.app_path) {
+                throw new Error(`Run ${runId} has no app_path`);
+            }
+            const baseUrl = this.getHostUrl();
+            return `${baseUrl}${run_.app_path}`;
+        }
+        else {
+            throw new Error("Must provide either runId or run");
         }
-        const baseUrl = this.getHostUrl();
-        return `${baseUrl}${run.app_path}`;
     }
     async _loadChildRuns(run) {
         const childRuns = await toArray(this.listRuns({ id: run.child_run_ids }));
         const treemap = {};
         const runs = {};
-        childRuns.sort((a, b) => a.execution_order - b.execution_order);
+        // TODO: make dotted order required when the migration finishes
+        childRuns.sort((a, b) => (a?.dotted_order ?? "").localeCompare(b?.dotted_order ?? ""));
         for (const childRun of childRuns) {
             if (childRun.parent_run_id === null ||
                 childRun.parent_run_id === undefined) {
@@ -373,6 +419,17 @@ export class Client {
         }
         return result;
     }
+    async _getTenantId() {
+        if (this._tenantId !== null) {
+            return this._tenantId;
+        }
+        const queryParams = new URLSearchParams({ limit: "1" });
+        for await (const projects of this._getPaginated("/sessions", queryParams)) {
+            this._tenantId = projects[0].tenant_id;
+            return projects[0].tenant_id;
+        }
+        throw new Error("No projects found to resolve tenant.");
+    }
     async *listProjects({ projectIds, name, nameContains, referenceDatasetId, referenceDatasetName, referenceFree, } = {}) {
         const params = new URLSearchParams();
         if (projectIds !== undefined) {

package/dist/schemas.d.ts

@@ -95,6 +95,21 @@ export interface Run extends BaseRun {
     first_token_time?: number;
     /** IDs of parent runs, if multiple exist. */
     parent_run_ids?: string[];
+    /**Unique ID assigned to every run within this nested trace.**/
+    trace_id?: string;
+    /**
+     * The dotted order for the run.
+     *
+     * This is a string composed of {time}{run-uuid}.* so that a trace can be
+     * sorted in the order it was executed.
+     *
+     * Example:
+     * - Parent: 20230914T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8
+     * - Children:
+     *    - 20230914T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8.20230914T223155649Z809ed3a2-0172-4f4d-8a02-a64e9b7a0f8a
+     *   - 20230915T223155647Z1b64098b-4ab7-43f6-afee-992304f198d8.20230914T223155650Zc8d9f4c5-6c5a-4b2d-9b1c-3d9d7a7c5c7c
+     */
+    dotted_order?: string;
 }
 export interface RunCreate extends BaseRun {
     child_runs?: this[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
   "files": [
     "dist/",