@langchain/langgraph-cli 0.0.0-preview.7 → 0.0.0-preview.9

package/README.md

@@ -12,36 +12,36 @@ npx @langchain/langgraph-cli
 
 ## Commands
 
-### `langgraph dev`
+### `langgraphjs dev`
 
 Run LangGraph.js API server in development mode with hot reloading.
 
 ```bash
-langgraph dev
+npx @langchain/langgraph-cli dev
 ```
 
-### `langgraph build`
+### `langgraphjs build`
 
 Build a Docker image for your LangGraph.js application.
 
 ```bash
-langgraph build
+npx @langchain/langgraph-cli build
 ```
 
-### `langgraph up`
+### `langgraphjs up`
 
 Run LangGraph.js API server in Docker.
 
 ```bash
-langgraph up
+npx @langchain/langgraph-cli up
 ```
 
-### `langgraph dockerfile`
+### `langgraphjs dockerfile`
 
 Generate a Dockerfile for custom deployments
 
 ```bash
-langgraph dockerfile <save path>
+npx @langchain/langgraph-cli dockerfile <save path>
 ```
 
 ## Configuration

package/dist/api/runs.mjs

@@ -8,7 +8,7 @@ import { z } from "zod";
 import { Runs, Threads } from "../storage/ops.mjs";
 import { serialiseAsDict } from "../utils/serde.mjs";
 import { getDisconnectAbortSignal, jsonExtra, waitKeepAlive, } from "../utils/hono.mjs";
-import { logger } from "../logging.mjs";
+import { logError, logger } from "../logging.mjs";
 import { v4 as uuid4 } from "uuid";
 const api = new Hono();
 const createValidRun = async (threadId, payload) => {
@@ -115,7 +115,7 @@ api.post("/runs/stream", zValidator("json", schemas.RunCreate), async (c) => {
             }
         }
         catch (error) {
-            logger.error("Error streaming run", { error });
+            logError(error, { prefix: "Error streaming run" });
         }
     });
 });
@@ -179,7 +179,7 @@ api.post("/threads/:thread_id/runs/stream", zValidator("param", z.object({ threa
             }
         }
         catch (error) {
-            logger.error("Error streaming run", { error });
+            logError(error, { prefix: "Error streaming run" });
         }
     });
 });

package/dist/cli/dev.mjs

@@ -8,7 +8,7 @@ import { createIpcServer } from "./utils/ipc/server.mjs";
 import { getProjectPath } from "./utils/project.mjs";
 import { getConfig } from "../utils/config.mjs";
 import { builder } from "./utils/builder.mjs";
-import { logger } from "../logging.mjs";
+import { logError, logger } from "../logging.mjs";
 import { withAnalytics } from "./utils/analytics.mjs";
 builder
     .command("dev")
@@ -108,6 +108,6 @@ builder
         });
     }
     catch (error) {
-        logger.error(error);
+        logError(error, { prefix: "Failed to launch server" });
     }
 });

package/dist/cli/utils/builder.mjs

@@ -1,7 +1,7 @@
 import { Command } from "@commander-js/extra-typings";
 import { version } from "./version.mjs";
 export const builder = new Command()
-    .name("langgraph")
+    .name("langgraphjs")
     .description("LangGraph.js CLI")
     .version(version)
     .enablePositionalOptions();

package/dist/logging.mjs

@@ -1,6 +1,10 @@
 import { createLogger, format, transports } from "winston";
 import { logger as honoLogger } from "hono/logger";
 import { consoleFormat } from "winston-console-format";
+import { parse as stacktraceParser } from "stacktrace-parser";
+import { readFileSync } from "fs";
+import { codeFrameColumns } from "@babel/code-frame";
+import path from "node:path";
 const LOG_JSON = process.env.LOG_JSON === "true";
 const LOG_LEVEL = process.env.LOG_LEVEL || "debug";
 export const logger = createLogger({
@@ -38,13 +42,54 @@ export const logger = createLogger({
                 return JSON.stringify({ timestamp, level, event, ...rest });
             }),
         ])),
-    transports: [
-        new transports.Console({
-            handleExceptions: true,
-            handleRejections: true,
-        }),
-    ],
+    transports: [new transports.Console()],
 });
