langsmith 0.0.24 → 0.0.26

package/README.md

@@ -112,6 +112,8 @@ const parentRunConfig: RunTreeConfig = {
 
 const parentRun = new RunTree(parentRunConfig);
 
+await parentRun.postRun();
+
 const childLlmRun = await parentRun.createChild({
   name: "My Proprietary LLM",
   run_type: "llm",
@@ -123,6 +125,8 @@ const childLlmRun = await parentRun.createChild({
   },
 });
 
+await childLlmRun.postRun();
+
 await childLlmRun.end({
   outputs: {
     generations: [
@@ -132,6 +136,8 @@ await childLlmRun.end({
   },
 });
 
+await childLlmRun.patchRun();
+
 const childToolRun = await parentRun.createChild({
   name: "transcript_loader",
   run_type: "tool",
@@ -140,6 +146,7 @@ const childToolRun = await parentRun.createChild({
     content_type: "meeting_transcripts",
   },
 });
+await childToolRun.postRun();
 
 await childToolRun.end({
   outputs: {
@@ -147,6 +154,8 @@ await childToolRun.end({
   },
 });
 
+await childToolRun.patchRun();
+
 const childChainRun = await parentRun.createChild({
   name: "Unreliable Component",
   run_type: "tool",
@@ -155,6 +164,8 @@ const childChainRun = await parentRun.createChild({
   },
 });
 
+await childChainRun.postRun();
+
 try {
   // .... the component does work
   throw new Error("Something went wrong");
@@ -162,8 +173,12 @@ try {
   await childChainRun.end({
     error: `I errored again ${e.message}`,
   });
+  await childChainRun.patchRun(); 
+  throw e;
 }
 
+await childChainRun.patchRun();
+
 await parentRun.end({
   outputs: {
     output: ["The meeting notes are as follows:..."],
@@ -171,7 +186,7 @@ await parentRun.end({
 });
 
 // False directs to not exclude child runs
-await parentRun.postRun(false);
+await parentRun.patchRun();
 ```
 
 ### Create a Dataset from Existing Runs

package/dist/cli/docker-compose.beta.yaml

@@ -0,0 +1,18 @@
+version: '3'
+services:
+  # TODO: Move to the regular docker-compose.yaml once deployed
+  langchain-hub:
+    image: langchain/${_LANGSMITH_IMAGE_PREFIX-}langchainhub-backend:latest
+    environment:
+      - PORT=1985
+      - LANGCHAIN_ENV=local_docker
+      - LOG_LEVEL=warning
+    ports:
+      - 1985:1985
+    depends_on:
+      - langchain-db
+  langchain-db:
+    volumes:
+        - rc-langchain-db-data:/var/lib/postgresql/data
+volumes:
+    rc-langchain-db-data:

package/dist/cli/docker-compose.dev.yaml

@@ -1,7 +1,17 @@
 version: '3'
 services:
+  langchain-hub:
+    image: langchain/${_LANGSMITH_IMAGE_PREFIX-}langchainhub-backend:latest
+    environment:
+      - PORT=1985
+      - LANGCHAIN_ENV=local_docker
+      - LOG_LEVEL=warning
+    ports:
+      - 1985:1985
+    depends_on:
+      - langchain-db
   langchain-db:
     volumes:
-        - rc-langchain-db-data:/var/lib/postgresql/data
+        - dev-langchain-db-data:/var/lib/postgresql/data
 volumes:
-    rc-langchain-db-data:
+    dev-langchain-db-data:

package/dist/cli/docker-compose.yaml

@@ -26,7 +26,17 @@ services:
     environment:
       - LANGCHAIN_ENV=local_docker
       - LOG_LEVEL=warning
-    entrypoint: "rq worker --with-scheduler -u redis://langchain-redis:6379 --serializer lc_database.queue.serializer.ORJSONSerializer --worker-class lc_database.queue.worker.Worker"
+    entrypoint: "rq worker --with-scheduler -u redis://langchain-redis:6379 --serializer lc_database.queue.serializer.ORJSONSerializer --worker-class lc_database.queue.worker.Worker --connection-class lc_database.queue.connection.RedisRetry"
+  langchain-hub:
+    image: langchain/${_LANGSMITH_IMAGE_PREFIX-}langchainhub-backend:latest
+    environment:
+      - PORT=1985
+      - LANGCHAIN_ENV=local_docker
+      - LOG_LEVEL=warning
+    ports:
+      - 1985:1985
+    depends_on:
+      - langchain-db
   langchain-db:
     image: postgres:14.7
     command:

package/dist/cli/main.cjs

@@ -149,6 +149,12 @@ class SmithCommand {
             writable: true,
             value: ""
         });
+        Object.defineProperty(this, "dockerComposeBetaFile", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ""
+        });
         Object.defineProperty(this, "ngrokPath", {
             enumerable: true,
             configurable: true,
@@ -158,6 +164,7 @@ class SmithCommand {
         this.dockerComposeCommand = dockerComposeCommand;
         this.dockerComposeFile = path.join(path.dirname(currentFileName), "docker-compose.yaml");
         this.dockerComposeDevFile = path.join(path.dirname(currentFileName), "docker-compose.dev.yaml");
+        this.dockerComposeBetaFile = path.join(path.dirname(currentFileName), "docker-compose.beta.yaml");
         this.ngrokPath = path.join(path.dirname(currentFileName), "docker-compose.ngrok.yaml");
     }
     async executeCommand(command) {
@@ -178,28 +185,16 @@ class SmithCommand {
         });
     }
     static async create() {
+        console.info("BY USING THIS SOFTWARE YOU AGREE TO THE TERMS OF SERVICE AT:");
+        console.info("https://smith.langchain.com/terms-of-service.pdf");
         const dockerComposeCommand = await getDockerComposeCommand();
         return new SmithCommand({ dockerComposeCommand });
     }
-    async start(args) {
-        console.info("BY USING THIS SOFTWARE YOU AGREE TO THE TERMS OF SERVICE AT:");
-        console.info("https://smith.langchain.com/terms-of-service.pdf");
-        if (args.dev) {
-            (0, env_js_1.setEnvironmentVariable)("_LANGSMITH_IMAGE_PREFIX", "rc-");
-        }
-        if (args.openaiApiKey) {
-            (0, env_js_1.setEnvironmentVariable)("OPENAI_API_KEY", args.openaiApiKey);
-        }
-        await this.pull(args);
-        if (args.expose) {
-            await this.startAndExpose(args.ngrokAuthtoken, args.dev);
-        }
-        else {
-            await this.startLocal(args.dev);
+    async pull({ stage = "prod" }) {
+        if (stage === "dev") {
+            (0, env_js_1.setEnvironmentVariable)("_LANGSMITH_IMAGE_PREFIX", "dev-");
         }
-    }
-    async pull(args) {
-        if (args.dev) {
+        else if (stage === "beta") {
             (0, env_js_1.setEnvironmentVariable)("_LANGSMITH_IMAGE_PREFIX", "rc-");
         }
         const command = [
@@ -210,15 +205,18 @@ class SmithCommand {
         ];
         await this.executeCommand(command);
     }
-    async startLocal(dev) {
+    async startLocal(stage = "prod") {
         const command = [
             ...this.dockerComposeCommand,
             "-f",
             this.dockerComposeFile,
         ];
-        if (dev) {
+        if (stage === "dev") {
             command.push("-f", this.dockerComposeDevFile);
         }
+        else if (stage === "beta") {
+            command.push("-f", this.dockerComposeBetaFile);
+        }
         command.push("up", "--quiet-pull", "--wait");
         await this.executeCommand(command);
         console.info("LangSmith server is running at http://localhost:1984.\n" +
@@ -228,7 +226,7 @@ class SmithCommand {
             " when running your LangChain application.");
         console.info("\tLANGCHAIN_TRACING_V2=true");
     }
-    async startAndExpose(ngrokAuthToken, dev) {
+    async startAndExpose(ngrokAuthToken, stage = "prod") {
         const configPath = await createNgrokConfig(ngrokAuthToken);
         const command = [
             ...this.dockerComposeCommand,
@@ -237,9 +235,12 @@ class SmithCommand {
             "-f",
             this.ngrokPath,
         ];
-        if (dev) {
+        if (stage === "dev") {
             command.push("-f", this.dockerComposeDevFile);
         }
+        else if (stage === "beta") {
+            command.push("-f", this.dockerComposeBetaFile);
+        }
         command.push("up", "--quiet-pull", "--wait");
         await this.executeCommand(command);
         console.info("ngrok is running. You can view the dashboard at http://0.0.0.0:4040");
@@ -289,24 +290,54 @@ const startCommand = new commander_1.Command("start")
     .description("Start the LangSmith server")
     .option("--expose", "Expose the server to the internet via ngrok (requires ngrok to be installed)")
     .option("--ngrok-authtoken <ngrokAuthtoken>", "Your ngrok auth token. If this is set, --expose is implied.")
-    .option("--dev", "Run the development version of the LangSmith server")
+    .option("--stage <stage>", "Which version of LangSmith to run. Options: prod, dev, beta (default: prod)")
     .option("--openai-api-key <openaiApiKey>", "Your OpenAI API key. If not provided, the OpenAI API Key will be read" +
     " from the OPENAI_API_KEY environment variable. If neither are provided," +
     " some features of LangSmith will not be available.")
-    .action(async (args) => (await SmithCommand.create()).start(args));
+    .action(async (args) => {
+    const smith = await SmithCommand.create();
+    if (args.stage === "dev") {
+        (0, env_js_1.setEnvironmentVariable)("_LANGSMITH_IMAGE_PREFIX", "dev-");
+    }
+    else if (args.stage === "beta") {
+        (0, env_js_1.setEnvironmentVariable)("_LANGSMITH_IMAGE_PREFIX", "rc-");
+    }
+    if (args.openaiApiKey) {
+        (0, env_js_1.setEnvironmentVariable)("OPENAI_API_KEY", args.openaiApiKey);
+    }
+    await smith.pull({ stage: args.stage });
+    if (args.expose) {
+        await smith.startAndExpose(args.ngrokAuthtoken, args.stage);
+    }
+    else {
+        await smith.startLocal(args.stage);
+    }
+});
 const stopCommand = new commander_1.Command("stop")
-    .command("stop")
     .description("Stop the LangSmith server")
-    .action(async () => (await SmithCommand.create()).stop());
+    .action(async () => {
+    const smith = await SmithCommand.create();
+    await smith.stop();
+});
 const pullCommand = new commander_1.Command("pull")
-    .command("pull")
     .description("Pull the latest version of the LangSmith server")
-    .option("--dev", "Pull the development version of the LangSmith server")
-    .action(async (args) => (await SmithCommand.create()).pull(args));
+    .option("--stage <stage>", "Which version of LangSmith to pull. Options: prod, dev, beta (default: prod)")
+    .action(async (args) => {
+    const smith = await SmithCommand.create();
+    if (args.stage === "dev") {
+        (0, env_js_1.setEnvironmentVariable)("_LANGSMITH_IMAGE_PREFIX", "dev-");
+    }
+    else if (args.stage === "beta") {
+        (0, env_js_1.setEnvironmentVariable)("_LANGSMITH_IMAGE_PREFIX", "rc-");
+    }
+    await smith.pull({ stage: args.stage });
+});
 const statusCommand = new commander_1.Command("status")
-    .command("status")
     .description("Get the status of the LangSmith server")
-    .action(async () => (await SmithCommand.create()).status());
+    .action(async () => {
+    const smith = await SmithCommand.create();
+    await smith.status();
+});
 program
     .description("Manage the LangSmith server")
     .addCommand(startCommand)

package/dist/cli/main.js

@@ -123,6 +123,12 @@ class SmithCommand {
             writable: true,
             value: ""
         });
+        Object.defineProperty(this, "dockerComposeBetaFile", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: ""
+        });
         Object.defineProperty(this, "ngrokPath", {
             enumerable: true,
             configurable: true,
@@ -132,6 +138,7 @@ class SmithCommand {
         this.dockerComposeCommand = dockerComposeCommand;
         this.dockerComposeFile = path.join(path.dirname(currentFileName), "docker-compose.yaml");
         this.dockerComposeDevFile = path.join(path.dirname(currentFileName), "docker-compose.dev.yaml");
+        this.dockerComposeBetaFile = path.join(path.dirname(currentFileName), "docker-compose.beta.yaml");
         this.ngrokPath = path.join(path.dirname(currentFileName), "docker-compose.ngrok.yaml");
     }
     async executeCommand(command) {
@@ -152,28 +159,16 @@ class SmithCommand {
         });
     }
     static async create() {
+        console.info("BY USING THIS SOFTWARE YOU AGREE TO THE TERMS OF SERVICE AT:");
+        console.info("https://smith.langchain.com/terms-of-service.pdf");
         const dockerComposeCommand = await getDockerComposeCommand();
         return new SmithCommand({ dockerComposeCommand });
     }
-    async start(args) {
-        console.info("BY USING THIS SOFTWARE YOU AGREE TO THE TERMS OF SERVICE AT:");
-        console.info("https://smith.langchain.com/terms-of-service.pdf");
-        if (args.dev) {
-            setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
-        }
-        if (args.openaiApiKey) {
-            setEnvironmentVariable("OPENAI_API_KEY", args.openaiApiKey);
-        }
-        await this.pull(args);
-        if (args.expose) {
-            await this.startAndExpose(args.ngrokAuthtoken, args.dev);
+    async pull({ stage = "prod" }) {
+        if (stage === "dev") {
+            setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "dev-");
         }
-        else {
-            await this.startLocal(args.dev);
-        }
-    }
-    async pull(args) {
-        if (args.dev) {
+        else if (stage === "beta") {
             setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
         }
         const command = [
@@ -184,15 +179,18 @@ class SmithCommand {
         ];
         await this.executeCommand(command);
     }
-    async startLocal(dev) {
+    async startLocal(stage = "prod") {
         const command = [
             ...this.dockerComposeCommand,
             "-f",
             this.dockerComposeFile,
         ];
-        if (dev) {
+        if (stage === "dev") {
             command.push("-f", this.dockerComposeDevFile);
         }
+        else if (stage === "beta") {
+            command.push("-f", this.dockerComposeBetaFile);
+        }
         command.push("up", "--quiet-pull", "--wait");
         await this.executeCommand(command);
         console.info("LangSmith server is running at http://localhost:1984.\n" +
@@ -202,7 +200,7 @@ class SmithCommand {
             " when running your LangChain application.");
         console.info("\tLANGCHAIN_TRACING_V2=true");
     }
-    async startAndExpose(ngrokAuthToken, dev) {
+    async startAndExpose(ngrokAuthToken, stage = "prod") {
         const configPath = await createNgrokConfig(ngrokAuthToken);
         const command = [
             ...this.dockerComposeCommand,
@@ -211,9 +209,12 @@ class SmithCommand {
             "-f",
             this.ngrokPath,
         ];
-        if (dev) {
+        if (stage === "dev") {
             command.push("-f", this.dockerComposeDevFile);
         }
+        else if (stage === "beta") {
+            command.push("-f", this.dockerComposeBetaFile);
+        }
         command.push("up", "--quiet-pull", "--wait");
         await this.executeCommand(command);
         console.info("ngrok is running. You can view the dashboard at http://0.0.0.0:4040");
@@ -263,24 +264,54 @@ const startCommand = new Command("start")
     .description("Start the LangSmith server")
     .option("--expose", "Expose the server to the internet via ngrok (requires ngrok to be installed)")
     .option("--ngrok-authtoken <ngrokAuthtoken>", "Your ngrok auth token. If this is set, --expose is implied.")
-    .option("--dev", "Run the development version of the LangSmith server")
+    .option("--stage <stage>", "Which version of LangSmith to run. Options: prod, dev, beta (default: prod)")
     .option("--openai-api-key <openaiApiKey>", "Your OpenAI API key. If not provided, the OpenAI API Key will be read" +
     " from the OPENAI_API_KEY environment variable. If neither are provided," +
     " some features of LangSmith will not be available.")
-    .action(async (args) => (await SmithCommand.create()).start(args));
+    .action(async (args) => {
+    const smith = await SmithCommand.create();
+    if (args.stage === "dev") {
+        setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "dev-");
+    }
+    else if (args.stage === "beta") {
+        setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
+    }
+    if (args.openaiApiKey) {
+        setEnvironmentVariable("OPENAI_API_KEY", args.openaiApiKey);
+    }
+    await smith.pull({ stage: args.stage });
+    if (args.expose) {
+        await smith.startAndExpose(args.ngrokAuthtoken, args.stage);
+    }
+    else {
+        await smith.startLocal(args.stage);
+    }
+});
 const stopCommand = new Command("stop")
-    .command("stop")
     .description("Stop the LangSmith server")
-    .action(async () => (await SmithCommand.create()).stop());
+    .action(async () => {
+    const smith = await SmithCommand.create();
+    await smith.stop();
+});
 const pullCommand = new Command("pull")
-    .command("pull")
     .description("Pull the latest version of the LangSmith server")
-    .option("--dev", "Pull the development version of the LangSmith server")
-    .action(async (args) => (await SmithCommand.create()).pull(args));
+    .option("--stage <stage>", "Which version of LangSmith to pull. Options: prod, dev, beta (default: prod)")
+    .action(async (args) => {
+    const smith = await SmithCommand.create();
+    if (args.stage === "dev") {
+        setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "dev-");
+    }
+    else if (args.stage === "beta") {
+        setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
+    }
+    await smith.pull({ stage: args.stage });
+});
 const statusCommand = new Command("status")
-    .command("status")
     .description("Get the status of the LangSmith server")
-    .action(async () => (await SmithCommand.create()).status());
+    .action(async () => {
+    const smith = await SmithCommand.create();
+    await smith.status();
+});
 program
     .description("Manage the LangSmith server")
     .addCommand(startCommand)

package/dist/cli/main.ts

@@ -126,6 +126,7 @@ class SmithCommand {
   dockerComposeCommand: string[] = [];
   dockerComposeFile = "";
   dockerComposeDevFile = "";
+  dockerComposeBetaFile = "";
   ngrokPath = "";
 
   constructor({ dockerComposeCommand }: { dockerComposeCommand: string[] }) {
@@ -138,6 +139,10 @@ class SmithCommand {
       path.dirname(currentFileName),
       "docker-compose.dev.yaml"
     );
+    this.dockerComposeBetaFile = path.join(
+      path.dirname(currentFileName),
+      "docker-compose.beta.yaml"
+    );
     this.ngrokPath = path.join(
       path.dirname(currentFileName),
       "docker-compose.ngrok.yaml"
@@ -164,31 +169,18 @@ class SmithCommand {
   }
 
   public static async create() {
-    const dockerComposeCommand = await getDockerComposeCommand();
-    return new SmithCommand({ dockerComposeCommand });
-  }
-
-  async start(args: any) {
     console.info(
       "BY USING THIS SOFTWARE YOU AGREE TO THE TERMS OF SERVICE AT:"
     );
     console.info("https://smith.langchain.com/terms-of-service.pdf");
-    if (args.dev) {
-      setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
-    }
-    if (args.openaiApiKey) {
-      setEnvironmentVariable("OPENAI_API_KEY", args.openaiApiKey);
-    }
-    await this.pull(args);
-    if (args.expose) {
-      await this.startAndExpose(args.ngrokAuthtoken, args.dev);
-    } else {
-      await this.startLocal(args.dev);
-    }
+    const dockerComposeCommand = await getDockerComposeCommand();
+    return new SmithCommand({ dockerComposeCommand });
   }
 
-  async pull(args: any) {
-    if (args.dev) {
+  async pull({ stage = "prod" }) {
+    if (stage === "dev") {
+      setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "dev-");
+    } else if (stage === "beta") {
       setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
     }
 
@@ -201,17 +193,22 @@ class SmithCommand {
     await this.executeCommand(command);
   }
 
-  async startLocal(dev: boolean) {
+  async startLocal(stage = "prod") {
     const command = [
       ...this.dockerComposeCommand,
       "-f",
       this.dockerComposeFile,
     ];
-    if (dev) {
+
+    if (stage === "dev") {
       command.push("-f", this.dockerComposeDevFile);
+    } else if (stage === "beta") {
+      command.push("-f", this.dockerComposeBetaFile);
     }
+
     command.push("up", "--quiet-pull", "--wait");
     await this.executeCommand(command);
+
     console.info(
       "LangSmith server is running at http://localhost:1984.\n" +
         "To view the app, navigate your browser to http://localhost:80" +
@@ -219,10 +216,11 @@ class SmithCommand {
         " locally, set the following environment variable" +
         " when running your LangChain application."
     );
+
     console.info("\tLANGCHAIN_TRACING_V2=true");
   }
 
-  async startAndExpose(ngrokAuthToken: string | null, dev: boolean) {
+  async startAndExpose(ngrokAuthToken: string | null, stage = "prod") {
     const configPath = await createNgrokConfig(ngrokAuthToken);
     const command = [
       ...this.dockerComposeCommand,
@@ -231,11 +229,16 @@ class SmithCommand {
       "-f",
       this.ngrokPath,
     ];
-    if (dev) {
+
+    if (stage === "dev") {
       command.push("-f", this.dockerComposeDevFile);
+    } else if (stage === "beta") {
+      command.push("-f", this.dockerComposeBetaFile);
     }
+
     command.push("up", "--quiet-pull", "--wait");
     await this.executeCommand(command);
+
     console.info(
       "ngrok is running. You can view the dashboard at http://0.0.0.0:4040"
     );
@@ -264,6 +267,7 @@ class SmithCommand {
     ];
     await this.executeCommand(command);
   }
+
   async status() {
     const command = [
       ...this.dockerComposeCommand,
@@ -295,30 +299,63 @@ const startCommand = new Command("start")
     "--ngrok-authtoken <ngrokAuthtoken>",
     "Your ngrok auth token. If this is set, --expose is implied."
   )
-  .option("--dev", "Run the development version of the LangSmith server")
+  .option(
+    "--stage <stage>",
+    "Which version of LangSmith to run. Options: prod, dev, beta (default: prod)"
+  )
   .option(
     "--openai-api-key <openaiApiKey>",
     "Your OpenAI API key. If not provided, the OpenAI API Key will be read" +
       " from the OPENAI_API_KEY environment variable. If neither are provided," +
       " some features of LangSmith will not be available."
   )
-  .action(async (args: string[]) => (await SmithCommand.create()).start(args));
+  .action(async (args) => {
+    const smith = await SmithCommand.create();
+    if (args.stage === "dev") {
+      setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "dev-");
+    } else if (args.stage === "beta") {
+      setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
+    }
+    if (args.openaiApiKey) {
+      setEnvironmentVariable("OPENAI_API_KEY", args.openaiApiKey);
+    }
+    await smith.pull({ stage: args.stage });
+    if (args.expose) {
+      await smith.startAndExpose(args.ngrokAuthtoken, args.stage);
+    } else {
+      await smith.startLocal(args.stage);
+    }
+  });
 
 const stopCommand = new Command("stop")
-  .command("stop")
   .description("Stop the LangSmith server")
-  .action(async () => (await SmithCommand.create()).stop());
+  .action(async () => {
+    const smith = await SmithCommand.create();
+    await smith.stop();
+  });
 
 const pullCommand = new Command("pull")
-  .command("pull")
   .description("Pull the latest version of the LangSmith server")
-  .option("--dev", "Pull the development version of the LangSmith server")
-  .action(async (args: string[]) => (await SmithCommand.create()).pull(args));
+  .option(
+    "--stage <stage>",
+    "Which version of LangSmith to pull. Options: prod, dev, beta (default: prod)"
+  )
+  .action(async (args) => {
+    const smith = await SmithCommand.create();
+    if (args.stage === "dev") {
+      setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "dev-");
+    } else if (args.stage === "beta") {
+      setEnvironmentVariable("_LANGSMITH_IMAGE_PREFIX", "rc-");
+    }
+    await smith.pull({ stage: args.stage });
+  });
 
 const statusCommand = new Command("status")
-  .command("status")
   .description("Get the status of the LangSmith server")
-  .action(async () => (await SmithCommand.create()).status());
+  .action(async () => {
+    const smith = await SmithCommand.create();
+    await smith.status();
+  });
 
 program
   .description("Manage the LangSmith server")

package/dist/client.cjs

@@ -588,7 +588,7 @@ class Client {
         const path = `/examples/${exampleId}`;
         return await this._get(path);
     }
-    async *listExamples({ datasetId, datasetName, } = {}) {
+    async *listExamples({ datasetId, datasetName, exampleIds, } = {}) {
         let datasetId_;
         if (datasetId !== undefined && datasetName !== undefined) {
             throw new Error("Must provide either datasetName or datasetId, not both");
@@ -604,6 +604,11 @@ class Client {
             throw new Error("Must provide a datasetName or datasetId");
         }
         const params = new URLSearchParams({ dataset: datasetId_ });
+        if (exampleIds !== undefined) {
+            for (const id_ of exampleIds) {
+                params.append("id", id_);
+            }
+        }
         for await (const examples of this._getPaginated("/examples", params)) {
             yield* examples;
         }

package/dist/client.d.ts

@@ -122,9 +122,10 @@ export declare class Client {
         createdAt?: Date;
     }): Promise<Example>;
     readExample(exampleId: string): Promise<Example>;
-    listExamples({ datasetId, datasetName, }?: {
+    listExamples({ datasetId, datasetName, exampleIds, }?: {
         datasetId?: string;
         datasetName?: string;
+        exampleIds?: string[];
     }): AsyncIterable<Example>;
     deleteExample(exampleId: string): Promise<void>;
     updateExample(exampleId: string, update: ExampleUpdate): Promise<object>;

package/dist/client.js

@@ -562,7 +562,7 @@ export class Client {
         const path = `/examples/${exampleId}`;
         return await this._get(path);
     }
-    async *listExamples({ datasetId, datasetName, } = {}) {
+    async *listExamples({ datasetId, datasetName, exampleIds, } = {}) {
         let datasetId_;
         if (datasetId !== undefined && datasetName !== undefined) {
             throw new Error("Must provide either datasetName or datasetId, not both");
@@ -578,6 +578,11 @@ export class Client {
             throw new Error("Must provide a datasetName or datasetId");
         }
         const params = new URLSearchParams({ dataset: datasetId_ });
+        if (exampleIds !== undefined) {
+            for (const id_ of exampleIds) {
+                params.append("id", id_);
+            }
+        }
         for await (const examples of this._getPaginated("/examples", params)) {
             yield* examples;
         }

package/dist/run_trees.cjs

@@ -27,6 +27,13 @@ exports.RunTree = void 0;
 const uuid = __importStar(require("uuid"));
 const env_js_1 = require("./utils/env.cjs");
 const client_js_1 = require("./client.cjs");
+const warnedMessages = {};
+function warnOnce(message) {
+    if (!warnedMessages[message]) {
+        console.warn(message);
+        warnedMessages[message] = true;
+    }
+}
 class RunTree {
     constructor(config) {
         Object.defineProperty(this, "id", {
@@ -220,8 +227,14 @@ class RunTree {
         return persistedRun;
     }
     async postRun(excludeChildRuns = true) {
-        const runCreate = await this._convertToCreate(this, excludeChildRuns);
+        const runCreate = await this._convertToCreate(this, true);
         await this.client.createRun(runCreate);
+        if (!excludeChildRuns) {
+            warnOnce("Posting with excludeChildRuns=false is deprecated and will be removed in a future version.");
+            for (const childRun of this.child_runs) {
+                await childRun.postRun(false);
+            }
+        }
     }
     async patchRun() {
         const runUpdate = {

package/dist/run_trees.js

@@ -1,6 +1,13 @@
 import * as uuid from "uuid";
 import { getEnvironmentVariable, getRuntimeEnvironment } from "./utils/env.js";
 import { Client } from "./client.js";
+const warnedMessages = {};
+function warnOnce(message) {
+    if (!warnedMessages[message]) {
+        console.warn(message);
+        warnedMessages[message] = true;
+    }
+}
 export class RunTree {
     constructor(config) {
         Object.defineProperty(this, "id", {
@@ -194,8 +201,14 @@ export class RunTree {
         return persistedRun;
     }
     async postRun(excludeChildRuns = true) {
-        const runCreate = await this._convertToCreate(this, excludeChildRuns);
+        const runCreate = await this._convertToCreate(this, true);
         await this.client.createRun(runCreate);
+        if (!excludeChildRuns) {
+            warnOnce("Posting with excludeChildRuns=false is deprecated and will be removed in a future version.");
+            for (const childRun of this.child_runs) {
+                await childRun.postRun(false);
+            }
+        }
     }
     async patchRun() {
         const runUpdate = {

package/package.json

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