@langgraph-js/pure-graph 1.4.7 → 1.5.0

package/README.md

@@ -54,26 +54,39 @@ To integrate Pure Graph into a Next.js project, follow these steps:
 
     ```js
     // app/api/langgraph/[...path]/route.ts
-    import { ensureInitialized } from '@langgraph-js/pure-graph/dist/adapter/nextjs/index.js';
-    import { registerGraph } from '@langgraph-js/pure-graph';
-    import { graph } from '../../../agent/graph-name/graph';
-    const init = async () => {
-        registerGraph('test', graph);
+    import { NextRequest } from 'next/server';
+    import { ensureInitialized } from '@langgraph-js/pure-graph/dist/adapter/nextjs/index';
+    export const dynamic = 'force-dynamic';
+    export const revalidate = 0;
+
+    const registerGraph = async () => {
+        // You must separate graph registration and the router file to avoid Next.js loading the graph multiple times.
+        // 必须分开写注册图和 router 文件，以避免 nextjs 多次加载的问题
+        await import('@/agent/index');
     };
-    export async function GET(request) {
-        const { GET } = await ensureInitialized(init);
-        return GET(request);
-    }
 
-    export async function POST(request) {
-        const { POST } = await ensureInitialized(init);
-        return POST(request);
-    }
+    export const GET = async (req: NextRequest, context: any) => {
+        const { GET } = await ensureInitialized(registerGraph);
+        return GET(req);
+    };
 
-    export async function DELETE(request) {
-        const { DELETE } = await ensureInitialized(init);
-        return DELETE(request);
-    }
+    export const POST = async (req: NextRequest, context: any) => {
+        const { POST } = await ensureInitialized(registerGraph);
+        return POST(req);
+    };
+
+    export const DELETE = async (req: NextRequest, context: any) => {
+        const { DELETE } = await ensureInitialized(registerGraph);
+        return DELETE(req);
+    };
+    ```
+
+    ```ts
+    // @/agent/index.ts
+    import { registerGraph } from '@langgraph-js/pure-graph';
+    import graph from 'you-langgraph-graph';
+    registerGraph('test', graph);
+    export {};
     ```
 
 2. **Configure Environment Variables**
@@ -99,17 +112,71 @@ To integrate Pure Graph into a Hono.js project, follow these steps:
     import { registerGraph } from '@langgraph-js/pure-graph';
     import { graph } from './agent/graph-name/graph';
     import { Hono } from 'hono';
-    import LangGraphApp from '@langgraph-js/pure-graph/dist/adapter/hono/index';
+    import LangGraphApp, { type LangGraphServerContext } from '@langgraph-js/pure-graph/dist/adapter/hono/index';
 
     registerGraph('test', graph);
 
-    const app = new Hono();
+    const app = new Hono<{ Variables: LangGraphServerContext }>();
+
     app.route('/', LangGraphApp);
 
     export default app;
     ```
 
-2. **Configure Environment Variables**
+2. **Using LangGraph Entrypoint (Recommended)**
+
+    For more advanced use cases, you can use LangGraph's `entrypoint` function to create reusable workflows:
+
+    ```ts
+    // agent/entrypoint-graph.ts
+    import { Annotation, entrypoint, getConfig } from '@langchain/langgraph';
+    import { createReactAgent, createReactAgentAnnotation } from '@langchain/langgraph/prebuilt';
+    import { createState } from '@langgraph-js/pro';
+    import { createEntrypointGraph } from '@langgraph-js/pure-graph';
+    import { ChatOpenAI } from '@langchain/openai';
+
+    const State = createState(createReactAgentAnnotation()).build({});
+
+    const workflow = entrypoint('my-entrypoint', async (state: typeof State.State) => {
+        // Access context set by middleware
+        const config = getConfig();
+        console.log('User ID from context:', config.configurable?.userId);
+
+        const agent = createReactAgent({
+            llm: new ChatOpenAI({
+                model: 'your-model',
+            }),
+            prompt: 'You are a helpful assistant',
+            tools: [], // Add your tools here
+        });
+
+        return agent.invoke(state);
+    });
+
+    export const graph = createEntrypointGraph({
+        stateSchema: State,
+        graph: workflow,
+    });
+    ```
+
+    ```ts
+    // app.ts
+    import { registerGraph } from '@langgraph-js/pure-graph';
+    import { graph as entrypointGraph } from './agent/entrypoint-graph';
+    import { Hono } from 'hono';
+    import LangGraphApp, { type LangGraphServerContext } from '@langgraph-js/pure-graph/dist/adapter/hono/index';
+
+    // Register your entrypoint graph
+    registerGraph('my-entrypoint', entrypointGraph);
+
+    const app = new Hono<{ Variables: LangGraphServerContext }>();
+
+    app.route('/', LangGraphApp);
+
+    export default app;
+    ```
+
+3. **Configure Environment Variables**
 
     Add the necessary environment variables to your `.env` file.
 
@@ -119,6 +186,151 @@ To integrate Pure Graph into a Hono.js project, follow these steps:
     REDIS_URL="" # Required if using Redis
     ```
 
