@langchain/langgraph-cli 0.0.9 → 0.0.11

package/LICENSE

@@ -1,93 +1,21 @@
-Elastic License 2.0
-
-URL: https://www.elastic.co/licensing/elastic-license
-
-## Acceptance
-
-By using the software, you agree to all of the terms and conditions below.
-
-## Copyright License
-
-The licensor grants you a non-exclusive, royalty-free, worldwide,
-non-sublicensable, non-transferable license to use, copy, distribute, make
-available, and prepare derivative works of the software, in each case subject to
-the limitations and conditions below.
-
-## Limitations
-
-You may not provide the software to third parties as a hosted or managed
-service, where the service provides users with access to any substantial set of
-the features or functionality of the software.
-
-You may not move, change, disable, or circumvent the license key functionality
-in the software, and you may not remove or obscure any functionality in the
-software that is protected by the license key.
-
-You may not alter, remove, or obscure any licensing, copyright, or other notices
-of the licensor in the software. Any use of the licensor’s trademarks is subject
-to applicable law.
-
-## Patents
-
-The licensor grants you a license, under any patent claims the licensor can
-license, or becomes able to license, to make, have made, use, sell, offer for
-sale, import and have imported the software, in each case subject to the
-limitations and conditions in this license. This license does not cover any
-patent claims that you cause to be infringed by modifications or additions to
-the software. If you or your company make any written claim that the software
-infringes or contributes to infringement of any patent, your patent license for
-the software granted under these terms ends immediately. If your company makes
-such a claim, your patent license ends immediately for work on behalf of your
-company.
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of the software from you
-also gets a copy of these terms.
-
-If you modify the software, you must include in any modified copies of the
-software prominent notices stating that you have modified the software.
-
-## No Other Rights
-
-These terms do not imply any licenses other than those expressly granted in
-these terms.
-
-## Termination
-
-If you use the software in violation of these terms, such use is not licensed,
-and your licenses will automatically terminate. If the licensor provides you
-with a notice of your violation, and you cease all violation of this license no
-later than 30 days after you receive that notice, your licenses will be
-reinstated retroactively. However, if you violate these terms after such
-reinstatement, any additional violation of these terms will cause your licenses
-to terminate automatically and permanently.
-
-## No Liability
-
-*As far as the law allows, the software comes as is, without any warranty or
-condition, and the licensor will not be liable to you for any damages arising
-out of these terms or the use or nature of the software, under any kind of
-legal claim.*
-
-## Definitions
-
-The **licensor** is the entity offering these terms, and the **software** is the
-software the licensor makes available under these terms, including any portion
-of it.
-
-**you** refers to the individual or entity agreeing to these terms.
-
-**your company** is any legal entity, sole proprietorship, or other kind of
-organization that you work for, plus all organizations that have control over,
-are under the control of, or are under common control with that
-organization. **control** means ownership of substantially all the assets of an
-entity, or the power to direct its management and policies by vote, contract, or
-otherwise. Control can be direct or indirect.
-
-**your licenses** are all the licenses granted to you for the software under
-these terms.
-
-**use** means anything you do with the software requiring one of your licenses.
-
-**trademark** means trademarks, service marks, and similar rights.
+MIT License Copyright (c) 2025 LangChain
+
+Permission is hereby granted, free
+of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to the
+following conditions:
+
+The above copyright notice and this permission notice
+(including the next paragraph) shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -51,18 +51,18 @@ The CLI uses a `langgraph.json` configuration file with these key settings:
 ```json5
 {
   // Required: Graph definitions
-  "graphs": {
-    "graph": "./src/graph.ts:graph" 
+  graphs: {
+    graph: "./src/graph.ts:graph",
   },
 
   // Optional: Node version (20 only at the moment)
-  "node_version": "20",
+  node_version: "20",
 
   // Optional: Environment variables
-  "env": ".env",
-  
+  env: ".env",
+
   // Optional: Additional Dockerfile commands
-  "dockerfile_lines": []
+  dockerfile_lines: [],
 }
 ```
 

package/dist/cli/build.mjs

@@ -7,7 +7,7 @@ import { getProjectPath } from "./utils/project.mjs";
 import { $ } from "execa";
 import * as path from "node:path";
 import * as fs from "node:fs/promises";