+const formatStack = (stack) => {
+    if (!stack)
+        return stack;
+    const [firstFile] = stacktraceParser(stack).filter((item) => !item.file?.split(path.sep).includes("node_modules") &&
+        !item.file?.startsWith("node:"));
+    if (firstFile?.file && firstFile?.lineNumber) {
+        const filePath = firstFile.file;
+        const line = firstFile.lineNumber;
+        const column = firstFile.column ?? 0;
+        const messageLines = stack.split("\n");
+        const spliceIndex = messageLines.findIndex((i) => i.includes(filePath));
+        const padding = " ".repeat(Math.max(0, messageLines[spliceIndex].indexOf("at")));
+        const highlightCode = process.stdout.isTTY;
+        let codeFrame = codeFrameColumns(readFileSync(filePath, "utf-8"), { start: { line, column } }, { highlightCode });
+        codeFrame = codeFrame
+            .split("\n")
+            .map((i) => padding + i + "\x1b[0m")
+            .join("\n");
+        if (highlightCode) {
+            codeFrame = "\x1b[36m" + codeFrame + "\x1b[31m";
+        }
+        // insert codeframe after the line but dont lose the stack
+        return [
+            ...messageLines.slice(0, spliceIndex + 1),
+            codeFrame,
+            ...messageLines.slice(spliceIndex + 1),
+        ].join("\n");
+    }
+    return stack;
+};
+export const logError = (error, options) => {
+    let message;
+    let context = options?.context;
+    if (error instanceof Error) {
+        message = formatStack(error.stack) || error.message;
+    }
+    else {
+        message = String(error);
+        context = { ...context, error };
+    }
+    if (options?.prefix != null)
+        message = `${options.prefix}:\n${message}`;
+    logger.error(message, ...(context != null ? [context] : []));
+};
+process.on("uncaughtException", (error) => logError(error));
+process.on("unhandledRejection", (error) => logError(error));
 export const requestLogger = () => honoLogger((message, ...rest) => {
     logger.info(message, ...rest);
 });

package/dist/queue.mjs

@@ -1,6 +1,6 @@
 import { Runs, Threads } from "./storage/ops.mjs";
 import { streamState, } from "./stream.mjs";
-import { logger } from "./logging.mjs";
+import { logError, logger } from "./logging.mjs";
 import { serializeError } from "./utils/serde.mjs";
 const MAX_RETRY_ATTEMPTS = 3;
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
@@ -69,14 +69,16 @@ const worker = async (run, attempt, abortSignal) => {
         const endedAt = new Date();
         if (error instanceof Error)
             exception = error;
-        logger.info("Background run failed", {
-            exc_info: error,
-            run_id: run.run_id,
-            run_attempt: attempt,
-            run_created_at: run.created_at,
-            run_started_at: startedAt,
-            run_ended_at: endedAt,
-            run_exec_ms: endedAt.valueOf() - startedAt.valueOf(),
+        logError(error, {
+            prefix: "Background run failed",
+            context: {
+                run_id: run.run_id,
+                run_attempt: attempt,
+                run_created_at: run.created_at,
+                run_started_at: startedAt,
+                run_ended_at: endedAt,
+                run_exec_ms: endedAt.valueOf() - startedAt.valueOf(),
+            },
         });
         await Runs.setStatus(run.run_id, "error");
     }

package/dist/storage/checkpoint.mjs

@@ -119,5 +119,9 @@ class InMemorySaver extends MemorySaver {
             }
         });
     }
+    toJSON() {
+        // Prevent serialization of internal state
+        return "[InMemorySaver]";
+    }
 }
 export const checkpointer = new InMemorySaver();

package/dist/storage/store.mjs

@@ -33,5 +33,9 @@ class InMemoryStore extends BaseMemoryStore {
     async listNamespaces(...args) {
         return await conn.with(() => super.listNamespaces(...args));
     }
+    toJSON() {
+        // Prevent serialization of internal state
+        return "[InMemoryStore]";
+    }
 }
 export const store = new InMemoryStore();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-cli",
-  "version": "0.0.0-preview.7",
+  "version": "0.0.0-preview.9",
   "type": "module",
   "engines": {
     "node": ">=18"
@@ -8,7 +8,7 @@
   "license": "Elastic-2.0",
   "main": "./dist/server.mjs",
   "bin": {
-    "langgraph": "dist/cli/cli.mjs"
+    "langgraphjs": "dist/cli/cli.mjs"
   },
   "files": [
     "dist/"
@@ -39,6 +39,7 @@
     "hono": "^4.5.4",
     "langsmith": "^0.2.15",
     "open": "^10.1.0",
+    "stacktrace-parser": "^0.1.10",
     "superjson": "^2.2.2",
     "tar": "^7.4.3",
     "tsx": "^4.19.2",
@@ -55,7 +56,9 @@
     "typescript": "^5.5.4"
   },
   "devDependencies": {
+    "@babel/code-frame": "^7.26.2",
     "@langchain/langgraph-sdk": "^0.0.33",
+    "@types/babel__code-frame": "^7.0.6",
     "@types/node": "^22.2.0",
     "@types/uuid": "^10.0.0",
     "postgres": "^3.4.5",