@langchain/langgraph-api 0.0.51 → 0.0.53

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @langchain/langgraph-api
 
+## 0.0.53
+
+### Patch Changes
+
+- f1bcec7: Add support for Context API in in-memory dev server
+  - @langchain/langgraph-ui@0.0.53
+
+## 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/api/assistants.mjs

@@ -35,6 +35,7 @@ api.post("/assistants", zValidator("json", schemas.AssistantCreate), async (c) =
     const payload = c.req.valid("json");
     const assistant = await Assistants.put(payload.assistant_id ?? uuid(), {
         config: payload.config ?? {},
+        context: payload.context ?? {},
         graph_id: payload.graph_id,
         metadata: payload.metadata ?? {},
         if_exists: payload.if_exists ?? "raise",
@@ -113,6 +114,9 @@ api.get("/assistants/:assistant_id/schemas", zValidator("json", z.object({ confi
         output_schema: schema.output,
         state_schema: schema.state,
         config_schema: schema.config,
+        // From JS PoV `configSchema` and `contextSchema` are indistinguishable,
+        // thus we use config_schema for context_schema.
+        context_schema: schema.config,
     });
 });
 api.get("/assistants/:assistant_id/subgraphs/:namespace?", zValidator("param", z.object({ assistant_id: z.string(), namespace: z.string().optional() })), zValidator("query", z.object({ recurse: schemas.coercedBoolean.optional() })), async (c) => {

package/dist/api/runs.mjs

@@ -75,6 +75,7 @@ const createValidRun = async (threadId, payload, kwargs) => {
         input: run.input,
         command: run.command,
         config,
+        context: run.context,
         stream_mode: streamMode,
         interrupt_before: run.interrupt_before,
         interrupt_after: run.interrupt_after,

package/dist/graph/load.mjs

@@ -25,7 +25,7 @@ export async function registerFromEnv(specs, options) {
         logger.info(`Registering graph with id '${graphId}'`, {
             graph_id: graphId,
         });
-        const config = envConfig?.[graphId];
+        const { context, ...config } = envConfig?.[graphId] ?? {};
         const { resolved, ...spec } = await resolveGraph(rawSpec, {
             cwd: options.cwd,
         });
@@ -35,7 +35,8 @@ export async function registerFromEnv(specs, options) {
         await Assistants.put(uuid.v5(graphId, NAMESPACE_GRAPH), {
             graph_id: graphId,
             metadata: { created_by: "system" },
-            config: config ?? {},
+            config,
+            context,
             if_exists: "do_nothing",
             name: graphId,
         }, undefined);

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/schemas.d.mts

@@ -175,11 +175,13 @@ export declare const AssistantCreate: z.ZodObject<{
             thread_ts: z.ZodOptional<z.ZodString>;
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip">>>;
+    context: z.ZodOptional<z.ZodUnknown>;
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodUnknown, z.objectOutputType<{}, z.ZodUnknown, "strip">, z.objectInputType<{}, z.ZodUnknown, "strip">>>;
     if_exists: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"raise">, z.ZodLiteral<"do_nothing">]>>;
     name: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     graph_id: string;
+    context?: unknown;
     metadata?: z.objectOutputType<{}, z.ZodUnknown, "strip"> | undefined;
     name?: string | undefined;
     config?: z.objectOutputType<{
@@ -200,6 +202,7 @@ export declare const AssistantCreate: z.ZodObject<{
     assistant_id?: string | undefined;
 }, {
     graph_id: string;
+    context?: unknown;
     metadata?: z.objectInputType<{}, z.ZodUnknown, "strip"> | undefined;
     name?: string | undefined;
     config?: z.objectInputType<{
@@ -261,9 +264,11 @@ export declare const AssistantPatch: z.ZodObject<{
             thread_ts: z.ZodOptional<z.ZodString>;
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip">>>;
+    context: z.ZodOptional<z.ZodUnknown>;
     name: z.ZodOptional<z.ZodString>;
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>>;
 }, "strip", z.ZodTypeAny, {
+    context?: unknown;
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     name?: string | undefined;
     config?: z.objectOutputType<{
@@ -282,6 +287,7 @@ export declare const AssistantPatch: z.ZodObject<{
     }, z.ZodUnknown, "strip"> | undefined;
     graph_id?: string | undefined;
 }, {
+    context?: unknown;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     name?: string | undefined;
     config?: z.objectInputType<{
@@ -401,6 +407,7 @@ export declare const CronCreate: z.ZodObject<{
             thread_ts: z.ZodOptional<z.ZodString>;
         }, z.ZodUnknown, "strip">>>;
     }, z.ZodUnknown, "strip">>>;
+    context: z.ZodOptional<z.ZodUnknown>;
     webhook: z.ZodOptional<z.ZodString>;
     interrupt_before: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["*"]>, z.ZodArray<z.ZodString, "many">]>>;
     interrupt_after: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["*"]>, z.ZodArray<z.ZodString, "many">]>>;
@@ -408,6 +415,7 @@ export declare const CronCreate: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     thread_id: string;
     assistant_id: string;
+    context?: unknown;
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     input?: z.objectOutputType<{}, z.ZodAny, "strip">[] | z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     config?: z.objectOutputType<{
@@ -432,6 +440,7 @@ export declare const CronCreate: z.ZodObject<{
 }, {
     thread_id: string;
     assistant_id: string;
+    context?: unknown;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     input?: z.objectInputType<{}, z.ZodAny, "strip">[] | z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     config?: z.objectInputType<{
@@ -650,6 +659,7 @@ export declare const RunCreate: z.ZodObject<{
         resume?: unknown;
     }>>;
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>>;
+    context: z.ZodOptional<z.ZodUnknown>;
     config: z.ZodOptional<z.ZodObject<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         recursion_limit: z.ZodOptional<z.ZodNumber>;
@@ -715,6 +725,7 @@ export declare const RunCreate: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     assistant_id: string;
     on_disconnect: "cancel" | "continue";
+    context?: unknown;
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     input?: unknown;
     config?: z.objectOutputType<{
@@ -765,6 +776,7 @@ export declare const RunCreate: z.ZodObject<{
     } | undefined;
 }, {
     assistant_id: string;
+    context?: unknown;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     input?: unknown;
     config?: z.objectInputType<{
@@ -876,6 +888,7 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
         resume?: unknown;
     }>>;
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>>;
+    context: z.ZodOptional<z.ZodUnknown>;
     config: z.ZodOptional<z.ZodObject<{
         tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         recursion_limit: z.ZodOptional<z.ZodNumber>;
@@ -941,6 +954,7 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     assistant_id: string;
     on_disconnect: "cancel" | "continue";
+    context?: unknown;
     metadata?: z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     input?: unknown;
     config?: z.objectOutputType<{
@@ -991,6 +1005,7 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
     } | undefined;
 }, {
     assistant_id: string;
+    context?: unknown;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     input?: unknown;
     config?: z.objectInputType<{

package/dist/schemas.mjs

@@ -30,6 +30,7 @@ export const AssistantCreate = z
         .optional(),
     graph_id: z.string().describe("The graph to use."),
     config: AssistantConfig.optional(),
+    context: z.unknown().optional(),
     metadata: z
         .object({})
         .catchall(z.unknown())
@@ -45,6 +46,7 @@ export const AssistantPatch = z
     .object({
     graph_id: z.string().describe("The graph to use.").optional(),
     config: AssistantConfig.optional(),
+    context: z.unknown().optional(),
     name: z.string().optional(),
     metadata: z
         .object({})
@@ -89,6 +91,7 @@ export const CronCreate = z
         .describe("Metadata for the run.")
         .optional(),
     config: AssistantConfig.optional(),
+    context: z.unknown().optional(),
     webhook: z.string().optional(),
     interrupt_before: z.union([z.enum(["*"]), z.array(z.string())]).optional(),
     interrupt_after: z.union([z.enum(["*"]), z.array(z.string())]).optional(),
@@ -175,6 +178,7 @@ export const RunCreate = z
         .catchall(z.any())
         .describe("Metadata for the run.")
         .optional(),
+    context: z.unknown().optional(),
     config: AssistantConfig.optional(),
     webhook: z.string().optional(),
     interrupt_before: z.union([z.enum(["*"]), z.array(z.string())]).optional(),

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/dist/storage/ops.d.mts

@@ -27,6 +27,7 @@ interface Assistant {
     updated_at: Date;
     version: number;
     config: RunnableConfig;
+    context: unknown;
     metadata: Metadata;
 }
 interface AssistantVersion {
@@ -34,6 +35,7 @@ interface AssistantVersion {
     version: number;
     graph_id: string;
     config: RunnableConfig;
+    context: unknown;
     metadata: Metadata;
     created_at: Date;
     name: string | undefined;
@@ -45,6 +47,7 @@ export interface RunKwargs {
     interrupt_before?: "*" | string[] | undefined;
     interrupt_after?: "*" | string[] | undefined;
     config?: RunnableConfig;
+    context?: unknown;
     subgraphs?: boolean;
     resumable?: boolean;
     temporary?: boolean;
@@ -126,6 +129,7 @@ export declare class Assistants {
     static get(assistant_id: string, auth: AuthContext | undefined): Promise<Assistant>;
     static put(assistant_id: string, options: {
         config: RunnableConfig;
+        context: unknown;
         graph_id: string;
         metadata?: Metadata;
         if_exists: OnConflictBehavior;
@@ -133,6 +137,7 @@ export declare class Assistants {
     }, auth: AuthContext | undefined): Promise<Assistant>;
     static patch(assistantId: string, options: {
         config?: RunnableConfig;
+        context?: unknown;
         graph_id?: string;
         metadata?: Metadata;
         name?: string;

package/dist/storage/ops.mjs

@@ -208,6 +208,7 @@ export class Assistants {
         const [filters, mutable] = await handleAuthEvent(auth, "assistants:create", {
             assistant_id,
             config: options.config,
+            context: options.context,
             graph_id: options.graph_id,
             metadata: options.metadata,
             if_exists: options.if_exists,
@@ -229,6 +230,7 @@ export class Assistants {
                 assistant_id: assistant_id,
                 version: 1,
                 config: options.config ?? {},
+                context: options.context ?? {},
                 created_at: now,
                 updated_at: now,
                 graph_id: options.graph_id,
@@ -240,6 +242,7 @@ export class Assistants {
                 version: 1,
                 graph_id: options.graph_id,
                 config: options.config ?? {},
+                context: options.context ?? {},
                 metadata: mutable.metadata ?? {},
                 created_at: now,
                 name: options.name || options.graph_id,
@@ -276,6 +279,9 @@ export class Assistants {
             if (options?.config != null) {
                 assistant["config"] = options?.config ?? assistant["config"];
             }
+            if (options?.context != null) {
+                assistant["context"] = options?.context ?? assistant["context"];
+            }
             if (options?.name != null) {
                 assistant["name"] = options?.name ?? assistant["name"];
             }
@@ -292,6 +298,7 @@ export class Assistants {
                 version: newVersion,
                 graph_id: options?.graph_id ?? assistant["graph_id"],
                 config: options?.config ?? assistant["config"],
+                context: options?.context ?? assistant["context"],
                 name: options?.name ?? assistant["name"],
                 metadata: metadata ?? assistant["metadata"],
                 created_at: now,
@@ -878,6 +885,9 @@ export class Runs {
                 status: status,
                 kwargs: Object.assign({}, kwargs, {
                     config: Object.assign({}, assistant.config, config, { configurable }, { metadata: mergedMetadata }),
+                    context: typeof assistant.context !== "object" && assistant.context != null
+                        ? assistant.context ?? kwargs.context
+                        : Object.assign({}, assistant.context, kwargs.context),
                 }),
                 multitask_strategy: multitaskStrategy,
                 created_at: new Date(now.valueOf() + afterSeconds * 1000),

package/dist/stream.mjs

@@ -108,6 +108,7 @@ export async function* streamState(run, options) {
         interruptAfter: kwargs.interrupt_after,
         interruptBefore: kwargs.interrupt_before,
         tags: kwargs.config?.tags,
+        context: kwargs.context,
         configurable: kwargs.config?.configurable,
         recursionLimit: kwargs.config?.recursion_limit,
         subgraphs: kwargs.subgraphs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "0.0.51",
+  "version": "0.0.53",
   "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.53",
     "@types/json-schema": "^7.0.15",
     "@typescript/vfs": "^1.6.0",
     "dedent": "^1.5.3",
@@ -72,9 +72,9 @@
   },
   "peerDependencies": {
     "@langchain/core": "^0.3.59",
-    "@langchain/langgraph": "^0.2.57 || ^0.3.0",
-    "@langchain/langgraph-checkpoint": "~0.0.16",
-    "@langchain/langgraph-sdk": "~0.0.70",
+    "@langchain/langgraph": "^0.2.57 || ^0.3.0 || ^0.4.0",
+    "@langchain/langgraph-checkpoint": "~0.0.16 || ^0.1.0",
+    "@langchain/langgraph-sdk": "~0.0.70 || ^0.1.0",
     "typescript": "^5.5.4"
   },
   "peerDependenciesMeta": {
@@ -84,9 +84,9 @@
   },
   "devDependencies": {
     "@langchain/core": "^0.3.59",
-    "@langchain/langgraph": "0.3.11",
-    "@langchain/langgraph-checkpoint": "0.0.18",
-    "@langchain/langgraph-sdk": "0.0.101",
+    "@langchain/langgraph": "0.4.0",
+    "@langchain/langgraph-checkpoint": "0.1.0",
+    "@langchain/langgraph-sdk": "0.0.103",
     "@types/babel__code-frame": "^7.0.6",
     "@types/node": "^18.15.11",
     "@types/react": "^19.0.8",