-import { logger } from "../logging.mjs";
+import { logger } from "../utils/logging.mjs";
 import { withAnalytics } from "./utils/analytics.mjs";
 const stream = (proc) => {
     logger.info(`Running "${proc.spawnargs.join(" ")}"`);

package/dist/cli/dev.mjs

@@ -8,7 +8,7 @@ import { createIpcServer } from "./utils/ipc/server.mjs";
 import { getProjectPath } from "./utils/project.mjs";
 import { getConfig } from "../utils/config.mjs";
 import { builder } from "./utils/builder.mjs";
-import { logError, logger } from "../logging.mjs";
+import { logError, logger } from "../utils/logging.mjs";
 import { withAnalytics } from "./utils/analytics.mjs";
 builder
     .command("dev")
@@ -101,8 +101,8 @@ builder
                 child = await spawnPythonServer({ ...options, rest: args }, { configPath, config, env, hostUrl }, { pid, projectCwd });
             }
             else {
-                const { spawnNodeServer } = await import("./dev.node.mjs");
-                child = await spawnNodeServer({ ...options, rest: args }, { configPath, config, env, hostUrl }, { pid, projectCwd });
+                const { spawnServer } = await import("@langchain/langgraph-api");
+                child = await spawnServer(options, { config, env, hostUrl }, { pid, projectCwd });
             }
         };
         watcher.on("all", async (_name, path) => {

package/dist/cli/dev.python.mjs

@@ -6,7 +6,7 @@ import path from "node:path";
 import os from "node:os";
 import { extract as tarExtract } from "tar";
 import zipExtract from "extract-zip";
-import { logger } from "../logging.mjs";
+import { logger } from "../utils/logging.mjs";
 import { assembleLocalDeps } from "../docker/docker.mjs";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const UV_VERSION = "0.5.20";

package/dist/cli/docker.mjs

@@ -6,7 +6,7 @@ import { builder } from "./utils/builder.mjs";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import dedent from "dedent";
-import { logger } from "../logging.mjs";
+import { logger } from "../utils/logging.mjs";
 import { withAnalytics } from "./utils/analytics.mjs";
 const fileExists = async (path) => {
     try {

package/dist/cli/up.mjs

@@ -3,7 +3,7 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import { getConfig } from "../utils/config.mjs";
 import { getProjectPath } from "./utils/project.mjs";
-import { logger } from "../logging.mjs";
+import { logger } from "../utils/logging.mjs";
 import { createCompose, getDockerCapabilities } from "../docker/compose.mjs";
 import { configToCompose, getBaseImage } from "../docker/docker.mjs";
 import { getExecaOptions } from "../docker/shell.mjs";

package/dist/cli/utils/ipc/utils/temporary-directory.mjs

@@ -1,17 +1,17 @@
 // MIT License
-// 
+//
 // Copyright (c) Hiroki Osame <hiroki.osame@gmail.com>
-// 
+//
 // Permission is hereby granted, free of charge, to any person obtaining a copy
 // of this software and associated documentation files (the "Software"), to deal
 // in the Software without restriction, including without limitation the rights
 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 // copies of the Software, and to permit persons to whom the Software is
 // furnished to do so, subject to the following conditions:
-// 
+//
 // The above copyright notice and this permission notice shall be included in all
 // copies or substantial portions of the Software.
-// 
+//
 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -19,7 +19,7 @@
 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
-// 
+//
 // https://github.com/privatenumber/tsx/tree/28a3e7d2b8fd72b683aab8a98dd1fcee4624e4cb
 import path from "node:path";
 import os from "node:os";

package/dist/{logging.mjs → utils/logging.mjs}

@@ -1,5 +1,4 @@
 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";
@@ -95,6 +94,3 @@ export const logError = (error, options) => {
 };
 process.on("uncaughtException", (error) => logError(error));
 process.on("unhandledRejection", (error) => logError(error));
-export const requestLogger = () => honoLogger((message, ...rest) => {
-    logger.info(message, ...rest);
-});

package/package.json

@@ -1,34 +1,25 @@
 {
   "name": "@langchain/langgraph-cli",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "type": "module",
   "engines": {
     "node": ">=18"
   },
-  "license": "Elastic-2.0",
+  "license": "MIT",
   "main": "./dist/server.mjs",
+  "types": "./dist/server.d.mts",
   "bin": {
     "langgraphjs": "dist/cli/cli.mjs"
   },
   "files": [
     "dist/"
   ],
-  "scripts": {
-    "build": "node scripts/spawn.mjs build",
-    "prepack": "pnpm run build",
-    "typecheck": "tsc --noEmit",
-    "cli": "tsx src/cli/cli.mts",
-    "cli:watch": "tsx watch src/cli/cli.mts",
-    "test:cli": "pnpm run cli dev --no-browser --config ./tests/graphs/langgraph.json",
-    "test": "vitest",
-    "test:ci": "node scripts/spawn.mjs test"
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:langchain-ai/langgraphjs-api.git"
   },
   "dependencies": {
     "@commander-js/extra-typings": "^13.0.0",
-    "@hono/node-server": "^1.12.0",
-    "@hono/zod-validator": "^0.2.2",
-    "@types/json-schema": "^7.0.15",
-    "@typescript/vfs": "^1.6.0",
     "chokidar": "^4.0.3",
     "commander": "^13.0.0",
     "dedent": "^1.5.3",
@@ -36,33 +27,33 @@
     "execa": "^9.5.2",
     "exit-hook": "^4.0.0",
     "extract-zip": "^2.0.1",
-    "hono": "^4.5.4",
     "langsmith": "^0.2.15",
     "open": "^10.1.0",
     "stacktrace-parser": "^0.1.10",
-    "superjson": "^2.2.2",
     "tar": "^7.4.3",
-    "tsx": "^4.19.2",
-    "uuid": "^10.0.0",
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
     "yaml": "^2.7.0",
     "zod": "^3.23.8",
-    "@babel/code-frame": "^7.26.2"
-  },
-  "peerDependencies": {
-    "@langchain/core": "^0.3.36",
-    "@langchain/langgraph": "^0.2.43",
-    "@langchain/langgraph-checkpoint": "^0.0.14",
-    "typescript": "^5.5.4"
+    "@babel/code-frame": "^7.26.2",
+    "@langchain/langgraph-api": "0.0.11"
   },
   "devDependencies": {
-    "@langchain/langgraph-sdk": "^0.0.33",
+    "tsx": "^4.19.2",
     "@types/babel__code-frame": "^7.0.6",
     "@types/node": "^22.2.0",
-    "@types/uuid": "^10.0.0",
-    "postgres": "^3.4.5",
     "prettier": "^3.3.3",
-    "vitest": "^2.1.8"
+    "vitest": "^3.0.5",
+    "typescript": "^5.5.4"
+  },
+  "scripts": {
+    "clean": "npx -y bun scripts/clean.mjs",
+    "build": "npx -y bun scripts/build.mjs",
+    "typecheck": "tsc --noEmit",
+    "cli": "tsx src/cli/cli.mts",
+    "cli:watch": "tsx watch src/cli/cli.mts",
+    "test": "vitest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
   }
-}
+}

package/dist/api/assistants.mjs

@@ -1,144 +0,0 @@
-import { Hono } from "hono";
-import { zValidator } from "@hono/zod-validator";
-import { v4 as uuid } from "uuid";
-import { z } from "zod";
-import { getAssistantId, getGraph, getGraphSchema } from "../graph/load.mjs";
-import { Assistants } from "../storage/ops.mjs";
-import * as schemas from "../schemas.mjs";
-import { HTTPException } from "hono/http-exception";
-const api = new Hono();
-api.post("/assistants", zValidator("json", schemas.AssistantCreate), async (c) => {
-    // Create Assistant
-    const payload = c.req.valid("json");
-    const assistant = await Assistants.put(payload.assistant_id ?? uuid(), {
-        config: payload.config ?? {},
-        graph_id: payload.graph_id,
-        metadata: payload.metadata ?? {},
-        if_exists: payload.if_exists ?? "raise",
-        name: payload.name ?? "Untitled",
-    });
-    return c.json(assistant);
-});
-api.post("/assistants/search", zValidator("json", schemas.AssistantSearchRequest), async (c) => {
-    // Search Assistants
-    const payload = c.req.valid("json");
-    const result = [];
-    for await (const item of Assistants.search({
-        graph_id: payload.graph_id,
-        metadata: payload.metadata,
-        limit: payload.limit ?? 10,
-        offset: payload.offset ?? 0,
-    })) {
-        result.push(item);
-    }
-    return c.json(result);
-});
-api.get("/assistants/:assistant_id", async (c) => {
-    // Get Assistant
-    const assistantId = getAssistantId(c.req.param("assistant_id"));
-    return c.json(await Assistants.get(assistantId));
-});
-api.delete("/assistants/:assistant_id", async (c) => {
-    // Delete Assistant
-    const assistantId = getAssistantId(c.req.param("assistant_id"));
-    return c.json(await Assistants.delete(assistantId));
-});
-api.patch("/assistants/:assistant_id", zValidator("json", schemas.AssistantPatch), async (c) => {
-    // Patch Assistant
-    const assistantId = getAssistantId(c.req.param("assistant_id"));
-    const payload = c.req.valid("json");
-    return c.json(await Assistants.patch(assistantId, payload));
-});
-const RunnableConfigSchema = z.object({
-    tags: z.array(z.string()).optional(),
-    metadata: z.record(z.unknown()).optional(),
-    run_name: z.string().optional(),
-    max_concurrency: z.number().optional(),
-    recursion_limit: z.number().optional(),
-    configurable: z.record(z.unknown()).optional(),
-    run_id: z.string().uuid().optional(),
-});
-const getRunnableConfig = (userConfig) => {
-    if (!userConfig)
-        return {};
-    return {
-        configurable: userConfig.configurable,
-        tags: userConfig.tags,
-        metadata: userConfig.metadata,
-        runName: userConfig.run_name,
-        maxConcurrency: userConfig.max_concurrency,
-        recursionLimit: userConfig.recursion_limit,
-        runId: userConfig.run_id,
-    };
-};
-api.get("/assistants/:assistant_id/graph", zValidator("query", z.object({ xray: schemas.coercedBoolean.optional() })), async (c) => {
-    // Get Assistant Graph
-    const assistantId = getAssistantId(c.req.param("assistant_id"));
-    const assistant = await Assistants.get(assistantId);
-    const { xray } = c.req.valid("query");
-    const graph = getGraph(assistant.graph_id);
-    return c.json(graph.getGraph({ ...getRunnableConfig(assistant.config), xray }).toJSON());
-});
-api.get("/assistants/:assistant_id/schemas", async (c) => {
-    // Get Assistant Schemas
-    const assistantId = getAssistantId(c.req.param("assistant_id"));
-    const assistant = await Assistants.get(assistantId);
-    const graphSchema = await getGraphSchema(assistant.graph_id);
-    const rootGraphId = Object.keys(graphSchema).find((i) => !i.includes("|"));
-    if (!rootGraphId)
-        throw new Error("Failed to find root graph");
-    const rootGraphSchema = graphSchema[rootGraphId];
-    return c.json({
-        graph_id: assistant.graph_id,
-        input_schema: rootGraphSchema.input,
-        output_schema: rootGraphSchema.output,
-        state_schema: rootGraphSchema.state,
-        config_schema: rootGraphSchema.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) => {
-    // Get Assistant Subgraphs
-    const { assistant_id, namespace } = c.req.valid("param");
-    const { recurse } = c.req.valid("query");
-    const assistantId = getAssistantId(assistant_id);
-    const assistant = await Assistants.get(assistantId);
-    const graph = getGraph(assistant.graph_id);
-    const graphSchema = await getGraphSchema(assistant.graph_id);
-    const rootGraphId = Object.keys(graphSchema).find((i) => !i.includes("|"));
-    if (!rootGraphId) {
-        throw new HTTPException(404, { message: "Failed to find root graph" });
-    }
-    const result = [];
-    const subgraphsGenerator = "getSubgraphsAsync" in graph
-        ? graph.getSubgraphsAsync.bind(graph)
-        : // @ts-expect-error older versions of langgraph don't have getSubgraphsAsync
-            graph.getSubgraphs.bind(graph);
-    for await (const [ns] of subgraphsGenerator(namespace, recurse)) {
-        result.push([
-            ns,
-            graphSchema[`${rootGraphId}|${ns}`] || graphSchema[rootGraphId],
-        ]);
-    }
-    return c.json(Object.fromEntries(result));
-});
-api.post("/assistants/:assistant_id/latest", zValidator("json", schemas.AssistantLatestVersion), async (c) => {
-    // Set Latest Assistant Version
-    const assistantId = getAssistantId(c.req.param("assistant_id"));
-    const { version } = c.req.valid("json");
-    return c.json(await Assistants.setLatest(assistantId, version));
-});
-api.post("/assistants/:assistant_id/versions", zValidator("json", z.object({
-    limit: z.number().min(1).max(1000).optional().default(10),
-    offset: z.number().min(0).optional().default(0),
-    metadata: z.record(z.unknown()).optional(),
-})), async (c) => {
-    // Get Assistant Versions
-    const assistantId = getAssistantId(c.req.param("assistant_id"));
-    const { limit, offset, metadata } = c.req.valid("json");
-    return c.json(await Assistants.getVersions(assistantId, {
-        limit,
-        offset,
-        metadata,
-    }));
-});
-export default api;