Jacob/mistral

.github/DISCUSSION_TEMPLATE/q-a.yml

@@ -21,8 +21,8 @@ body:
         Relevant links to check before opening a question to see if your question has already been answered, fixed or
         if there's another way to solve your problem:
 
-        [LangChain.js documentation with the integrated search](https://js.langchain.com/v0.2/docs/introduction),
-        [API Reference](https://v02.api.js.langchain.com/),
+        [LangChain.js documentation with the integrated search](https://js.langchain.com/docs/introduction),
+        [API Reference](https://api.js.langchain.com/),
         [GitHub search](https://github.com/langchain-ai/langchainjs),
         [LangChain.js Github Discussions](https://github.com/langchain-ai/langchainjs/discussions),
         [LangChain.js Github Issues](https://github.com/langchain-ai/langchainjs/issues?q=is%3Aissue),

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -15,8 +15,8 @@ body:
         Relevant links to check before filing a bug report to see if your issue has already been reported, fixed or
         if there's another way to solve your problem:
 
-        [LangChain.js documentation with the integrated search](https://js.langchain.com/v0.2/docs/introduction),
-        [API Reference](https://v02.api.js.langchain.com/),
+        [LangChain.js documentation with the integrated search](https://js.langchain.com/docs/introduction),
+        [API Reference](https://api.js.langchain.com/),
         [GitHub search](https://github.com/langchain-ai/langchainjs),
         [LangChain.js Github Discussions](https://github.com/langchain-ai/langchainjs/discussions),
         [LangChain.js Github Issues](https://github.com/langchain-ai/langchainjs/issues?q=is%3Aissue),

.github/ISSUE_TEMPLATE/documentation.yml

@@ -20,8 +20,8 @@ body:
       If you're in the wrong place, here are some helpful links to find a better
       place to ask your question:
 
-      [LangChain.js documentation with the integrated search](https://js.langchain.com/v0.2/docs/introduction),
-      [API Reference](https://v02.api.js.langchain.com/),
+      [LangChain.js documentation with the integrated search](https://js.langchain.com/docs/introduction),
+      [API Reference](https://api.js.langchain.com/),
       [GitHub search](https://github.com/langchain-ai/langchainjs),
       [LangChain.js Github Discussions](https://github.com/langchain-ai/langchainjs/discussions),
       [LangChain.js Github Issues](https://github.com/langchain-ai/langchainjs/issues?q=is%3Aissue),

.github/scripts/deployDomainVercel.sh

@@ -0,0 +1,30 @@
+#!/bin/bash
+
+# Check if an argument is provided
+if [ $# -eq 0 ]; then
+    echo "Error: Please provide a version string as an argument."
+    exit 1
+fi
+
+inputString=$1
+
+# Check if VERCEL_TOKEN is set
+if [ -z "$VERCEL_TOKEN" ]; then
+    echo "Error: VERCEL_TOKEN is not set."
+    exit 1
+fi
+
+# save stdout and stderr to files
+vercel deploy --prebuilt --token="$VERCEL_TOKEN" >deployment-url.txt 2>error.txt
+
+# check the exit code
+code=$?
+if [ $code -eq 0 ]; then
+    # Set the deploymentUrl using the input string
+    deploymentUrl="${inputString}.api.js.langchain.com"
+    vercel alias $(cat deployment-url.txt) $deploymentUrl --token="$VERCEL_TOKEN" --scope="langchain"
+else
+    # Handle the error
+    errorMessage=$(cat error.txt)
+    echo "There was an error: $errorMessage"
+fi

.github/workflows/compatibility.yml

@@ -6,10 +6,10 @@ on:
   pull_request:
     # Only run this workflow if the following directories have changed.
     paths:
-      - 'langchain/**'
-      - 'langchain-core/**'
-      - 'libs/**'
-  workflow_dispatch:  # Allows triggering the workflow manually in GitHub UI
+      - "langchain/**"
+      - "langchain-core/**"
+      - "libs/**"
+  workflow_dispatch: # Allows triggering the workflow manually in GitHub UI
 
 # If another push to the same PR or branch happens while this workflow is still running,
 # cancel the earlier run in favor of the next run.
@@ -24,7 +24,7 @@ concurrency:
 env:
   PUPPETEER_SKIP_DOWNLOAD: "true"
   PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD: "true"
-  NODE_VERSION: "18.x"
+  NODE_VERSION: "20.x"
   COHERE_API_KEY: ${{ secrets.COHERE_API_KEY }}
 
 # Run a separate job for each check in the docker-compose file,
@@ -75,42 +75,42 @@ jobs:
       - name: Test LangChain with lowest deps
         run: docker compose -f dependency_range_tests/docker-compose.yml run langchain-lowest-deps
 
-  # Community
-  community-latest-deps:
-    runs-on: ubuntu-latest
-    needs: get-changed-files
-    if: contains(needs.get-changed-files.outputs.changed_files, 'langchain-core/') || contains(needs.get-changed-files.outputs.changed_files, 'libs/langchain-openai/') || contains(needs.get-changed-files.outputs.changed_files, 'libs/langchain-community/')
-    steps:
-      - uses: actions/checkout@v4
-      - name: Use Node.js ${{ env.NODE_VERSION }}
-        uses: actions/setup-node@v3
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          cache: "yarn"
-      - name: Install dependencies
-        run: yarn install --immutable
-      - name: Build `@langchain/standard-tests`
-        run: yarn build --filter=@langchain/standard-tests
-      - name: Test `@langchain/community` with latest deps
-        run: docker compose -f dependency_range_tests/docker-compose.yml run community-latest-deps
+  # # Community
+  # community-latest-deps:
+  #   runs-on: ubuntu-latest
+  #   needs: get-changed-files
+  #   if: contains(needs.get-changed-files.outputs.changed_files, 'langchain-core/') || contains(needs.get-changed-files.outputs.changed_files, 'libs/langchain-openai/') || contains(needs.get-changed-files.outputs.changed_files, 'libs/langchain-community/')
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #     - name: Use Node.js ${{ env.NODE_VERSION }}
+  #       uses: actions/setup-node@v3
+  #       with:
+  #         node-version: ${{ env.NODE_VERSION }}
+  #         cache: "yarn"
+  #     - name: Install dependencies
+  #       run: yarn install --immutable
+  #     - name: Build `@langchain/standard-tests`
+  #       run: yarn build --filter=@langchain/standard-tests
+  #     - name: Test `@langchain/community` with latest deps
+  #       run: docker compose -f dependency_range_tests/docker-compose.yml run community-latest-deps
 
-  community-lowest-deps:
-    runs-on: ubuntu-latest
-    needs: get-changed-files
-    if: contains(needs.get-changed-files.outputs.changed_files, 'libs/langchain-community/')
-    steps:
-      - uses: actions/checkout@v4
-      - name: Use Node.js ${{ env.NODE_VERSION }}
-        uses: actions/setup-node@v3
-        with:
-          node-version: ${{ env.NODE_VERSION }}
-          cache: "yarn"
-      - name: Install dependencies
-        run: yarn install --immutable
-      - name: Build `@langchain/standard-tests`
-        run: yarn build --filter=@langchain/standard-tests
-      - name: Test `@langchain/community` with lowest deps
-        run: docker compose -f dependency_range_tests/docker-compose.yml run community-lowest-deps
+  # community-lowest-deps:
+  #   runs-on: ubuntu-latest
+  #   needs: get-changed-files
+  #   if: contains(needs.get-changed-files.outputs.changed_files, 'libs/langchain-community/')
+  #   steps:
+  #     - uses: actions/checkout@v4
+  #     - name: Use Node.js ${{ env.NODE_VERSION }}
+  #       uses: actions/setup-node@v3
+  #       with:
+  #         node-version: ${{ env.NODE_VERSION }}
+  #         cache: "yarn"
+  #     - name: Install dependencies
+  #       run: yarn install --immutable
+  #     - name: Build `@langchain/standard-tests`
+  #       run: yarn build --filter=@langchain/standard-tests
+  #     - name: Test `@langchain/community` with lowest deps
+  #       run: docker compose -f dependency_range_tests/docker-compose.yml run community-lowest-deps
 
   community-npm-install:
     runs-on: ubuntu-latest

.github/workflows/deploy-api-refs-preview.yml

@@ -2,7 +2,8 @@ name: Deploy API Refs Preview
 
 on:
   workflow_dispatch:  # Allows triggering the workflow manually in GitHub UI
-  pull_request:
+  # Avoid deploying on PR due to rate limits
+  # pull_request:
 
 # If another push to the same PR or branch happens while this workflow is still running,
 # cancel the earlier run in favor of the next run.

.github/workflows/deploy-api-refs-prod.yml

@@ -3,7 +3,7 @@ name: Deploy API Refs Prod
 on:
   workflow_dispatch:  # Allows triggering the workflow manually in GitHub UI
   push:
-    branches: ["main"]
+    branches: ["main", "v0.2"]
 
 # If another push to the same PR or branch happens while this workflow is still running,
 # cancel the earlier run in favor of the next run.
@@ -34,6 +34,21 @@ jobs:
       - name: Build All Projects
         run: yarn turbo:command build --filter=!examples --filter=!api_refs --filter=!core_docs --filter=!create-langchain-integration
       - name: Build Project Artifacts
-        run: vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}
-      - name: Deploy Project Artifacts to Vercel
-        run: vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}
+        run: |
+          if [ ${{ github.ref }} = 'refs/heads/main' ]; then
+            vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}
+          else
+            vercel build --token=${{ secrets.VERCEL_TOKEN }}
+          fi
+      - name: Deploy to Vercel
+        env:
+          VERCEL_TOKEN: ${{ secrets.VERCEL_TOKEN }}
+        run: |
+          if [ ${{ github.ref }} = 'refs/heads/main' ]; then
+            vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}
+          elif [ ${{ github.ref }} = 'refs/heads/v0.2' ]; then
+            .github/scripts/deployDomainVercel.sh v02
+          else
+            echo "Error: Deployment is only allowed for 'main' or 'v0.2' branches."
+            exit 1
+          fi

.github/workflows/standard-tests.yml

@@ -11,7 +11,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        package: [anthropic, cohere, google-genai, groq, mistralai, aws]
+        package: [anthropic, cohere, google-genai, groq, mistralai, aws, google-vertexai-web]
     steps:
       - uses: actions/checkout@v4
       - name: Use Node.js 18.x
@@ -24,16 +24,15 @@ jobs:
       - name: Run integration tests for ${{ matrix.package }}
         run: yarn turbo test:integration --filter=@langchain/${{ matrix.package }}
         env:
-          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
-          COHERE_API_KEY: ${{ secrets.COHERE_API_KEY }}
-          GOOGLE_API_KEY: ${{ secrets.GOOGLE_API_KEY }}
-          GROQ_API_KEY: ${{ secrets.GROQ_API_KEY }}
-          MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
-          DISABLE_CONSOLE_LOGS: "true"
-          # @langchain/aws credentials
-          BEDROCK_AWS_ACCESS_KEY_ID: ${{ secrets.BEDROCK_AWS_ACCESS_KEY_ID }}
-          BEDROCK_AWS_SECRET_ACCESS_KEY: ${{ secrets.BEDROCK_AWS_SECRET_ACCESS_KEY }}
-          BEDROCK_AWS_REGION: "us-east-1"
+          ANTHROPIC_API_KEY: ${{ matrix.package == 'anthropic' && secrets.ANTHROPIC_API_KEY || '' }}
+          COHERE_API_KEY: ${{ matrix.package == 'cohere' && secrets.COHERE_API_KEY || '' }}
+          GOOGLE_API_KEY: ${{ matrix.package == 'google-genai' && secrets.GOOGLE_API_KEY || '' }}
+          GROQ_API_KEY: ${{ matrix.package == 'groq' && secrets.GROQ_API_KEY || '' }}
+          MISTRAL_API_KEY: ${{ matrix.package == 'mistralai' && secrets.MISTRAL_API_KEY || '' }}
+          BEDROCK_AWS_ACCESS_KEY_ID: ${{ matrix.package == 'aws' && secrets.BEDROCK_AWS_ACCESS_KEY_ID || '' }}
+          BEDROCK_AWS_SECRET_ACCESS_KEY: ${{ matrix.package == 'aws' && secrets.BEDROCK_AWS_SECRET_ACCESS_KEY || '' }}
+          BEDROCK_AWS_REGION: ${{ matrix.package == 'aws' && 'us-east-1' || '' }}
+          GOOGLE_VERTEX_AI_WEB_CREDENTIALS: ${{ matrix.package == 'google-vertexai-web' && secrets.GOOGLE_VERTEX_AI_WEB_CREDENTIALS || '' }}
 
   # The `@langchain/openai` package contains standard tests for ChatOpenAI and AzureChatOpenAI
   # We want to run these separately, so we need to pass the exact path for each test, which means
@@ -55,7 +54,6 @@ jobs:
         run: yarn workspace @langchain/openai test:single src/tests/chat_models_structured_output.int.test.ts src/tests/chat_models-extended.int.test.ts src/tests/chat_models-vision.int.test.ts src/tests/chat_models.int.test.ts src/tests/chat_models.standard.int.test.ts
         env:
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
-          DISABLE_CONSOLE_LOGS: "true"
 
   standard-tests-azure-openai:
     runs-on: ubuntu-latest
@@ -77,7 +75,6 @@ jobs:
           AZURE_OPENAI_API_DEPLOYMENT_NAME: "chat"
           AZURE_OPENAI_API_VERSION: ${{ secrets.AZURE_OPENAI_API_VERSION }}
           AZURE_OPENAI_BASE_PATH: ${{ secrets.AZURE_OPENAI_BASE_PATH }}
-          DISABLE_CONSOLE_LOGS: "true"
 
   standard-tests-bedrock:
     runs-on: ubuntu-latest
@@ -98,4 +95,21 @@ jobs:
           BEDROCK_AWS_REGION: "us-east-1"
           BEDROCK_AWS_SECRET_ACCESS_KEY: ${{ secrets.BEDROCK_AWS_SECRET_ACCESS_KEY }}
           BEDROCK_AWS_ACCESS_KEY_ID: ${{ secrets.BEDROCK_AWS_ACCESS_KEY_ID }}
-          DISABLE_CONSOLE_LOGS: "true"
+
+  standard-tests-fireworks:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js 18.x
+        uses: actions/setup-node@v3
+        with:
+          node-version: 18.x
+          cache: "yarn"
+      - name: Install dependencies
+        run: yarn install --immutable --mode=skip-build
+      - name: Build `@langchain/community`
+        run: yarn build --filter=@langchain/community
+      - name: Run standard tests (integration) for `@langchain/community` ChatFireworks
+        run: yarn workspace @langchain/community test:single src/chat_models/tests/chatfireworks.standard.int.test.ts
+        env:
+          FIREWORKS_API_KEY: ${{ secrets.FIREWORKS_API_KEY }}

.github/workflows/validate_new_notebooks.yml

@@ -50,9 +50,21 @@ jobs:
         run: |
           notebooks=$(echo '${{ steps.changed-files.outputs.all_changed_files }}' | tr ' ' '\n' | grep '^docs/core_docs/.*\.ipynb$' || true)
           if [ -n "$notebooks" ]; then
+            failed_notebooks=()
             for notebook in $notebooks; do
-              yarn notebook:validate "$notebook"
+              absolute_path="$GITHUB_WORKSPACE/$notebook"
+              set +e
+              yarn workspace @langchain/scripts notebook_validate "$absolute_path"
+              if [ $? -ne 0 ]; then
+                failed_notebooks+=("$notebook")
+              fi
+              set -e
             done
+            if [ ${#failed_notebooks[@]} -ne 0 ]; then
+              echo "The following notebooks failed validation:"
+              printf '%s\n' "${failed_notebooks[@]}"
+              exit 1
+            fi
           else
             echo "No notebooks in docs/core_docs to validate."
-          fi
+          fi

.vercelignore

@@ -0,0 +1,4 @@
+node_modules/
+**/node_modules/
+.next/
+**/.next/

CONTRIBUTING.md

@@ -25,7 +25,7 @@ LangChain supports several different types of integrations with third-party prov
 
 We welcome such contributions, but ask that you read our dedicated [integration contribution guide](https://github.com/langchain-ai/langchainjs/blob/main/.github/contributing/INTEGRATIONS.md) for specific details and patterns to consider before opening a pull request.
 
-You can also check out the [guides on extending LangChain.js](https://js.langchain.com/v0.2/docs/how_to/#custom) in our docs.
+You can also check out the [guides on extending LangChain.js](https://js.langchain.com/docs/how_to/#custom) in our docs.
 
 #### Integration packages
 
@@ -105,9 +105,9 @@ You can invoke the script by calling `yarn release`. If new dependencies have be
 
 There are three parameters which can be passed to this script, one required and two optional.
 
-- __Required__: `<workspace name>`. eg: `@langchain/core` The name of the package to release. Can be found in the `name` value of the package's `package.json`
-- __Optional__: `--bump-deps` eg `--bump-deps` Will find all packages in the repo which depend on this workspace and checkout a new branch, update the dep version, run yarn install, commit & push to new branch. Generally, this is not necessary.
-- __Optional__: `--tag <tag>` eg `--tag beta` Add a tag to the NPM release. Useful if you want to push a release candidate.
+- **Required**: `<workspace name>`. eg: `@langchain/core` The name of the package to release. Can be found in the `name` value of the package's `package.json`
+- **Optional**: `--bump-deps` eg `--bump-deps` Will find all packages in the repo which depend on this workspace and checkout a new branch, update the dep version, run yarn install, commit & push to new branch. Generally, this is not necessary.
+- **Optional**: `--tag <tag>` eg `--tag beta` Add a tag to the NPM release. Useful if you want to push a release candidate.
 
 This script automatically bumps the package version, creates a new release branch with the changes, pushes the branch to GitHub, uses `release-it` to automatically release to NPM, and more depending on the flags passed.
 
@@ -323,6 +323,10 @@ Similar to linting, we recognize documentation can be annoying. If you do not wa
 
 Documentation and the skeleton lives under the `docs/` folder. Example code is imported from under the `examples/` folder.
 
+**If you are contributing an integration, please copy and use the appropriate template from here:**
+
+https://github.com/langchain-ai/langchainjs/tree/main/libs/langchain-scripts/src/cli/docs/templates
+
 ### Running examples
 
 If you add a new major piece of functionality, it is helpful to add an