langsmith 0.1.50 → 0.1.52

package/dist/client.cjs

@@ -1597,6 +1597,13 @@ class Client {
      *                    similar examples in order of most similar to least similar. If no similar
      *                    examples are found, random examples will be returned.
      *
+     * @param filter      A filter string to apply to the search. Only examples will be returned that
+     *                    match the filter string. Some examples of filters
+     *
+     *                    - eq(metadata.mykey, "value")
+     *                    - and(neq(metadata.my.nested.key, "value"), neq(metadata.mykey, "value"))
+     *                    - or(eq(metadata.mykey, "value"), eq(metadata.mykey, "othervalue"))
+     *
      * @returns           A list of similar examples.
      *
      *
@@ -1606,11 +1613,14 @@ class Client {
      * limit = 5
      * examples = await client.similarExamples(inputs, dataset_id, limit)
      */
-    async similarExamples(inputs, datasetId, limit) {
+    async similarExamples(inputs, datasetId, limit, { filter, } = {}) {
         const data = {
             limit: limit,
             inputs: inputs,
         };
+        if (filter !== undefined) {
+            data["filter"] = filter;
+        }
         (0, _uuid_js_1.assertUuid)(datasetId);
         const response = await this.caller.call(fetch, `${this.apiUrl}/datasets/${datasetId}/search`, {
             method: "POST",
@@ -1623,7 +1633,7 @@ class Client {
         const result = await response.json();
         return result["examples"];
     }
-    async createExample(inputs, outputs, { datasetId, datasetName, createdAt, exampleId, metadata, split, }) {
+    async createExample(inputs, outputs, { datasetId, datasetName, createdAt, exampleId, metadata, split, sourceRunId, }) {
         let datasetId_ = datasetId;
         if (datasetId_ === undefined && datasetName === undefined) {
             throw new Error("Must provide either datasetName or datasetId");
@@ -1644,6 +1654,7 @@ class Client {
             id: exampleId,
             metadata,
             split,
+            source_run_id: sourceRunId,
         };
         const response = await this.caller.call(fetch, `${this.apiUrl}/examples`, {
             method: "POST",

package/dist/client.d.ts

@@ -141,12 +141,20 @@ interface ProjectOptions {
 type RecordStringAny = Record<string, any>;
 export type FeedbackSourceType = "model" | "api" | "app";
 export type CreateExampleOptions = {
+    /** The ID of the dataset to create the example in. */
     datasetId?: string;
+    /** The name of the dataset to create the example in (if dataset ID is not provided). */
     datasetName?: string;
+    /** The creation date of the example. */
     createdAt?: Date;
+    /** A unique identifier for the example. */
     exampleId?: string;
+    /** Additional metadata associated with the example. */
     metadata?: KVMap;
+    /** The split(s) to assign the example to. */
     split?: string | string[];
+    /** The ID of the source run associated with this example. */
+    sourceRunId?: string;
 };
 export declare class Queue<T> {
     items: [T, () => void][];
@@ -457,6 +465,13 @@ export declare class Client {
      *                    similar examples in order of most similar to least similar. If no similar
      *                    examples are found, random examples will be returned.
      *
+     * @param filter      A filter string to apply to the search. Only examples will be returned that
+     *                    match the filter string. Some examples of filters
+     *
+     *                    - eq(metadata.mykey, "value")
+     *                    - and(neq(metadata.my.nested.key, "value"), neq(metadata.mykey, "value"))
+     *                    - or(eq(metadata.mykey, "value"), eq(metadata.mykey, "othervalue"))
+     *
      * @returns           A list of similar examples.
      *
      *
@@ -466,8 +481,10 @@ export declare class Client {
      * limit = 5
      * examples = await client.similarExamples(inputs, dataset_id, limit)
      */
-    similarExamples(inputs: KVMap, datasetId: string, limit: number): Promise<ExampleSearch[]>;
-    createExample(inputs: KVMap, outputs: KVMap, { datasetId, datasetName, createdAt, exampleId, metadata, split, }: CreateExampleOptions): Promise<Example>;
+    similarExamples(inputs: KVMap, datasetId: string, limit: number, { filter, }?: {
+        filter?: string;
+    }): Promise<ExampleSearch[]>;
+    createExample(inputs: KVMap, outputs: KVMap, { datasetId, datasetName, createdAt, exampleId, metadata, split, sourceRunId, }: CreateExampleOptions): Promise<Example>;
     createExamples(props: {
         inputs: Array<KVMap>;
         outputs?: Array<KVMap>;

package/dist/client.js

@@ -1570,6 +1570,13 @@ export class Client {
      *                    similar examples in order of most similar to least similar. If no similar
      *                    examples are found, random examples will be returned.
      *
+     * @param filter      A filter string to apply to the search. Only examples will be returned that
+     *                    match the filter string. Some examples of filters
+     *
+     *                    - eq(metadata.mykey, "value")
+     *                    - and(neq(metadata.my.nested.key, "value"), neq(metadata.mykey, "value"))
+     *                    - or(eq(metadata.mykey, "value"), eq(metadata.mykey, "othervalue"))
+     *
      * @returns           A list of similar examples.
      *
      *
@@ -1579,11 +1586,14 @@ export class Client {
      * limit = 5
      * examples = await client.similarExamples(inputs, dataset_id, limit)
      */
-    async similarExamples(inputs, datasetId, limit) {
+    async similarExamples(inputs, datasetId, limit, { filter, } = {}) {
         const data = {
             limit: limit,
             inputs: inputs,
         };
+        if (filter !== undefined) {
+            data["filter"] = filter;
+        }
         assertUuid(datasetId);
         const response = await this.caller.call(fetch, `${this.apiUrl}/datasets/${datasetId}/search`, {
             method: "POST",
@@ -1596,7 +1606,7 @@ export class Client {
         const result = await response.json();
         return result["examples"];
     }
-    async createExample(inputs, outputs, { datasetId, datasetName, createdAt, exampleId, metadata, split, }) {
+    async createExample(inputs, outputs, { datasetId, datasetName, createdAt, exampleId, metadata, split, sourceRunId, }) {
         let datasetId_ = datasetId;
         if (datasetId_ === undefined && datasetName === undefined) {
             throw new Error("Must provide either datasetName or datasetId");
@@ -1617,6 +1627,7 @@ export class Client {
             id: exampleId,
             metadata,
             split,
+            source_run_id: sourceRunId,
         };
         const response = await this.caller.call(fetch, `${this.apiUrl}/examples`, {
             method: "POST",

package/dist/index.cjs

@@ -6,4 +6,4 @@ Object.defineProperty(exports, "Client", { enumerable: true, get: function () {
 var run_trees_js_1 = require("./run_trees.cjs");
 Object.defineProperty(exports, "RunTree", { enumerable: true, get: function () { return run_trees_js_1.RunTree; } });
 // Update using yarn bump-version
-exports.__version__ = "0.1.50";
+exports.__version__ = "0.1.52";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { Client, type ClientConfig } from "./client.js";
 export type { Dataset, Example, TracerSession, Run, Feedback, RetrieverOutput, } from "./schemas.js";
 export { RunTree, type RunTreeConfig } from "./run_trees.js";
-export declare const __version__ = "0.1.50";
+export declare const __version__ = "0.1.52";

package/dist/index.js

@@ -1,4 +1,4 @@
 export { Client } from "./client.js";
 export { RunTree } from "./run_trees.js";
 // Update using yarn bump-version
-export const __version__ = "0.1.50";
+export const __version__ = "0.1.52";

package/dist/schemas.d.ts

@@ -30,6 +30,7 @@ export interface BaseExample {
     inputs: KVMap;
     outputs?: KVMap;
     metadata?: KVMap;
+    source_run_id?: string;
 }
 /**
  * A run can represent either a trace (root run)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langsmith",
-  "version": "0.1.50",
+  "version": "0.1.52",
   "description": "Client library to connect to the LangSmith LLM Tracing and Evaluation Platform.",
   "packageManager": "yarn@1.22.19",
   "files": [