+## Context Passing
+
+Pure Graph supports passing custom context data to your graphs, which can be accessed via `getConfig().configurable` in your graph logic. This allows you to inject user-specific data, session information, or any other custom data into your LangGraph workflows.
+
+### Graph Code Example
+
+Here's how to access context in your graph logic:
+
+```ts
+// agent/context-aware-graph.ts
+import { Annotation, entrypoint, getConfig } from '@langchain/langgraph';
+import { createReactAgent, createReactAgentAnnotation } from '@langchain/langgraph/prebuilt';
+import { createState } from '@langgraph-js/pro';
+import { createEntrypointGraph } from '@langgraph-js/pure-graph';
+import { ChatOpenAI } from '@langchain/openai';
+
+const State = createState(createReactAgentAnnotation()).build({});
+
+const workflow = entrypoint('context-aware-graph', async (state: typeof State.State) => {
+    // Access context data passed from middleware
+    const config = getConfig();
+
+    // Context is available in config.configurable
+    const userId = config.configurable?.userId;
+    const sessionId = config.configurable?.sessionId;
+    const preferences = config.configurable?.preferences;
+
+    console.log('Context received:', {
+        userId,
+        sessionId,
+        preferences,
+    });
+
+    // Use context data in your graph logic
+    const systemMessage = `You are a helpful assistant for user ${userId || 'anonymous'}.
+    User preferences: ${JSON.stringify(preferences || {})}`;
+
+    const agent = createReactAgent({
+        llm: new ChatOpenAI({
+            model: 'your-model',
+        }),
+        prompt: systemMessage,
+        tools: [], // Add your tools here
+    });
+
+    return agent.invoke(state);
+});
+
+export const graph = createEntrypointGraph({
+    stateSchema: State,
+    graph: workflow,
+});
+```
+
+### Hono.js Implementation
+
+In Hono.js, you can inject context using middleware:
+
+```ts
+// app.ts
+import { registerGraph } from '@langgraph-js/pure-graph';
+import { graph as contextAwareGraph } from './agent/context-aware-graph';
+import { Hono } from 'hono';
+import LangGraphApp, { type LangGraphServerContext } from '@langgraph-js/pure-graph/dist/adapter/hono/index';
+
+// Register your context-aware graph
+registerGraph('context-aware', contextAwareGraph);
+
+const app = new Hono<{ Variables: LangGraphServerContext }>();
+
+// Middleware to inject custom context
+app.use('/api/langgraph/*', async (c, next) => {
+    // You can get context from authentication, request data, etc.
+    const userId = c.req.header('x-user-id') || 'anonymous';
+    const sessionId = c.req.header('x-session-id') || 'session-123';
+
+    c.set('langgraph_context', {
+        userId,
+        sessionId,
+        preferences: { theme: 'dark', language: 'zh' },
+        metadata: { source: 'hono-app', timestamp: new Date().toISOString() },
+        // Add any custom fields your graph needs
+    });
+
+    await next();
+});
+
+app.route('/api', LangGraphApp);
+
+export default app;
+```
+
+### Next.js Implementation
+
+In Next.js, you can inject context using middleware:
+
+```ts
+// middleware.ts
+import type { NextRequest } from 'next/server';
+import { NextResponse } from 'next/server';
+
+export function middleware(request: NextRequest) {
+    const requestHeaders = new Headers(request.headers);
+
+    // Add custom context to x-langgraph-context header
+    if (request.nextUrl.pathname.startsWith('/api/langgraph/')) {
+        // You can get context from cookies, headers, or other sources
+        const userId = request.cookies.get('user-id')?.value || 'anonymous';
+        const sessionId = request.cookies.get('session-id')?.value || 'session-123';
+
+        const langgraphContext = {
+            userId,
+            sessionId,
+            preferences: { theme: 'dark', language: 'zh' },
+            metadata: { source: 'nextjs-app', timestamp: new Date().toISOString() },
+            // Add any custom fields your graph needs
+        };
+
+        requestHeaders.set('x-langgraph-context', JSON.stringify(langgraphContext));
+    }
+
+    const response = NextResponse.next({
+        request: { headers: requestHeaders },
+    });
+
+    return response;
+}
+
+export const config = {
+    matcher: '/api/langgraph/:path*',
+};
+```
+
+```ts
+// app/api/langgraph/[...path]/route.ts
+import { GET, POST, DELETE } from '@langgraph-js/pure-graph/dist/adapter/nextjs/router';
+import { registerGraph } from '@langgraph-js/pure-graph';
+import { graph as contextAwareGraph } from '@/agent/context-aware-graph';
+
+// Register your context-aware graph
+registerGraph('context-aware', contextAwareGraph);
+
+export { GET, POST, DELETE };
+```
+
 ## Environment Configuration
 
 Here are the environment variables you need to configure:

