feat: langgraph canonical package (#1742)

Author: hntrl

.changeset/chatty-shirts-leave.md

@@ -0,0 +1,5 @@
+---
+"langgraph": major
+---
+
+release package

.github/workflows/ci.yml

@@ -118,3 +118,8 @@ jobs:
           diff -C 3 README.md libs/langgraph/README.md
           exit 1
           fi
+          if ! diff -q README.md libs/langgraph-core/README.md >/dev/null; then
+          echo "README.md is out of sync with langgraph-core/README.md"
+          diff -C 3 README.md libs/langgraph-core/README.md
+          exit 1
+          fi

internal/environment_tests/docker-compose.yml

@@ -10,6 +10,7 @@ services:
       - ../../internal/environment_tests/test-exports-esbuild:/package
       - ../../internal/environment_tests/scripts:/scripts
       - ../../libs/langgraph:/langgraph
+      - ../../libs/langgraph-core:/langgraph-core
       - ../../libs/checkpoint:/checkpoint
     command: bash /scripts/docker-ci-entrypoint.sh
   test-exports-esm:
@@ -25,6 +26,7 @@ services:
       - ../../internal/environment_tests/test-exports-esm:/package
       - ../../internal/environment_tests/scripts:/scripts
       - ../../libs/langgraph:/langgraph
+      - ../../libs/langgraph-core:/langgraph-core
       - ../../libs/checkpoint:/checkpoint
     command: bash /scripts/docker-ci-entrypoint.sh
   test-exports-tsc:
@@ -37,6 +39,7 @@ services:
       - ../../internal/environment_tests/test-exports-tsc:/package
       - ../../internal/environment_tests/scripts:/scripts
       - ../../libs/langgraph:/langgraph
+      - ../../libs/langgraph-core:/langgraph-core
       - ../../libs/checkpoint:/checkpoint
     command: bash /scripts/docker-ci-entrypoint.sh
   test-exports-cjs:
@@ -49,6 +52,7 @@ services:
       - ../../internal/environment_tests/test-exports-cjs:/package
       - ../../internal/environment_tests/scripts:/scripts
       - ../../libs/langgraph:/langgraph
+      - ../../libs/langgraph-core:/langgraph-core
       - ../../libs/checkpoint:/checkpoint
     command: bash /scripts/docker-ci-entrypoint.sh
   test-exports-cf:
@@ -61,6 +65,7 @@ services:
       - ../../internal/environment_tests/test-exports-cf:/package
       - ../../internal/environment_tests/scripts:/scripts
       - ../../libs/langgraph:/langgraph
+      - ../../libs/langgraph-core:/langgraph-core
       - ../../libs/checkpoint:/checkpoint
     command: bash /scripts/docker-ci-entrypoint.sh
   test-exports-vercel:
@@ -76,6 +81,7 @@ services:
       - ../../internal/environment_tests/test-exports-vercel:/package
       - ../../internal/environment_tests/scripts:/scripts
       - ../../libs/langgraph:/langgraph
+      - ../../libs/langgraph-core:/langgraph-core
       - ../../libs/checkpoint:/checkpoint
     command: bash /scripts/docker-ci-entrypoint.sh
   test-exports-vite:
@@ -88,6 +94,7 @@ services:
       - ../../internal/environment_tests/test-exports-vite:/package
       - ../../internal/environment_tests/scripts:/scripts
       - ../../libs/langgraph:/langgraph
+      - ../../libs/langgraph-core:/langgraph-core
       - ../../libs/checkpoint:/checkpoint
     command: bash /scripts/docker-ci-entrypoint.sh
   success:

internal/environment_tests/scripts/docker-ci-entrypoint.sh

@@ -14,9 +14,11 @@ cp -r ../package/!(node_modules|dist|dist-cjs|dist-esm|build|.next|.turbo) .
 cp ../package/.[!.]* . 2>/dev/null || true
 
 mkdir -p ./libs/langgraph/
+mkdir -p ./libs/langgraph-core/
 mkdir -p ./libs/checkpoint/
 
 cp -r ../langgraph ./libs/
+cp -r ../langgraph-core ./libs/
 cp -r ../checkpoint ./libs/
 
 # copy cache

libs/langgraph/.env.example renamed to libs/langgraph-core/.env.example

@@ -0,0 +1,74 @@
+module.exports = {
+  extends: [
+    "airbnb-base",
+    "eslint:recommended",
+    "prettier",
+    "plugin:@typescript-eslint/recommended",
+  ],
+  parserOptions: {
+    ecmaVersion: 12,
+    parser: "@typescript-eslint/parser",
+    project: "./tsconfig.json",
+    sourceType: "module",
+  },
+  plugins: ["@typescript-eslint", "no-instanceof"],
+  ignorePatterns: [
+    ".eslintrc.cjs",
+    "scripts",
+    "node_modules",
+    "dist",
+    "dist-cjs",
+    "*.js",
+    "*.cjs",
+    "*.d.ts",
+  ],
+  rules: {
+    "no-process-env": 2,
+    "no-instanceof/no-instanceof": 2,
+    "@typescript-eslint/explicit-module-boundary-types": 0,
+    "@typescript-eslint/no-empty-function": 0,
+    "@typescript-eslint/no-shadow": 0,
+    "@typescript-eslint/no-empty-interface": 0,
+    "@typescript-eslint/no-use-before-define": ["error", "nofunc"],
+    "@typescript-eslint/no-unused-vars": ["warn", { args: "none" }],
+    "@typescript-eslint/no-floating-promises": "error",
+    "@typescript-eslint/no-misused-promises": "error",
+    "arrow-body-style": 0,
+    camelcase: 0,
+    "class-methods-use-this": 0,
+    "import/extensions": [2, "ignorePackages"],
+    "import/no-extraneous-dependencies": [
+      "error",
+      { devDependencies: ["**/*.test.ts", "**/*.test-d.ts"] },
+    ],
+    "import/no-unresolved": 0,
+    "import/prefer-default-export": 0,
+    "keyword-spacing": "error",
+    "max-classes-per-file": 0,
+    "max-len": 0,
+    "no-await-in-loop": 0,
+    "no-bitwise": 0,
+    "no-console": 0,
+    "no-empty-function": 0,
+    "no-restricted-syntax": 0,
+    "no-shadow": 0,
+    "no-continue": 0,
+    "no-void": 0,
+    "no-underscore-dangle": 0,
+    "no-use-before-define": 0,
+    "no-useless-constructor": 0,
+    "no-return-await": 0,
+    "consistent-return": 0,
+    "no-else-return": 0,
+    "func-names": 0,
+    "no-lonely-if": 0,
+    "prefer-rest-params": 0,
+    "new-cap": ["error", { properties: false, capIsNew: false }],
+  },
+  overrides: [
+    {
+      files: ["src/tests/**/*.ts"],
+      rules: { "no-instanceof/no-instanceof": 0 },
+    },
+  ],
+};

libs/langgraph-core/.eslintrc.cjs

@@ -0,0 +1,31 @@
+index.cjs
+index.js
+index.d.ts
+index.d.cts
+web.cjs
+web.js
+web.d.ts
+web.d.cts
+pregel.cjs
+pregel.js
+pregel.d.ts
+pregel.d.cts
+prebuilt.cjs
+prebuilt.js
+prebuilt.d.ts
+prebuilt.d.cts
+remote.cjs
+remote.js
+remote.d.ts
+remote.d.cts
+zod.cjs
+zod.js
+zod.d.ts
+zod.d.cts
+zod/schema.cjs
+zod/schema.js
+zod/schema.d.ts
+zod/schema.d.cts
+node_modules
+dist
+.yarn

libs/langgraph-core/.gitignore

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json.schemastore.org/prettierrc",
+  "printWidth": 80,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true,
+  "singleQuote": false,
+  "quoteProps": "as-needed",
+  "jsxSingleQuote": false,
+  "trailingComma": "es5",
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "requirePragma": false,
+  "insertPragma": false,
+  "proseWrap": "preserve",
+  "htmlWhitespaceSensitivity": "css",
+  "vueIndentScriptAndStyle": false,
+  "endOfLine": "lf"
+}