@langchain/langgraph-cli 1.5.1 → 1.5.2-dev.0

package/dist/cli/deploy.mjs

@@ -326,15 +326,21 @@ async function resolveBuildMode(remoteBuildFlag) {
     }
     return [!supported, localBuildError];
 }
-async function resolveDeployment(client, step, deploymentId, name, notFoundMessage) {
+async function resolveDeployment(client, step, deploymentId, name, notFoundMessage, agent) {
     if (deploymentId) {
         emitter.step(step, `Using deployment ${deploymentId}`);
         await callWithOptionalTenant(client, (c) => c.getDeployment(deploymentId));
         return { deploymentId, needsCreation: false, step: step + 1 };
     }
-    emitter.step(step, `Looking up deployment '${name}'`);
-    const response = await callWithOptionalTenant(client, (c) => c.listDeployments(name));
-    const foundId = findDeploymentIdByName(response, name);
+    emitter.step(step, agent
+        ? `Looking up agent '${agent.agent_id}' in ${agent.environment}`
+        : `Looking up deployment '${name}'`);
+    const response = await callWithOptionalTenant(client, (c) => c.listDeployments(name, agent?.agent_id, agent?.environment));
+    let foundId = findDeploymentIdByName(response, name);
+    if (agent && Array.isArray(response.resources)) {
+        const found = response.resources.find((dep) => rec(dep).id && !rec(dep).is_preview);
+        foundId = found ? String(rec(found).id) : null;
+    }
     if (foundId) {
         emitter.info(`Found existing deployment (ID: ${foundId})`);
         return { deploymentId: foundId, needsCreation: false, step: step + 1 };
@@ -343,17 +349,28 @@ async function resolveDeployment(client, step, deploymentId, name, notFoundMessa
     return { deploymentId: undefined, needsCreation: true, step: step + 1 };
 }
 async function createDeployment(client, step, args) {
-    emitter.step(step, `Creating deployment '${args.name}'`);
-    const created = await client.createDeployment({
-        name: args.name,
-        deploymentType: args.deploymentType,
-        source: args.source,
-        secrets: args.secrets,
-    });
+    emitter.step(step, args.agent
+        ? `Creating deployment for agent '${args.agent.agent_id}' in ${args.agent.environment}`
+        : `Creating deployment '${args.name}'`);
+    let created;
+    try {
+        created = await client.createDeployment(args);
+    }
+    catch (error) {
+        if (args.agent &&
+            error instanceof HostBackendError &&
+            error.statusCode === 409) {
+            throw new HostBackendError("This agent already has a deployment in this environment.", 409);
+        }
+        throw error;
+    }
     const id = typeof created.id === "string" ? created.id : undefined;
     if (!id) {
         throw new HostBackendError("POST /v2/deployments succeeded but response missing a valid 'id'");
     }
+    if (args.agent && created.name) {
+        emitter.info(`Deployment name: ${created.name}`);
+    }
     emitter.info(`Deployment ID: ${id}`, { deployment_id: id });
     return { id, step: step + 1 };
 }
@@ -802,12 +819,42 @@ async function runRemoteBuild(args) {
         await archive.cleanup();
     }
 }
+// ---------------------------------------------------------------------------
+// Main deploy orchestration
+// ---------------------------------------------------------------------------
+function resolveAgentOptions(opts) {
+    const agentId = opts.agentId ?? (process.env.LANGSMITH_AGENT_ID || undefined);
+    const agentEnvironment = opts.agentEnvironment ??
+        (process.env.LANGSMITH_AGENT_ENVIRONMENT || undefined);
+    if (agentId !== undefined || agentEnvironment !== undefined) {
+        emitter.note("Note: --agent-id and --agent-environment flags are in private beta");
+    }
+    if (agentId !== undefined && !agentId.trim()) {
+        throw new Error("--agent-id must not be empty.");
+    }
+    if (agentEnvironment !== undefined &&
+        !["development", "staging", "production"].includes(agentEnvironment)) {
+        throw new Error("--agent-environment must be development, staging, or production.");
+    }
+    return { agentId, agentEnvironment };
+}
 async function runDeploy(dockerBuildArgs, opts, remoteBuildFlag) {
     emitter = new Emitter(opts.json);
     noInput = !opts.input;
     emitter.note("Note: 'langgraphjs deploy' is in beta. Expect frequent updates and improvements.");
     if (!opts.json)
         process.stdout.write("\n");
+    const { agentId, agentEnvironment } = resolveAgentOptions(opts);
+    let agent;
+    if (agentId !== undefined || agentEnvironment !== undefined) {
+        if (!agentId || !agentEnvironment) {
+            throw new Error("--agent-id and --agent-environment are required together.");
+        }
+        if (opts.name !== undefined || opts.deploymentId !== undefined) {
+            throw new Error("--agent-id and --agent-environment cannot be combined with --name or --deployment-id.");
+        }
+        agent = { agent_id: agentId, environment: agentEnvironment };
+    }
     if (!["dev", "prod"].includes(opts.deploymentType)) {
         throw new Error(`Invalid --deployment-type '${opts.deploymentType}' (expected 'dev' or 'prod').`);
     }
@@ -820,16 +867,16 @@ async function runDeploy(dockerBuildArgs, opts, remoteBuildFlag) {
     const envVars = await parseEnvFromConfig(rawConfig, configPath);
     let name = opts.name;
     let deploymentId = opts.deploymentId;
-    if (!deploymentId && !name) {
+    if (!agent && !deploymentId && !name) {
         name = envVars[DEPLOYMENT_NAME_ENV] ?? process.env[DEPLOYMENT_NAME_ENV];
     }
-    if (!deploymentId && !name) {
+    if (!agent && !deploymentId && !name) {
         const defaultName = normalizeName(path.basename(process.cwd()));
         name = noInput
             ? defaultName
             : await promptText("Deployment name", defaultName);
     }
-    if (name && !deploymentId) {
+    if (!agent && name && !deploymentId) {
         name = normalizeName(name);
         if (!noInput) {
             const envPath = await resolveEnvPath(rawConfig, configPath);
@@ -851,12 +898,13 @@ async function runDeploy(dockerBuildArgs, opts, remoteBuildFlag) {
     let step = 1;
     const resolved = await resolveDeployment(client, step, deploymentId, name, useRemoteBuild
         ? "No deployment found. Will create."
-        : "No deployment found. Will create after build.");
+        : "No deployment found. Will create after build.", agent);
     deploymentId = resolved.deploymentId;
     step = resolved.step;
     if (resolved.needsCreation) {
         const created = await createDeployment(client, step, {
-            name: name,
+            name,
+            agent,
             deploymentType: opts.deploymentType,
             source: useRemoteBuild ? "internal_source" : "internal_docker",
             secrets,
@@ -948,8 +996,9 @@ async function runDeploy(dockerBuildArgs, opts, remoteBuildFlag) {
 async function runList(opts) {
     emitter = new Emitter(false);
     noInput = false;
+    const { agentId, agentEnvironment } = resolveAgentOptions(opts);
     const client = await createHostBackendClient(opts.hostUrl, opts.apiKey);
-    const response = await callWithOptionalTenant(client, (c) => c.listDeployments(opts.nameContains));
+    const response = await callWithOptionalTenant(client, (c) => c.listDeployments(opts.nameContains, agentId, agentEnvironment));
     const resources = Array.isArray(rec(response).resources)
         ? rec(response).resources
         : [];
@@ -1107,6 +1156,8 @@ const deploy = builder
     .option("--api-key <key>", "API key (or LANGGRAPH_HOST_API_KEY / LANGSMITH_API_KEY / LANGCHAIN_API_KEY).")
     .option("--name <name>", "Deployment name (or LANGSMITH_DEPLOYMENT_NAME). Defaults to the current directory name.")
     .option("--deployment-id <id>", "ID of an existing deployment to update.")
+    .option("--agent-id <id>", "Agent ID (or LANGSMITH_AGENT_ID).")
+    .option("--agent-environment <environment>", "Agent environment: development, staging, or production (or LANGSMITH_AGENT_ENVIRONMENT).")
     .option("--deployment-type <type>", "Deployment type when creating: 'dev' or 'prod'.", "dev")
     .option("--no-wait", "Skip waiting for deployment status.")
     .option("--verbose", "Show more output from the server logs.", false)
@@ -1141,6 +1192,8 @@ const deploy = builder
 deploy
     .command("list")
     .description("[Beta] List LangSmith Deployments.")
+    .option("--agent-id <id>", "Agent ID (or LANGSMITH_AGENT_ID).")
+    .option("--agent-environment <environment>", "Agent environment: development, staging, or production (or LANGSMITH_AGENT_ENVIRONMENT).")
     .option("--api-key <key>", "API key.")
     .option("--host-url <url>", "Host backend URL.", DEFAULT_HOST_URL)
     .option("--name-contains <value>", "Only show deployments whose names contain this value.", "")

package/dist/cli/utils/host-backend.mjs

@@ -160,7 +160,7 @@ export class HostBackendClient {
      */
     createDeployment(args) {
         const payload = {
-            name: args.name,
+            ...(args.agent ? { agent: args.agent } : { name: args.name }),
             source: args.source,
             source_config: { deployment_type: args.deploymentType },
             source_revision_config: {},
@@ -179,9 +179,13 @@ export class HostBackendClient {
      * @param nameContains - Optional substring filter on deployment names.
      * @returns A paginated response object with a `resources` array.
      */
-    listDeployments(nameContains = "") {
+    listDeployments(nameContains = "", agentId, agentEnvironment) {
         return this.request("GET", "/v2/deployments", {
-            params: { name_contains: nameContains },
+            params: {
+                name_contains: nameContains,
+                agent_id: agentId,
+                agent_environment: agentEnvironment,
+            },
         });
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-cli",
-  "version": "1.5.1",
+  "version": "1.5.2-dev.0",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -39,8 +39,8 @@
     "winston-console-format": "^1.0.8",
     "yaml": "^2.8.3",
     "zod": "^3.25.76 || ^4",
-    "create-langgraph": "1.1.5",
-    "@langchain/langgraph-api": "1.5.1"
+    "@langchain/langgraph-api": "1.5.2-dev.0",
+    "create-langgraph": "1.1.5"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.0.6",