@langchain/langgraph-cli 1.5.0 → 1.5.1

package/dist/cli/build.mjs

@@ -1,6 +1,5 @@
 import { getDockerCapabilities } from "../docker/compose.mjs";
 import { assembleLocalDeps, configToDocker, getBaseImage, } from "../docker/docker.mjs";
-import { getExecaOptions } from "../docker/shell.mjs";
 import { getConfig } from "../utils/config.mjs";
 import { builder } from "./utils/builder.mjs";
 import { getProjectPath } from "./utils/project.mjs";
@@ -33,11 +32,11 @@ builder
     await getDockerCapabilities();
     const projectDir = path.dirname(configPath);
     const config = getConfig(await fs.readFile(configPath, "utf-8"));
-    const opts = await getExecaOptions({
+    const opts = {
         cwd: projectDir,
         stderr: "inherit",
         stdout: "inherit",
-    });
+    };
     const localDeps = await assembleLocalDeps(configPath, config);
     const input = await configToDocker(configPath, config, localDeps, {
         watch: false,

package/dist/cli/deploy.mjs

@@ -18,7 +18,7 @@ import { withAnalytics } from "./utils/analytics.mjs";
 import { getProjectPath } from "./utils/project.mjs";
 import { getConfig } from "../utils/config.mjs";
 import { assembleLocalDeps, configToDocker, getBaseImage, } from "../docker/docker.mjs";
-import { getExecaOptions } from "../docker/shell.mjs";
+import { DOCKER_NOT_INSTALLED, DOCKER_NOT_RUNNING, isBinaryNotFound, } from "../docker/errors.mjs";
 import { HostBackendClient, HostBackendError, } from "./utils/host-backend.mjs";
 import { Emitter, Spinner } from "./utils/deploy-output.mjs";
 import { createArchive, BYTES_PER_MIB } from "./utils/archive.mjs";
@@ -276,23 +276,18 @@ async function callWithOptionalTenant(client, operation) {
 // ---------------------------------------------------------------------------
 // Build mode resolution
 // ---------------------------------------------------------------------------
-const DOCKER_NOT_INSTALLED = "Docker is required but not installed.\n" +
-    "Install Docker Desktop: https://docs.docker.com/get-docker/";
-const DOCKER_NOT_RUNNING = "Docker is installed but not running.\nStart Docker and try again.";
 async function canBuildLocally() {
-    let opts;
-    try {
-        opts = await getExecaOptions({ reject: false });
-    }
-    catch {
-        return [false, DOCKER_NOT_INSTALLED];
-    }
+    const opts = { reject: false };
     try {
         const info = await $(opts) `docker info`;
+        if (isBinaryNotFound(info))
+            return [false, DOCKER_NOT_INSTALLED];
         if (info.exitCode !== 0)
             return [false, DOCKER_NOT_RUNNING];
     }
-    catch {
+    catch (error) {
+        if (isBinaryNotFound(error))
+            return [false, DOCKER_NOT_INSTALLED];
         return [false, DOCKER_NOT_RUNNING];
     }
     if (os.arch() !== "x64") {
@@ -583,7 +578,7 @@ async function runLocalBuild(args) {
     const dockerfile = generatedDockerfile.replace(/^FROM .*$/m, `FROM ${baseImageRef}`);
     const needsBuildx = os.arch() !== "x64";
     const localTag = `langgraph-deploy-tmp:${Math.floor(Date.now() / 1000)}`;
-    const baseOpts = await getExecaOptions({ cwd: projectDir });
+    const baseOpts = { cwd: projectDir };
     const stdio = args.verbose
         ? { stdout: "inherit", stderr: "inherit" }
         : { stdout: "ignore", stderr: "ignore" };

package/dist/cli/dev.mjs

@@ -7,6 +7,7 @@ import open from "open";
 import { startCloudflareTunnel } from "./cloudflare.mjs";
 import { createIpcServer } from "./utils/ipc/server.mjs";
 import { getProjectPath } from "./utils/project.mjs";
+import { DEFAULT_STUDIO_URL, resolveStudioUrl } from "./utils/studio-url.mjs";
 import { getConfig } from "../utils/config.mjs";
 import { builder } from "./utils/builder.mjs";
 import { logError, logger } from "../utils/logging.mjs";
@@ -22,6 +23,7 @@ builder
     .option("-n, --n-jobs-per-worker <number>", "number of workers to run", "10")
     .option("-c, --config <path>", "path to configuration file", process.cwd())
     .option("--tunnel", "use Cloudflare Tunnel to expose the server to the internet")
+    .option("--studio-url <url>", `URL of the LangGraph Studio instance to connect to (defaults to ${DEFAULT_STUDIO_URL})`)
     .allowExcessArguments()
     .allowUnknownOption()
     .exitOverride((error) => gracefulExit(error.exitCode))
@@ -31,6 +33,7 @@ builder
     host: command.opts().host !== "localhost",
     n_jobs_per_worker: command.opts().nJobsPerWorker !== "10",
     tunnel: Boolean(command.opts().tunnel),
+    studio_url: Boolean(command.opts().studioUrl),
 })))
     .action(async (options, { args }) => {
     try {
@@ -46,7 +49,7 @@ builder
         let hasOpenedFlag = false;
         let child = undefined;
         let tunnel = undefined;
-        let hostUrl = "https://smith.langchain.com";
+        let hostUrl = DEFAULT_STUDIO_URL;
         let envNoBrowser = process.env.BROWSER === "none";
         server.on("data", async (data) => {
             const response = z.object({ queryParams: z.string() }).parse(data);
@@ -103,16 +106,13 @@ builder
                 const removedTarget = oldWatch.filter((target) => !newWatch.includes(target));
                 watcher.unwatch(removedTarget).add(addedTarget);
             }
-            try {
+            hostUrl = await resolveStudioUrl(options.studioUrl, async () => {
                 const { Client } = await import("langsmith");
                 const apiUrl = env?.["LANGSMITH_ENDPOINT"] ||
                     env?.["LANGCHAIN_ENDPOINT"] ||
                     undefined;
-                hostUrl = new Client({ apiUrl }).getHostUrl() || hostUrl;
-            }
-            catch {
-                // pass
-            }
+                return new Client({ apiUrl }).getHostUrl();
+            });
             return { config, env, hostUrl };
         };
         const launchServer = async () => {

package/dist/cli/dev.python.mjs

@@ -121,6 +121,7 @@ export async function spawnPythonServer(args, context, options) {
         context.configPath,
         ...(args.browser ? [] : ["--no-browser"]),
         ...(args.reload ? [] : ["--no-reload"]),
+        ...(args.studioUrl ? ["--studio-url", args.studioUrl] : []),
         ...args.rest,
     ], {
         stdio: ["inherit", "inherit", "inherit"],

package/dist/cli/up.mjs

@@ -6,7 +6,6 @@ import { getProjectPath } from "./utils/project.mjs";
 import { logger } from "../utils/logging.mjs";
 import { createCompose, getDockerCapabilities } from "../docker/compose.mjs";
 import { configToCompose, getBaseImage } from "../docker/docker.mjs";
-import { getExecaOptions } from "../docker/shell.mjs";
 import { $ } from "execa";
 import { createHash } from "node:crypto";
 import dedent from "dedent";
@@ -71,11 +70,11 @@ builder
         watch: capabilities.watchAvailable,
     });
     const name = getProjectName(configPath);
-    const execOpts = await getExecaOptions({
+    const execOpts = {
         cwd,
         stdout: "inherit",
         stderr: "inherit",
-    });
+    };
     const exec = $(execOpts);
     if (!config._INTERNAL_docker_tag && params.pull) {
         // pull the image

package/dist/cli/utils/studio-url.mjs

@@ -0,0 +1,16 @@
+export const DEFAULT_STUDIO_URL = "https://smith.langchain.com";
+/**
+ * Resolves the Studio host the same way as the Python CLI: an explicit
+ * `--studio-url` wins, then the host derived from the LangSmith endpoint,
+ * then the public LangSmith host. `deriveUrl` only runs without a flag.
+ */
+export async function resolveStudioUrl(studioUrl, deriveUrl) {
+    if (studioUrl)
+        return studioUrl;
+    try {
+        return (await deriveUrl()) || DEFAULT_STUDIO_URL;
+    }
+    catch {
+        return DEFAULT_STUDIO_URL;
+    }
+}

package/dist/docker/compose.mjs

@@ -1,7 +1,7 @@
 import { $ } from "execa";
 import * as yaml from "yaml";
 import { z } from "zod/v3";
-import { getExecaOptions } from "./shell.mjs";
+import { DOCKER_NOT_INSTALLED, isBinaryNotFound } from "./errors.mjs";
 export const DEFAULT_POSTGRES_URI = "postgres://postgres:postgres@langgraph-postgres:5432/postgres?sslmode=disable";
 const REDIS = {
     image: "redis:6",
@@ -53,10 +53,12 @@ function compareVersion(a, b) {
 export async function getDockerCapabilities() {
     let rawInfo = null;
     try {
-        const { stdout } = await $(await getExecaOptions()) `docker info -f json`;
+        const { stdout } = await $ `docker info -f json`;
         rawInfo = JSON.parse(stdout);
     }
     catch (error) {
+        if (isBinaryNotFound(error))
+            throw new Error(DOCKER_NOT_INSTALLED);
         throw new Error("Docker not installed or not running: " + error);
     }
     const info = z
@@ -84,7 +86,7 @@ export async function getDockerCapabilities() {
     }
     else {
         try {
-            const standalone = await $(await getExecaOptions()) `docker-compose --version --short`;
+            const standalone = await $ `docker-compose --version --short`;
             composeRes = {
                 composeType: "standalone",
                 versionCompose: parseVersion(standalone.stdout),

package/dist/docker/errors.mjs

@@ -0,0 +1,22 @@
+/**
+ * Shared diagnostics for the Docker CLI invocations made by `build`, `up` and
+ * `deploy`.
+ *
+ * The `docker` binary is resolved from the inherited environment, exactly as
+ * any other command a user runs in their shell. These helpers turn a failed
+ * spawn into the same two-way distinction the Python CLI makes: the binary is
+ * missing, or the daemon is not answering.
+ */
+export const DOCKER_NOT_INSTALLED = "Docker is required but not installed.\n" +
+    "Install Docker Desktop: https://docs.docker.com/get-docker/";
+export const DOCKER_NOT_RUNNING = "Docker is installed but not running.\nStart Docker and try again.";
+/**
+ * Whether a rejected (or `reject: false`) execa call failed because the binary
+ * could not be found on `PATH`, as opposed to running and exiting non-zero.
+ */
+export function isBinaryNotFound(error) {
+    return (typeof error === "object" &&
+        error != null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-cli",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -40,7 +40,7 @@
     "yaml": "^2.8.3",
     "zod": "^3.25.76 || ^4",
     "create-langgraph": "1.1.5",
-    "@langchain/langgraph-api": "1.5.0"
+    "@langchain/langgraph-api": "1.5.1"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.0.6",

package/dist/docker/shell.mjs

@@ -1,62 +0,0 @@
-import { $ } from "execa";
-import { homedir } from "node:os";
-let PATH = undefined;
-// TODO: macOS related only
-async function getUserShell() {
-    const dscl = await $({
-        shell: true,
-    }) `dscl . -read ~/ UserShell | sed 's/UserShell: //'`;
-    return dscl.stdout.trim();
-}
-async function verifyDockerPath(PATH) {
-    await $({ env: { PATH } }) `which docker`;
-    return PATH;
-}
-// TODO: macOS related only
-async function extractPathFromShell() {
-    const pathToShell = await getUserShell().catch(() => "/bin/zsh");
-    const args = pathToShell.includes("csh")
-        ? ["-c", "echo $PATH"]
-        : ["-lc", "echo $PATH"];
-    const shell = await $(pathToShell, args);
-    return shell.stdout.trim();
-}
-// TODO: macOS related only
-async function guessUserPath() {
-    return [
-        "/bin",
-        "/usr/bin",
-        "/sbin",
-        "/usr/sbin",
-        "/opt/homebrew/bin",
-        "/opt/homebrew/sbin",
-        `${homedir()}/.local/bin`,
-        "/Applications/Docker.app/Contents/Resources/bin",
-        `${homedir()}/.docker/bin`,
-        // support for Rancher Desktop
-        // https://github.com/langchain-ai/langgraph-studio/issues/24#issuecomment-2274046328
-        // https://github.com/langchain-ai/langgraph-studio/issues/122
-        `${homedir()}/.rd/bin`,
-        `/Applications/Rancher Desktop.app/Contents/Resources/resources/darwin/bin`,
-    ].join(":");
-}
-async function getLoginPath() {
-    if (PATH)
-        return { PATH };
-    const [fromShell, fromBackup] = await Promise.allSettled([extractPathFromShell(), guessUserPath()].map((promise) => promise.then(verifyDockerPath)));
-    if (fromShell.status === "fulfilled") {
-        PATH = fromShell.value;
-    }
-    else if (fromBackup.status === "fulfilled") {
-        PATH = fromBackup.value;
-    }
-    else {
-        console.error("Failed to get PATH from shell or backup", fromShell.reason, fromBackup.reason);
-        throw fromShell.reason || fromBackup.reason;
-    }
-    return { PATH };
-}
-export async function getExecaOptions(options) {
-    const env = await getLoginPath();
-    return { ...options, env };
-}