@langchain/langgraph-api 0.0.51 → 0.0.52

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @langchain/langgraph-api
 
+## 0.0.52
+
+### Patch Changes
+
+- 030698f: feat(api): add support for injecting `langgraph_node` in structured logs, expose structlog
+  - @langchain/langgraph-ui@0.0.52
+
 ## 0.0.51
 
 ### Patch Changes

package/dist/logging.d.mts

@@ -1,5 +1,8 @@
+import { type Logger } from "winston";
 import type { MiddlewareHandler } from "hono";
-export declare const logger: import("winston").Logger;
+export declare const logger: Logger;
+export declare function registerSdkLogger(): void;
+export declare function registerRuntimeLogFormatter(formatter: (info: Record<string, unknown>) => Record<string, unknown>): Promise<void>;
 export declare const logError: (error: unknown, options?: {
     context?: Record<string, unknown>;
     prefix?: string;

package/dist/logging.mjs

@@ -7,9 +7,15 @@ 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";
+let RUNTIME_LOG_FORMATTER;
+const applyRuntimeFormatter = format((info) => {
+    if (!RUNTIME_LOG_FORMATTER)
+        return info;
+    return RUNTIME_LOG_FORMATTER(info);
+});
 export const logger = createLogger({
     level: LOG_LEVEL,
-    format: format.combine(format.errors({ stack: true }), format.timestamp(), format.json(), ...(!LOG_JSON
+    format: format.combine(applyRuntimeFormatter(), format.errors({ stack: true }), format.timestamp(), format.json(), ...(!LOG_JSON
         ? [
             format.colorize({ all: true }),
             format.padLevels(),
@@ -44,6 +50,15 @@ export const logger = createLogger({
         ])),
     transports: [new transports.Console()],
 });
+// Expose the logger to be consumed by `getLogger`
+export function registerSdkLogger() {
+    const GLOBAL_LOGGER = Symbol.for("langgraph.api.sdk-logger");
+    const maybeGlobal = globalThis;
+    maybeGlobal[GLOBAL_LOGGER] = logger;
+}
+export async function registerRuntimeLogFormatter(formatter) {
+    RUNTIME_LOG_FORMATTER = formatter;
+}
 const formatStack = (stack) => {
     if (!stack)
         return stack;

package/dist/server.mjs

@@ -10,7 +10,7 @@ import { truncate, conn as opsConn } from "./storage/ops.mjs";
 import { zValidator } from "@hono/zod-validator";
 import { z } from "zod";
 import { queue } from "./queue.mjs";
-import { logger, requestLogger } from "./logging.mjs";
+import { logger, requestLogger, registerRuntimeLogFormatter, registerSdkLogger, } from "./logging.mjs";
 import { checkpointer } from "./storage/checkpoint.mjs";
 import { store as graphStore } from "./storage/store.mjs";
 import { auth } from "./auth/custom.mjs";
@@ -74,8 +74,23 @@ export async function startServer(options) {
         logger.info(`Flushing to persistent storage, exiting...`);
         await Promise.all(callbacks.map((c) => c.flush()));
     };
+    // Register global logger that can be consumed via SDK
+    // 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 });
+    // Make sure to register the runtime formatter after we've loaded the graphs
+    // to ensure that we're not loading `@langchain/langgraph` from different path.
+    const { getConfig } = await import("@langchain/langgraph");
+    registerRuntimeLogFormatter((info) => {
+        const config = getConfig();
+        if (config == null)
+            return info;
+        const node = config.metadata?.["langgraph_node"];
+        if (node != null)
+            info.langgraph_node = node;
+        return info;
+    });
     const app = new Hono();
     // Loopback fetch used by webhooks and custom routes
     bindLoopbackFetch(app);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "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.51",
+    "@langchain/langgraph-ui": "0.0.52",
     "@types/json-schema": "^7.0.15",
     "@typescript/vfs": "^1.6.0",
     "dedent": "^1.5.3",
@@ -86,7 +86,7 @@
     "@langchain/core": "^0.3.59",
     "@langchain/langgraph": "0.3.11",
     "@langchain/langgraph-checkpoint": "0.0.18",
-    "@langchain/langgraph-sdk": "0.0.101",
+    "@langchain/langgraph-sdk": "0.0.102",
     "@types/babel__code-frame": "^7.0.6",
     "@types/node": "^18.15.11",
     "@types/react": "^19.0.8",