@langchain/langgraph-api 0.0.39 → 0.0.40

package/dist/api/meta.mjs

@@ -1,5 +1,17 @@
 import { Hono } from "hono";
+import * as fs from "node:fs/promises";
+import * as url from "node:url";
 const api = new Hono();
+// Get the version using the same pattern as semver/index.mts
+const packageJsonPath = url.fileURLToPath(new URL("../../package.json", import.meta.url));
+let version;
+try {
+    const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf-8"));
+    version = packageJson.version;
+}
+catch {
+    console.warn("Could not determine version of langgraph-api");
+}
 // read env variable
 const env = process.env;
 api.get("/info", (c) => {
@@ -19,7 +31,14 @@ api.get("/info", (c) => {
         return undefined;
     })();
     return c.json({
-        flags: { assistants: true, crons: false, langsmith: !!langsmithTracing },
+        version,
+        context: "js",
+        flags: {
+            assistants: true,
+            crons: false,
+            langsmith: !!langsmithTracing,
+            langsmith_tracing_replicas: true,
+        },
     });
 });
 api.get("/ok", (c) => c.json({ ok: true }));

package/dist/api/runs.mjs

@@ -1,15 +1,15 @@
+import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
 import { HTTPException } from "hono/http-exception";
 import { streamSSE } from "hono/streaming";
+import { v4 as uuid4 } from "uuid";
+import { z } from "zod";
 import { getAssistantId } from "../graph/load.mjs";
-import { zValidator } from "@hono/zod-validator";
+import { logError, logger } from "../logging.mjs";
 import * as schemas from "../schemas.mjs";
