@langchain/langgraph-api 0.0.56 → 0.0.57

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @langchain/langgraph-api
 
+## 0.0.57
+
+### Patch Changes
+
+- 31cc9f7: support description property for `langgraph.json`
+  - @langchain/langgraph-ui@0.0.57
+
 ## 0.0.56
 
 ### Patch Changes

package/dist/cli/spawn.d.mts

@@ -4,7 +4,10 @@ export declare function spawnServer(args: {
     nJobsPerWorker: string;
 }, context: {
     config: {
-        graphs: Record<string, string>;
+        graphs: Record<string, string | {
+            path: string;
+            description?: string;
+        }>;
         ui?: Record<string, string>;
         ui_config?: {
             shared?: string[];

package/dist/preload.mjs

@@ -8,9 +8,18 @@ const options = JSON.parse(lastArg || "{}");
 // find the first file, as `parentURL` needs to be a valid file URL
 // if no graph found, just assume a dummy default file, which should
 // be working fine as well.
-const firstGraphFile = Object.values(options.graphs)
-    .flatMap((i) => i.split(":").at(0))
-    .at(0) || "index.mts";
+const graphFiles = Object.values(options.graphs)
+    .map((i) => {
+    if (typeof i === "string") {
+        return i.split(":").at(0);
+    }
+    else if (i && typeof i === "object" && i.path) {
+        return i.path.split(":").at(0);
+    }
+    return null;
+})
+    .filter(Boolean);
+const firstGraphFile = graphFiles.at(0) || "index.mts";
 // enforce API @langchain/langgraph resolution
 register("./graph/load.hooks.mjs", import.meta.url, {
     parentURL: "data:",

package/dist/server.d.mts

@@ -4,7 +4,16 @@ export declare const StartServerSchema: z.ZodObject<{
     nWorkers: z.ZodNumber;
     host: z.ZodString;
     cwd: z.ZodString;
-    graphs: z.ZodRecord<z.ZodString, z.ZodString>;
+    graphs: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        description?: string | undefined;
+    }, {
+        path: string;
+        description?: string | undefined;
+    }>]>>;
     auth: z.ZodOptional<z.ZodObject<{
         path: z.ZodOptional<z.ZodString>;
         disable_studio_auth: z.ZodDefault<z.ZodBoolean>;
@@ -93,7 +102,10 @@ export declare const StartServerSchema: z.ZodObject<{
     host: string;
     port: number;
     nWorkers: number;
-    graphs: Record<string, string>;
+    graphs: Record<string, string | {
+        path: string;
+        description?: string | undefined;
+    }>;
     auth?: {
         disable_studio_auth: boolean;
         path?: string | undefined;
@@ -124,7 +136,10 @@ export declare const StartServerSchema: z.ZodObject<{
     host: string;
     port: number;
     nWorkers: number;
-    graphs: Record<string, string>;
+    graphs: Record<string, string | {
+        path: string;
+        description?: string | undefined;
+    }>;
     auth?: {
         path?: string | undefined;
         disable_studio_auth?: boolean | undefined;

package/dist/server.mjs

@@ -25,7 +25,10 @@ export const StartServerSchema = z.object({
     nWorkers: z.number(),
     host: z.string(),
     cwd: z.string(),
-    graphs: z.record(z.string()),
+    graphs: z.record(z.union([
+        z.string(),
+        z.object({ path: z.string(), description: z.string().optional() }),
+    ])),
     auth: z
         .object({
         path: z.string().optional(),
@@ -79,7 +82,20 @@ export async function startServer(options) {
     // We need to do this before we load the graphs in-case the logger is obtained at top-level.
     registerSdkLogger();
     logger.info(`Registering graphs from ${options.cwd}`);
-    await registerFromEnv(options.graphs, { cwd: options.cwd });
+    let hasGraphDescriptions = false;
+    const graphPaths = Object.fromEntries(Object.entries(options.graphs).map(([graphId, rawSpec]) => {
+        if (typeof rawSpec === "string") {
+            return [graphId, rawSpec];
+        }
+        if (rawSpec.description) {
+            hasGraphDescriptions = true;
+        }
+        return [graphId, rawSpec.path];
+    }));
+    if (hasGraphDescriptions) {
+        logger.warn("A graph definition in `langgraph.json` has a `description` property. Local MCP features are not yet supported with the JS CLI and will be ignored.");
+    }
+    await registerFromEnv(graphPaths, { cwd: options.cwd });
     registerRuntimeLogFormatter((info) => {
         const config = getConfig();
         if (config == null)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "0.0.56",
+  "version": "0.0.57",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -52,7 +52,7 @@
     "@babel/code-frame": "^7.26.2",
     "@hono/node-server": "^1.12.0",
     "@hono/zod-validator": "^0.2.2",
-    "@langchain/langgraph-ui": "0.0.56",
+    "@langchain/langgraph-ui": "0.0.57",
     "@types/json-schema": "^7.0.15",
     "@typescript/vfs": "^1.6.0",
     "dedent": "^1.5.3",
@@ -84,7 +84,7 @@
   },
   "devDependencies": {
     "@langchain/core": "^0.3.59",
-    "@langchain/langgraph": "0.4.2",
+    "@langchain/langgraph": "0.4.3",
     "@langchain/langgraph-checkpoint": "0.1.0",
     "@langchain/langgraph-sdk": "0.0.105",
     "@types/babel__code-frame": "^7.0.6",