@langchain/langgraph-api 0.0.38 → 0.0.40

package/dist/api/assistants.mjs

@@ -1,12 +1,12 @@
-import { Hono } from "hono";
 import { zValidator } from "@hono/zod-validator";
+import { Hono } from "hono";
 import { v4 as uuid } from "uuid";
 import { z } from "zod";
-import { getAssistantId, getGraph, getCachedStaticGraphSchema, } from "../graph/load.mjs";
+import { getAssistantId, getCachedStaticGraphSchema, getGraph, } from "../graph/load.mjs";
 import { getRuntimeGraphSchema } from "../graph/parser/index.mjs";
-import { Assistants } from "../storage/ops.mjs";
-import * as schemas from "../schemas.mjs";
 import { HTTPException } from "hono/http-exception";
+import * as schemas from "../schemas.mjs";
+import { Assistants } from "../storage/ops.mjs";
 const api = new Hono();
 const RunnableConfigSchema = z.object({
     tags: z.array(z.string()).optional(),
@@ -46,14 +46,19 @@ api.post("/assistants/search", zValidator("json", schemas.AssistantSearchRequest
     // Search Assistants
     const payload = c.req.valid("json");
     const result = [];
+    let total = 0;
     for await (const item of Assistants.search({
         graph_id: payload.graph_id,
         metadata: payload.metadata,
         limit: payload.limit ?? 10,
         offset: payload.offset ?? 0,
     }, c.var.auth)) {
-        result.push(item);
+        result.push(item.assistant);
+        if (total === 0) {
+            total = item.total;
+        }
     }
+    c.res.headers.set("X-Pagination-Total", total.toString());
     return c.json(result);
 });
 api.get("/assistants/:assistant_id", async (c) => {

package/dist/api/meta.mjs

@@ -1,5 +1,45 @@
 import { Hono } from "hono";
+import * as fs from "node:fs/promises";
+import * as url from "node:url";
 const api = new Hono();
-api.get("/info", (c) => c.json({ flags: { assistants: true, crons: false } }));
+// 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) => {
+    const langsmithApiKey = env["LANGSMITH_API_KEY"] || env["LANGCHAIN_API_KEY"];
+    const langsmithTracing = (() => {
+        if (langsmithApiKey) {
+            // Check if any tracing variable is explicitly set to "false"
+            const tracingVars = [
+                env["LANGCHAIN_TRACING_V2"],
+                env["LANGCHAIN_TRACING"],
+                env["LANGSMITH_TRACING_V2"],
+                env["LANGSMITH_TRACING"],
+            ];
+            // Return true unless explicitly disabled
+            return !tracingVars.some((val) => val === "false" || val === "False");
+        }
+        return undefined;
+    })();
+    return c.json({
+        version,
+        context: "js",
+        flags: {
+            assistants: true,
+            crons: false,
+            langsmith: !!langsmithTracing,
+            langsmith_tracing_replicas: true,
+        },
+    });
+});
 api.get("/ok", (c) => c.json({ ok: true }));
 export default api;

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/auth/index.mjs

@@ -1,6 +1,6 @@
 import { HTTPException } from "hono/http-exception";
 import * as url from "node:url";
-import * as path from "path";
+import * as path from "node:path";
 let CUSTOM_AUTH;
 let DISABLE_STUDIO_AUTH = false;
 export const isAuthRegistered = () => CUSTOM_AUTH != null;

package/dist/http/middleware.mjs

@@ -3,7 +3,7 @@ export const cors = (cors) => {
     if (cors == null) {
         return honoCors({
             origin: "*",
-            exposeHeaders: ["content-location"],
+            exposeHeaders: ["content-location", "x-pagination-total"],
         });
     }
     const originRegex = cors.allow_origin_regex
@@ -17,10 +17,16 @@ export const cors = (cors) => {
             return undefined;
         }
         : (cors.allow_origins ?? []);
-    if (!!cors.expose_headers?.length &&
-        cors.expose_headers.some((i) => i.toLocaleLowerCase() === "content-location")) {
-        console.warn("Adding missing `Content-Location` header in `cors.expose_headers`.");
-        cors.expose_headers.push("content-location");
+    if (cors.expose_headers?.length) {
+        const headersSet = new Set(cors.expose_headers.map((h) => h.toLowerCase()));
+        if (!headersSet.has("content-location")) {
+            console.warn("Adding missing `Content-Location` header in `cors.expose_headers`.");
+            cors.expose_headers.push("content-location");
+        }
+        if (!headersSet.has("x-pagination-total")) {
+            console.warn("Adding missing `X-Pagination-Total` header in `cors.expose_headers`.");
+            cors.expose_headers.push("x-pagination-total");
+        }
     }
     // TODO: handle `cors.allow_credentials`
     return honoCors({

package/dist/logging.mjs

@@ -2,7 +2,7 @@ import { createLogger, format, transports } from "winston";
 import { logger as honoLogger } from "hono/logger";
 import { consoleFormat } from "winston-console-format";
 import { parse as stacktraceParser } from "stacktrace-parser";
-import { readFileSync } from "fs";
+import { readFileSync } from "node:fs";
 import { codeFrameColumns } from "@babel/code-frame";
 import path from "node:path";
 const LOG_JSON = process.env.LOG_JSON === "true";

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

@@ -119,7 +119,10 @@ export declare class Assistants {
         metadata?: Metadata;
         limit: number;
         offset: number;
-    }, auth: AuthContext | undefined): AsyncGenerator<any, void, any>;
+    }, auth: AuthContext | undefined): AsyncGenerator<{
+        assistant: Assistant;
+        total: number;
+    }>;
     static get(assistant_id: string, auth: AuthContext | undefined): Promise<Assistant>;
     static put(assistant_id: string, options: {
         config: RunnableConfig;

package/dist/storage/ops.mjs

@@ -177,8 +177,16 @@ export class Assistants {
                 const bCreatedAt = b["created_at"]?.getTime() ?? 0;
                 return bCreatedAt - aCreatedAt;
             });
+            // Calculate total count before pagination
+            const total = filtered.length;
             for (const assistant of filtered.slice(options.offset, options.offset + options.limit)) {
-                yield { ...assistant, name: assistant.name ?? assistant.graph_id };
+                yield {
+                    assistant: {
+                        ...assistant,
+                        name: assistant.name ?? assistant.graph_id,
+                    },
+                    total,
+                };
             }
         });
     }

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.38",
+  "version": "0.0.40",
   "type": "module",
   "engines": {
     "node": "^18.19.0 || >=20.16.0"
@@ -33,17 +33,30 @@
     "type": "git",
     "url": "git@github.com:langchain-ai/langgraphjs-api.git"
   },
+  "scripts": {
+    "clean": "npx -y bun scripts/clean.mjs",
+    "build": "npx -y bun scripts/build.mjs",
+    "dev": "tsx ./tests/utils.server.mts --dev",
+    "prepack": "yarn run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "test:parser": "vitest run ./tests/parser.test.mts --testTimeout 15000",
+    "test:api": "npx -y bun scripts/test.mjs",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
   "dependencies": {
     "@babel/code-frame": "^7.26.2",
     "@hono/node-server": "^1.12.0",
     "@hono/zod-validator": "^0.2.2",
+    "@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",
@@ -52,11 +65,10 @@
     "uuid": "^10.0.0",
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
-    "zod": "^3.23.8",
-    "@langchain/langgraph-ui": "0.0.38"
+    "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",
@@ -68,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",
@@ -83,16 +95,5 @@
     "prettier": "^3.3.3",
     "typescript": "^5.5.4",
     "vitest": "^3.0.5"
-  },
-  "scripts": {
-    "clean": "npx -y bun scripts/clean.mjs",
-    "build": "npx -y bun scripts/build.mjs",
-    "dev": "tsx ./tests/utils.server.mts --dev",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest",
-    "test:parser": "vitest run ./tests/parser.test.mts --testTimeout 15000",
-    "test:api": "npx -y bun scripts/test.mjs",
-    "format": "prettier --write .",
-    "format:check": "prettier --check ."
   }
 }