-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 { logError, logger } from "../logging.mjs";
-import { v4 as uuid4 } from "uuid";
+import { serialiseAsDict } from "../utils/serde.mjs";
 const api = new Hono();
 const createValidRun = async (threadId, payload, kwargs) => {
     const { assistant_id: assistantId, ...run } = payload;
@@ -33,6 +33,13 @@ const createValidRun = async (threadId, payload, kwargs) => {
         config.configurable ??= {};
         Object.assign(config.configurable, run.checkpoint);
     }
+    if (run.langsmith_tracer) {
+        config.configurable ??= {};
+        Object.assign(config.configurable, {
+            langsmith_project: run.langsmith_tracer.project_name,
+            langsmith_example_id: run.langsmith_tracer.example_id,
+        });
+    }
     if (headers) {
         for (const [rawKey, value] of headers.entries()) {
             const key = rawKey.toLowerCase();

package/dist/schemas.d.mts

@@ -579,6 +579,16 @@ export declare const CommandSchema: z.ZodObject<{
     })[] | undefined;
     resume?: unknown;
 }>;
+export declare const LangsmithTracer: z.ZodObject<{
+    project_name: z.ZodOptional<z.ZodString>;
+    example_id: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project_name?: string | undefined;
+    example_id?: string | undefined;
+}, {
+    project_name?: string | undefined;
+    example_id?: string | undefined;
+}>;
 export declare const RunCreate: z.ZodObject<{
     assistant_id: z.ZodUnion<[z.ZodString, z.ZodString]>;
     checkpoint_id: z.ZodOptional<z.ZodString>;
@@ -692,6 +702,16 @@ export declare const RunCreate: z.ZodObject<{
     if_not_exists: z.ZodOptional<z.ZodEnum<["reject", "create"]>>;
     on_completion: z.ZodOptional<z.ZodEnum<["delete", "keep"]>>;
     feedback_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    langsmith_tracer: z.ZodOptional<z.ZodObject<{
+        project_name: z.ZodOptional<z.ZodString>;
+        example_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    }, {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     assistant_id: string;
     on_disconnect: "cancel" | "continue";
@@ -739,6 +759,10 @@ export declare const RunCreate: z.ZodObject<{
     stream_subgraphs?: boolean | undefined;
     stream_resumable?: boolean | undefined;
     on_completion?: "delete" | "keep" | undefined;
+    langsmith_tracer?: {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    } | undefined;
 }, {
     assistant_id: string;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
@@ -786,6 +810,10 @@ export declare const RunCreate: z.ZodObject<{
     stream_subgraphs?: boolean | undefined;
     stream_resumable?: boolean | undefined;
     on_completion?: "delete" | "keep" | undefined;
+    langsmith_tracer?: {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    } | undefined;
 }>;
 export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
     assistant_id: z.ZodUnion<[z.ZodString, z.ZodString]>;
@@ -900,6 +928,16 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
     if_not_exists: z.ZodOptional<z.ZodEnum<["reject", "create"]>>;
     on_completion: z.ZodOptional<z.ZodEnum<["delete", "keep"]>>;
     feedback_keys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    langsmith_tracer: z.ZodOptional<z.ZodObject<{
+        project_name: z.ZodOptional<z.ZodString>;
+        example_id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    }, {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     assistant_id: string;
     on_disconnect: "cancel" | "continue";
@@ -947,6 +985,10 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
     stream_subgraphs?: boolean | undefined;
     stream_resumable?: boolean | undefined;
     on_completion?: "delete" | "keep" | undefined;
+    langsmith_tracer?: {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    } | undefined;
 }, {
     assistant_id: string;
     metadata?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
@@ -994,6 +1036,10 @@ export declare const RunBatchCreate: z.ZodArray<z.ZodObject<{
     stream_subgraphs?: boolean | undefined;
     stream_resumable?: boolean | undefined;
     on_completion?: "delete" | "keep" | undefined;
+    langsmith_tracer?: {
+        project_name?: string | undefined;
+        example_id?: string | undefined;
+    } | undefined;
 }>, "many">;
 export declare const SearchResult: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodObject<{}, "strip", z.ZodAny, z.objectOutputType<{}, z.ZodAny, "strip">, z.objectInputType<{}, z.ZodAny, "strip">>>;

package/dist/schemas.mjs

@@ -159,6 +159,10 @@ export const CommandSchema = z.object({
         .optional(),
     resume: z.unknown().optional(),
 });
+export const LangsmithTracer = z.object({
+    project_name: z.string().optional(),
+    example_id: z.string().optional(),
+});
 export const RunCreate = z
     .object({
     assistant_id: z.union([z.string().uuid(), z.string()]),
@@ -210,6 +214,7 @@ export const RunCreate = z
     if_not_exists: z.enum(["reject", "create"]).optional(),
     on_completion: z.enum(["delete", "keep"]).optional(),
     feedback_keys: z.array(z.string()).optional(),
+    langsmith_tracer: LangsmithTracer.optional(),
 })
     .describe("Payload for creating a stateful run.");
 export const RunBatchCreate = z

package/dist/stream.d.mts

@@ -1,5 +1,5 @@
-import type { Run, RunnableConfig, Checkpoint } from "./storage/ops.mjs";
 import { type CheckpointMetadata, type Interrupt, type StateSnapshot } from "@langchain/langgraph";
+import type { Checkpoint, Run, RunnableConfig } from "./storage/ops.mjs";
 interface DebugTask {
     id: string;
     name: string;

package/dist/stream.mjs

@@ -1,9 +1,10 @@
-import { getGraph } from "./graph/load.mjs";
-import { Client as LangSmithClient } from "langsmith";
-import { runnableConfigToCheckpoint, taskRunnableConfigToCheckpoint, } from "./utils/runnableConfig.mjs";
 import { isBaseMessage } from "@langchain/core/messages";
+import { LangChainTracer } from "@langchain/core/tracers/tracer_langchain";
+import { Client as LangSmithClient, getDefaultProjectName } from "langsmith";
 import { getLangGraphCommand } from "./command.mjs";
+import { getGraph } from "./graph/load.mjs";
 import { checkLangGraphSemver } from "./semver/index.mjs";
+import { runnableConfigToCheckpoint, taskRunnableConfigToCheckpoint, } from "./utils/runnableConfig.mjs";
 const isRunnableConfig = (config) => {
     if (typeof config !== "object" || config == null)
         return false;
@@ -88,6 +89,19 @@ export async function* streamState(run, attempt = 1, options) {
         langgraph_host: "self-hosted",
         langgraph_api_url: process.env.LANGGRAPH_API_URL ?? undefined,
     };
+    const tracer = run.kwargs?.config?.configurable?.langsmith_project
+        ? new LangChainTracer({
+            replicas: [
+                [
+                    run.kwargs?.config?.configurable?.langsmith_project,
+                    {
+                        reference_example_id: run.kwargs?.config?.configurable?.langsmith_example_id,
+                    },
+                ],
+                [getDefaultProjectName(), undefined],
+            ],
+        })
+        : undefined;
     const events = graph.streamEvents(kwargs.command != null
         ? getLangGraphCommand(kwargs.command)
         : (kwargs.input ?? null), {
@@ -102,6 +116,7 @@ export async function* streamState(run, attempt = 1, options) {
         runId: run.run_id,
         streamMode: [...libStreamMode],
         signal: options?.signal,
+        ...(tracer && { callbacks: [tracer] }),
     });
     const messages = {};
     const completedIds = new Set();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph-api",
-  "version": "0.0.39",
+  "version": "0.0.40",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -49,14 +49,14 @@
     "@babel/code-frame": "^7.26.2",
     "@hono/node-server": "^1.12.0",
     "@hono/zod-validator": "^0.2.2",
-    "@langchain/langgraph-ui": "0.0.39",
+    "@langchain/langgraph-ui": "0.0.40",
     "@types/json-schema": "^7.0.15",
     "@typescript/vfs": "^1.6.0",
     "dedent": "^1.5.3",
     "dotenv": "^16.4.7",
     "exit-hook": "^4.0.0",
     "hono": "^4.5.4",
-    "langsmith": "^0.2.15",
+    "langsmith": "^0.3.33",
     "open": "^10.1.0",
     "semver": "^7.7.1",
     "stacktrace-parser": "^0.1.10",
@@ -68,7 +68,7 @@
     "zod": "^3.23.8"
   },
   "peerDependencies": {
-    "@langchain/core": "^0.3.42",
+    "@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",
@@ -80,7 +80,7 @@
     }
   },
   "devDependencies": {
-    "@langchain/core": "^0.3.42",
+    "@langchain/core": "^0.3.59",
     "@langchain/langgraph": "^0.2.57",
     "@langchain/langgraph-checkpoint": "~0.0.16",
     "@langchain/langgraph-sdk": "^0.0.77",