package/dist/adapter/hono/index.d.ts

@@ -1,3 +1,8 @@
 import { Hono } from 'hono';
-declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export interface LangGraphServerContext {
+    langgraph_context: any;
+}
+declare const app: Hono<{
+    Variables: LangGraphServerContext;
+}, import("hono/types").BlankSchema, "/">;
 export default app;

package/dist/adapter/hono/index.js

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
 import { zValidator } from '@hono/zod-validator';
-import { c as createEndpoint, s as serialiseAsDict } from '../../createEndpoint-B0FQz0jr.js';
+import { c as createEndpoint, s as serialiseAsDict } from '../../createEndpoint-D56l-tDn.js';
 import { A as AssistantsSearchSchema, a as AssistantGraphQuerySchema, T as ThreadIdParamSchema, R as RunStreamPayloadSchema, b as RunListQuerySchema, c as RunIdParamSchema, d as RunCancelQuerySchema, e as ThreadStateUpdate, f as ThreadCreatePayloadSchema, g as ThreadSearchPayloadSchema } from '../../zod-BaCzVUl8.js';
 import { streamSSE } from 'hono/streaming';
 import z from 'zod';
@@ -33,6 +33,12 @@ api$1.post(
     const { thread_id } = c.req.valid("param");
     const payload = c.req.valid("json");
     return streamSSE(c, async (stream) => {
+      payload.config = payload.config || {};
+      payload.config.configurable = payload.config.configurable || {};
+      const langgraphContext = c.get("langgraph_context");
+      if (langgraphContext) {
+        Object.assign(payload.config.configurable, langgraphContext);
+      }
       for await (const { event, data } of client.runs.stream(thread_id, payload.assistant_id, payload)) {
         await stream.writeSSE({ data: serialiseAsDict(data) ?? "", event });
       }

package/dist/adapter/hono/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/adapter/hono/endpoint.ts","../../../src/adapter/hono/assistants.ts","../../../src/adapter/hono/runs.ts","../../../src/adapter/hono/threads.ts","../../../src/adapter/hono/index.ts"],"sourcesContent":["import { createEndpoint } from '../../createEndpoint.js';\n\nexport const client = createEndpoint();\n","import { zValidator } from '@hono/zod-validator';\nimport { Hono } from 'hono';\nimport { client } from './endpoint';\nimport { AssistantsSearchSchema, AssistantGraphQuerySchema } from '../zod';\nconst api = new Hono();\n\napi.post('/assistants/search', zValidator('json', AssistantsSearchSchema), async (c) => {\n    // Search Assistants\n    const payload = c.req.valid('json');\n    let total = 0;\n    const data = await client.assistants.search(payload);\n    c.res.headers.set('X-Pagination-Total', total.toString());\n    return c.json(data);\n});\n\napi.get('/assistants/:assistant_id/graph', zValidator('query', AssistantGraphQuerySchema), async (c) => {\n    const xray = c.req.valid('query').xray;\n    const data = await client.assistants.getGraph(c.req.param('assistant_id'), {\n        xray: xray !== undefined ? xray === 'true' : undefined,\n    });\n    return c.json(data);\n});\n\nexport default api;\n","import { zValidator } from '@hono/zod-validator';\nimport { Hono } from 'hono';\n\nimport { streamSSE } from 'hono/streaming';\nimport { client } from './endpoint';\nimport {\n    ThreadIdParamSchema,\n    RunIdParamSchema,\n    RunStreamPayloadSchema,\n    RunListQuerySchema,\n    RunCancelQuerySchema,\n    ThreadStateUpdate,\n} from '../zod';\nimport { serialiseAsDict } from '../../graph/stream';\nimport { RunnableConfig } from '@langchain/core/runnables';\nimport z from 'zod';\n\nconst api = new Hono();\n\n// 最常用的对话接口\napi.post(\n    '/threads/:thread_id/runs/stream',\n    zValidator('param', ThreadIdParamSchema),\n    zValidator('json', RunStreamPayloadSchema),\n    async (c) => {\n        // Stream Run\n        const { thread_id } = c.req.valid('param');\n        const payload = c.req.valid('json');\n\n        // c.header('Content-Location', `/threads/${thread_id}/runs/${run.run_id}`);\n        return streamSSE(c, async (stream) => {\n            /** @ts-ignore zod v3 的问题，与 ts 类型不一致 */\n            for await (const { event, data } of client.runs.stream(thread_id, payload.assistant_id, payload)) {\n                await stream.writeSSE({ data: serialiseAsDict(data) ?? '', event });\n            }\n        });\n    },\n);\n\napi.get(\n    '/threads/:thread_id/runs',\n    zValidator('param', ThreadIdParamSchema),\n    zValidator('query', RunListQuerySchema),\n    async (c) => {\n        const { thread_id } = c.req.valid('param');\n        const { limit, offset, status } = c.req.valid('query');\n        const runs = await client.runs.list(thread_id, { limit, offset, status });\n        return c.json(runs);\n    },\n);\n\napi.post(\n    '/threads/:thread_id/runs/:run_id/cancel',\n    zValidator('param', RunIdParamSchema),\n    zValidator('query', RunCancelQuerySchema),\n    async (c) => {\n        // Cancel Run Http\n        const { thread_id, run_id } = c.req.valid('param');\n        const { wait, action } = c.req.valid('query');\n        const cancel = client.runs.cancel(thread_id, run_id, wait, action);\n        if (wait) {\n            await cancel;\n        }\n        return c.body(null, wait ? 204 : 202);\n    },\n);\n\napi.post(\n    '/threads/:thread_id/state',\n    zValidator('param', z.object({ thread_id: z.string().uuid() })),\n    zValidator('json', ThreadStateUpdate),\n    async (c) => {\n        // Update Thread State\n        const { thread_id } = c.req.valid('param');\n        const payload = c.req.valid('json');\n        // const config: RunnableConfig = { configurable: { thread_id } };\n\n        // if (payload.checkpoint_id) {\n        //     config.configurable ??= {};\n        //     config.configurable.checkpoint_id = payload.checkpoint_id;\n        // }\n        // if (payload.checkpoint) {\n        //     config.configurable ??= {};\n        //     Object.assign(config.configurable, payload.checkpoint);\n        // }\n\n        const inserted = await client.threads.updateState(thread_id, payload);\n\n        return c.json(inserted);\n    },\n);\nexport default api;\n","import { zValidator } from '@hono/zod-validator';\nimport { Hono } from 'hono';\nimport { client } from './endpoint';\nimport { ThreadIdParamSchema, ThreadCreatePayloadSchema, ThreadSearchPayloadSchema } from '../zod';\n\nconst api = new Hono();\n\n// Threads Routes\napi.post('/threads', zValidator('json', ThreadCreatePayloadSchema), async (c) => {\n    const payload = c.req.valid('json');\n    const thread = await client.threads.create(payload);\n\n    return c.json(thread);\n});\n\napi.post('/threads/search', zValidator('json', ThreadSearchPayloadSchema), async (c) => {\n    // Search Threads\n    const payload = c.req.valid('json');\n    const result = await client.threads.search(payload as any);\n    c.res.headers.set('X-Pagination-Total', result.length.toString());\n    return c.json(result);\n});\n\napi.get('/threads/:thread_id', zValidator('param', ThreadIdParamSchema), async (c) => {\n    // Get Thread\n    const { thread_id } = c.req.valid('param');\n    return c.json(await client.threads.get(thread_id));\n});\n\napi.delete('/threads/:thread_id', zValidator('param', ThreadIdParamSchema), async (c) => {\n    // Delete Thread\n    const { thread_id } = c.req.valid('param');\n    await client.threads.delete(thread_id);\n    return new Response(null, { status: 204 });\n});\n\nexport default api;\n","import { Hono } from 'hono';\nimport Assistants from './assistants';\nimport Runs from './runs';\nimport Threads from './threads';\nimport { cors } from 'hono/cors';\nconst app = new Hono();\n\napp.use(cors());\n\napp.route('/', Assistants);\napp.route('/', Runs);\napp.route('/', Threads);\n\nexport default app;\n"],"names":["api","Assistants","Runs","Threads"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/adapter/hono/endpoint.ts","../../../src/adapter/hono/assistants.ts","../../../src/adapter/hono/runs.ts","../../../src/adapter/hono/threads.ts","../../../src/adapter/hono/index.ts"],"sourcesContent":["import { createEndpoint } from '../../createEndpoint.js';\n\nexport const client = createEndpoint();\n","import { zValidator } from '@hono/zod-validator';\nimport { Hono } from 'hono';\nimport { client } from './endpoint';\nimport { AssistantsSearchSchema, AssistantGraphQuerySchema } from '../zod';\nconst api = new Hono();\n\napi.post('/assistants/search', zValidator('json', AssistantsSearchSchema), async (c) => {\n    // Search Assistants\n    const payload = c.req.valid('json');\n    let total = 0;\n    const data = await client.assistants.search(payload);\n    c.res.headers.set('X-Pagination-Total', total.toString());\n    return c.json(data);\n});\n\napi.get('/assistants/:assistant_id/graph', zValidator('query', AssistantGraphQuerySchema), async (c) => {\n    const xray = c.req.valid('query').xray;\n    const data = await client.assistants.getGraph(c.req.param('assistant_id'), {\n        xray: xray !== undefined ? xray === 'true' : undefined,\n    });\n    return c.json(data);\n});\n\nexport default api;\n","import { zValidator } from '@hono/zod-validator';\nimport { Hono } from 'hono';\n\nimport { streamSSE } from 'hono/streaming';\nimport { client } from './endpoint';\nimport {\n    ThreadIdParamSchema,\n    RunIdParamSchema,\n    RunStreamPayloadSchema,\n    RunListQuerySchema,\n    RunCancelQuerySchema,\n    ThreadStateUpdate,\n} from '../zod';\nimport { serialiseAsDict } from '../../graph/stream';\nimport z from 'zod';\nimport type { LangGraphServerContext } from './index';\n\nconst api = new Hono<{ Variables: LangGraphServerContext }>();\n\n// 最常用的对话接口\napi.post(\n    '/threads/:thread_id/runs/stream',\n    zValidator('param', ThreadIdParamSchema),\n    zValidator('json', RunStreamPayloadSchema),\n    async (c) => {\n        // Stream Run\n        const { thread_id } = c.req.valid('param');\n        const payload = c.req.valid('json');\n\n        // c.header('Content-Location', `/threads/${thread_id}/runs/${run.run_id}`);\n        return streamSSE(c, async (stream) => {\n            payload.config = payload.config || {};\n            payload.config.configurable = payload.config.configurable || {};\n            const langgraphContext = c.get('langgraph_context');\n            if (langgraphContext) {\n                Object.assign(payload.config.configurable, langgraphContext);\n            }\n            /** @ts-ignore zod v3 的问题，与 ts 类型不一致 */\n            for await (const { event, data } of client.runs.stream(thread_id, payload.assistant_id, payload)) {\n                await stream.writeSSE({ data: serialiseAsDict(data) ?? '', event });\n            }\n        });\n    },\n);\n\napi.get(\n    '/threads/:thread_id/runs',\n    zValidator('param', ThreadIdParamSchema),\n    zValidator('query', RunListQuerySchema),\n    async (c) => {\n        const { thread_id } = c.req.valid('param');\n        const { limit, offset, status } = c.req.valid('query');\n        const runs = await client.runs.list(thread_id, { limit, offset, status });\n        return c.json(runs);\n    },\n);\n\napi.post(\n    '/threads/:thread_id/runs/:run_id/cancel',\n    zValidator('param', RunIdParamSchema),\n    zValidator('query', RunCancelQuerySchema),\n    async (c) => {\n        // Cancel Run Http\n        const { thread_id, run_id } = c.req.valid('param');\n        const { wait, action } = c.req.valid('query');\n        const cancel = client.runs.cancel(thread_id, run_id, wait, action);\n        if (wait) {\n            await cancel;\n        }\n        return c.body(null, wait ? 204 : 202);\n    },\n);\n\napi.post(\n    '/threads/:thread_id/state',\n    zValidator('param', z.object({ thread_id: z.string().uuid() })),\n    zValidator('json', ThreadStateUpdate),\n    async (c) => {\n        // Update Thread State\n        const { thread_id } = c.req.valid('param');\n        const payload = c.req.valid('json');\n        // const config: RunnableConfig = { configurable: { thread_id } };\n\n        // if (payload.checkpoint_id) {\n        //     config.configurable ??= {};\n        //     config.configurable.checkpoint_id = payload.checkpoint_id;\n        // }\n        // if (payload.checkpoint) {\n        //     config.configurable ??= {};\n        //     Object.assign(config.configurable, payload.checkpoint);\n        // }\n\n        const inserted = await client.threads.updateState(thread_id, payload);\n\n        return c.json(inserted);\n    },\n);\nexport default api;\n","import { zValidator } from '@hono/zod-validator';\nimport { Hono } from 'hono';\nimport { client } from './endpoint';\nimport { ThreadIdParamSchema, ThreadCreatePayloadSchema, ThreadSearchPayloadSchema } from '../zod';\n\nconst api = new Hono();\n\n// Threads Routes\napi.post('/threads', zValidator('json', ThreadCreatePayloadSchema), async (c) => {\n    const payload = c.req.valid('json');\n    const thread = await client.threads.create(payload);\n\n    return c.json(thread);\n});\n\napi.post('/threads/search', zValidator('json', ThreadSearchPayloadSchema), async (c) => {\n    // Search Threads\n    const payload = c.req.valid('json');\n    const result = await client.threads.search(payload as any);\n    c.res.headers.set('X-Pagination-Total', result.length.toString());\n    return c.json(result);\n});\n\napi.get('/threads/:thread_id', zValidator('param', ThreadIdParamSchema), async (c) => {\n    // Get Thread\n    const { thread_id } = c.req.valid('param');\n    return c.json(await client.threads.get(thread_id));\n});\n\napi.delete('/threads/:thread_id', zValidator('param', ThreadIdParamSchema), async (c) => {\n    // Delete Thread\n    const { thread_id } = c.req.valid('param');\n    await client.threads.delete(thread_id);\n    return new Response(null, { status: 204 });\n});\n\nexport default api;\n","import { Hono } from 'hono';\nimport Assistants from './assistants';\nimport Runs from './runs';\nimport Threads from './threads';\nimport { cors } from 'hono/cors';\n\nexport interface LangGraphServerContext {\n    langgraph_context: any;\n}\nconst app = new Hono<{ Variables: LangGraphServerContext }>();\n\napp.use(cors());\n\napp.route('/', Assistants);\napp.route('/', Runs);\napp.route('/', Threads);\n\nexport default app;\n"],"names":["api","Assistants","Runs","Threads"],"mappings":"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"}

package/dist/adapter/hono/runs.d.ts

@@ -1,3 +1,6 @@
 import { Hono } from 'hono';
-declare const api: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+import type { LangGraphServerContext } from './index';
+declare const api: Hono<{
+    Variables: LangGraphServerContext;
+}, import("hono/types").BlankSchema, "/">;
 export default api;

package/dist/adapter/nextjs/index.js

@@ -2,7 +2,7 @@ async function ensureInitialized(attachGraphPromise) {
   if (globalThis.LG_INIT_PROMISE === void 0) {
     globalThis.LG_INIT_PROMISE = (async () => {
       await attachGraphPromise();
-      const { GET, POST, DELETE } = await import('../../router-DqflDUWZ.js');
+      const { GET, POST, DELETE } = await import('../../router-BbUgLFyh.js');
       return {
         GET,
         POST,

package/dist/{createEndpoint-B0FQz0jr.js → createEndpoint-D56l-tDn.js}

@@ -1274,7 +1274,7 @@ const createMessageQueue = async () => {
   let q;
   if (process.env.REDIS_URL) {
     console.debug("LG | Using redis as stream queue");
-    const { RedisStreamQueue } = await import('./queue-Cao_-0hm.js');
+    const { RedisStreamQueue } = await import('./queue-BnmSDnCz.js');
     q = RedisStreamQueue;
   } else {
     q = MemoryStreamQueue;
@@ -1519,14 +1519,14 @@ const createEndpoint = () => {
         return LangGraphGlobal.globalMessageQueue.cancelQueue(runId);
       },
       async *stream(threadId, assistantId, payload) {
-        if (!payload.config) {
-          payload.config = {
-            configurable: {
-              graph_id: assistantId,
-              thread_id: threadId
-            }
-          };
-        }
+        payload.config = {
+          ...payload.config ?? {},
+          configurable: {
+            ...payload.config?.configurable ?? {},
+            graph_id: assistantId,
+            thread_id: threadId
+          }
+        };
         for await (const data of streamState(
           threads,
           threads.createRun(threadId, assistantId, payload),
@@ -1547,4 +1547,4 @@ const createEndpoint = () => {
 };
 
 export { AssistantEndpoint as A, BaseStreamQueue as B, CancelEventMessage as C, LangGraphGlobal as L, createEndpoint as c, registerGraph as r, serialiseAsDict as s };
-//# sourceMappingURL=createEndpoint-B0FQz0jr.js.map
+//# sourceMappingURL=createEndpoint-D56l-tDn.js.map