@langchain/langgraph-sdk 0.0.101 → 0.0.102

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @langchain/langgraph-sdk
 
+## 0.0.102
+
+### Patch Changes
+
+- 030698f: feat(api): add support for injecting `langgraph_node` in structured logs, expose structlog
+
 ## 0.0.101
 
 ### Patch Changes

package/dist/logging/index.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLogger = void 0;
+const GLOBAL_LOGGER = Symbol.for("langgraph.api.sdk-logger");
+/**
+ * Retrieves the global logger instance for LangGraph Platform.
+ *
+ * The logger provides structured logging capabilities with
+ * various log levels (error, warn, info, debug, etc.) and extra metadata such as node name etc.
+ *
+ * @returns {Logger} The global logger instance with leveled logging methods
+ *
+ * @throws {Error} When the logger is not available in the current environment
+ *
+ * @example
+ * ```typescript
+ * // Safe usage with fallback
+ * const logger = getLogger();
+ * logger.info("This will only work in LangGraph Platform environment");
+ * ```
+ *
+ * @remarks
+ * This method is designed to work specifically within the LangGraph Platform
+ * environment where a global logger is automatically registered. If you're
+ * developing locally or in an environment where LangGraph Platform is not
+ * available, this function will throw an error.
+ */
+const getLogger = () => {
+    const maybeGlobal = globalThis;
+    if (GLOBAL_LOGGER in maybeGlobal)
+        return maybeGlobal[GLOBAL_LOGGER];
+    throw new Error("Logger not available in current environment. " +
+        "This method requires LangGraph Platform environment where a global logger is automatically registered. " +
+        "If you're developing locally, consider using `console.log` or a local logging library instead.");
+};
+exports.getLogger = getLogger;

package/dist/logging/index.d.ts

@@ -0,0 +1,43 @@
+interface LeveledLogMethod {
+    (message: string, ...meta: any[]): Logger;
+    (message: any): Logger;
+    (infoObject: object): Logger;
+}
+interface Logger {
+    error: LeveledLogMethod;
+    warn: LeveledLogMethod;
+    help: LeveledLogMethod;
+    data: LeveledLogMethod;
+    info: LeveledLogMethod;
+    debug: LeveledLogMethod;
+    prompt: LeveledLogMethod;
+    http: LeveledLogMethod;
+    verbose: LeveledLogMethod;
+    input: LeveledLogMethod;
+    silly: LeveledLogMethod;
+}
+/**
+ * Retrieves the global logger instance for LangGraph Platform.
+ *
+ * The logger provides structured logging capabilities with
+ * various log levels (error, warn, info, debug, etc.) and extra metadata such as node name etc.
+ *
+ * @returns {Logger} The global logger instance with leveled logging methods
+ *
+ * @throws {Error} When the logger is not available in the current environment
+ *
+ * @example
+ * ```typescript
+ * // Safe usage with fallback
+ * const logger = getLogger();
+ * logger.info("This will only work in LangGraph Platform environment");
+ * ```
+ *
+ * @remarks
+ * This method is designed to work specifically within the LangGraph Platform
+ * environment where a global logger is automatically registered. If you're
+ * developing locally or in an environment where LangGraph Platform is not
+ * available, this function will throw an error.
+ */
+export declare const getLogger: () => Logger;
+export {};

package/dist/logging/index.js

@@ -0,0 +1,32 @@
+const GLOBAL_LOGGER = Symbol.for("langgraph.api.sdk-logger");
+/**
+ * Retrieves the global logger instance for LangGraph Platform.
+ *
+ * The logger provides structured logging capabilities with
+ * various log levels (error, warn, info, debug, etc.) and extra metadata such as node name etc.
+ *
+ * @returns {Logger} The global logger instance with leveled logging methods
+ *
+ * @throws {Error} When the logger is not available in the current environment
+ *
+ * @example
+ * ```typescript
+ * // Safe usage with fallback
+ * const logger = getLogger();
+ * logger.info("This will only work in LangGraph Platform environment");
+ * ```
+ *
+ * @remarks
+ * This method is designed to work specifically within the LangGraph Platform
+ * environment where a global logger is automatically registered. If you're
+ * developing locally or in an environment where LangGraph Platform is not
+ * available, this function will throw an error.
+ */
+export const getLogger = () => {
+    const maybeGlobal = globalThis;
+    if (GLOBAL_LOGGER in maybeGlobal)
+        return maybeGlobal[GLOBAL_LOGGER];
+    throw new Error("Logger not available in current environment. " +
+        "This method requires LangGraph Platform environment where a global logger is automatically registered. " +
+        "If you're developing locally, consider using `console.log` or a local logging library instead.");
+};

package/logging.cjs

@@ -0,0 +1 @@
+module.exports = require('./dist/logging/index.cjs');

package/logging.d.cts

@@ -0,0 +1 @@
+export * from './dist/logging/index.js'

package/logging.d.ts

@@ -0,0 +1 @@
+export * from './dist/logging/index.js'

package/logging.js

@@ -0,0 +1 @@
+export * from './dist/logging/index.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-sdk",
-  "version": "0.0.101",
+  "version": "0.0.102",
   "description": "Client library for interacting with the LangGraph API",
   "type": "module",
   "scripts": {
@@ -100,6 +100,15 @@
       "import": "./react.js",
       "require": "./react.cjs"
     },
+    "./logging": {
+      "types": {
+        "import": "./logging.d.ts",
+        "require": "./logging.d.cts",
+        "default": "./logging.d.ts"
+      },
+      "import": "./logging.js",
+      "require": "./logging.cjs"
+    },
     "./react-ui": {
       "types": {
         "import": "./react-ui.d.ts",
@@ -138,6 +147,10 @@
     "react.js",
     "react.d.ts",
     "react.d.cts",
+    "logging.cjs",
+    "logging.js",
+    "logging.d.ts",
+    "logging.d.cts",
     "react-ui.cjs",
     "react-ui.js",
     "react-ui.d.ts",