langsmith 0.0.17 → 0.0.20

package/README.md

@@ -12,6 +12,8 @@ LangSmith helps you and your team develop and evaluate language models and intel
 
 > **Note**: You can enjoy the benefits of LangSmith without using the LangChain open-source packages! To get started with your own proprietary framework, set up your account and then skip to [Logging Traces Outside LangChain](#logging-traces-outside-langchain).
 
+> **Cookbook:** For tutorials on how to get more value out of LangSmith, check out the [Langsmith Cookbook](https://github.com/langchain-ai/langsmith-cookbook/tree/main) repo.
+
 A typical workflow looks like:
 
 1. Set up an account with LangSmith.

package/dist/client.cjs

@@ -304,6 +304,45 @@ class Client {
         });
         await raiseForStatus(response, "delete run");
     }
+    async shareRun(runId, { shareId } = {}) {
+        const data = {
+            run_id: runId,
+            share_token: shareId || uuid.v4(),
+        };
+        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/${runId}/share`, {
+            method: "PUT",
+            headers: this.headers,
+            body: JSON.stringify(data),
+            signal: AbortSignal.timeout(this.timeout_ms),
+        });
+        // await raiseForStatus(response, "share run");
+        const result = await response.json();
+        if (result === null || !("share_token" in result)) {
+            throw new Error("Invalid response from server");
+        }
+        return `${this.getHostUrl()}/public/${result["share_token"]}/r`;
+    }
+    async unshareRun(runId) {
+        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/${runId}/share`, {
+            method: "DELETE",
+            headers: this.headers,
+            signal: AbortSignal.timeout(this.timeout_ms),
+        });
+        await raiseForStatus(response, "unshare run");
+    }
+    async readRunSharedLink(runId) {
+        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/${runId}/share`, {
+            method: "GET",
+            headers: this.headers,
+            signal: AbortSignal.timeout(this.timeout_ms),
+        });
+        // await raiseForStatus(response, "read run shared link");
+        const result = await response.json();
+        if (result === null || !("share_token" in result)) {
+            return undefined;
+        }
+        return `${this.getHostUrl()}/public/${result["share_token"]}/r`;
+    }
     async createProject({ projectName, projectExtra, upsert, }) {
         const upsert_ = upsert ? `?upsert=true` : "";
         const endpoint = `${this.apiUrl}/sessions${upsert_}`;

package/dist/client.d.ts

@@ -77,6 +77,11 @@ export declare class Client {
     private _loadChildRuns;
     listRuns({ projectId, projectName, parentRunId, referenceExampleId, datasetId, startTime, endTime, executionOrder, runType, error, id, limit, offset, query, filter, orderBy, }: ListRunsParams): AsyncIterable<Run>;
     deleteRun(runId: string): Promise<void>;
+    shareRun(runId: string, { shareId }?: {
+        shareId?: string;
+    }): Promise<string>;
+    unshareRun(runId: string): Promise<void>;
+    readRunSharedLink(runId: string): Promise<string | undefined>;
     createProject({ projectName, projectExtra, upsert, }: {
         projectName: string;
         projectExtra?: object;

package/dist/client.js

@@ -278,6 +278,45 @@ export class Client {
         });
         await raiseForStatus(response, "delete run");
     }
+    async shareRun(runId, { shareId } = {}) {
+        const data = {
+            run_id: runId,
+            share_token: shareId || uuid.v4(),
+        };
+        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/${runId}/share`, {
+            method: "PUT",
+            headers: this.headers,
+            body: JSON.stringify(data),
+            signal: AbortSignal.timeout(this.timeout_ms),
+        });
+        // await raiseForStatus(response, "share run");
+        const result = await response.json();
+        if (result === null || !("share_token" in result)) {
+            throw new Error("Invalid response from server");
+        }
+        return `${this.getHostUrl()}/public/${result["share_token"]}/r`;
+    }
+    async unshareRun(runId) {
+        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/${runId}/share`, {
+            method: "DELETE",
+            headers: this.headers,
+            signal: AbortSignal.timeout(this.timeout_ms),
+        });
+        await raiseForStatus(response, "unshare run");
+    }
+    async readRunSharedLink(runId) {
+        const response = await this.caller.call(fetch, `${this.apiUrl}/runs/${runId}/share`, {
+            method: "GET",
+            headers: this.headers,
+            signal: AbortSignal.timeout(this.timeout_ms),
+        });
+        // await raiseForStatus(response, "read run shared link");
+        const result = await response.json();
+        if (result === null || !("share_token" in result)) {
+            return undefined;
+        }
+        return `${this.getHostUrl()}/public/${result["share_token"]}/r`;
+    }
     async createProject({ projectName, projectExtra, upsert, }) {
         const upsert_ = upsert ? `?upsert=true` : "";
         const endpoint = `${this.apiUrl}/sessions${upsert_}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.0.17",
+  "version": "0.0.20",
   "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
   "files": [
     "dist/",
@@ -42,7 +42,7 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/langchain-ai/langchainplus-sdk.git"
+    "url": "git+https://github.com/langchain-ai/langsmith-sdk.git"
   },
   "keywords": [
     "LLM",
@@ -53,9 +53,9 @@
   "author": "LangChain",
   "license": "MIT",
   "bugs": {
-    "url": "https://github.com/langchain-ai/langchainplus-sdk/issues"
+    "url": "https://github.com/langchain-ai/langsmith-sdk/issues"
   },
-  "homepage": "https://github.com/langchain-ai/langchainplus-sdk#readme",
+  "homepage": "https://github.com/langchain-ai/langsmith-sdk#readme",
   "devDependencies": {
     "@babel/preset-env": "^7.22.4",
     "@jest/globals": "^29.5.0",