Sync fork again

.github/workflows/docs.yaml

@@ -0,0 +1,42 @@
+name: Docs
+
+on:
+  push:
+    tags:
+      - 'langchain-v*.*.*'
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@1d96c772d19495a3b5c517cd2bc0cb401ea0529f
+
+      - name: Setup Pages
+        uses: actions/configure-pages@983d7736d9b0ae728b81ab479565c72886d7745b
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@56afc609e74202658d3ffba0e8f6dda462b719fa
+        with:
+          path: ./docs
+
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@d6db90164ac5ed86f2b6aed7e0febac5b3c0c03e

.github/workflows/test.yaml

@@ -11,33 +11,44 @@ concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
   cancel-in-progress: true
 
-jobs:        
+jobs:
   check:
     name: Run Linter & Unit Tests
     runs-on: ubuntu-latest
     timeout-minutes: 30
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@8ade135a41bc03ea155e62e844d188df1ea18608
+        uses: actions/checkout@1d96c772d19495a3b5c517cd2bc0cb401ea0529f
         with:
           ref: "${{ github.event.pull_request.base.sha }}" # Required for pull_request_target
           fetch-depth: 0
 
       - name: Install Flutter
-        uses: subosito/flutter-action@ed388baf1d5404fd6ef3c54c2f82e6159150b60f
+        uses: subosito/flutter-action@44ac965b96f18d999802d4b807e3256d5a3f9fa1
         with:
           channel: 'stable'
-          flutter-version: '3.13.0'
-          cache: true
 
       - name: Set-up Flutter
         run: |
           flutter config --no-analytics
           dart --disable-analytics
 
+      - name: Clear pub cache
+        run: flutter pub cache clean
+
       - name: Install Melos
-        uses: bluefireteam/melos-action@dd3c344d731938d2ab2567a261f54a19a68b5f6a
+        uses: bluefireteam/melos-action@5a8367ec4b9942d712528c398ff3f996e03bc230
+        with:
+          run-bootstrap: false
+
+      - name: Bootstrap
+        uses: nick-invision/retry@7152eba30c6575329ac0576536151aca5a72780e
+        with:
+          timeout_minutes: 5
+          max_attempts: 5
+          delay_seconds: 5
+          command: melos bootstrap
 
       - name: Run linter
         run: melos lint:diff

.gitignore

@@ -2,6 +2,6 @@
 .idea/
 *.iml
 .dart_tool/
-pubspec.lock
+/pubspec.lock
 .vscode/
 

CONTRIBUTING.md

@@ -219,18 +219,25 @@ software, even patch releases may contain
 To create a release, run:
 
 ```bash
-melos version -V langchain:x.x.x --no-private
+melos version --no-private --no-git-tag-version
+```
+
+Or if you want to define the version manually:
+
+```bash
+melos version -V langchain:x.x.x --no-private --no-git-tag-version
 ```
 
 This command will bump the version in the `langchain` package and all packages that depend on it.
-It will also update the CHANGELOG.md for each package, commit the changes and creates tags.
+It will also update the CHANGELOG.md for each package and commit the changes.
 
-Create a new release on GitHub and copy the CHANGELOG.md content into the release description.
+Update any CHANGELOG.md details if needed. Then create a new release on GitHub and copy the 
+CHANGELOG.md content into the release description.
 
 After that, you can publish the package to pub.dev:
 
 ```bash
-melos publish --no-dry-run
+melos publish --no-dry-run --git-tag-version
 ```
 
 Finally, drop by the [Discord](https://discord.gg/x4qbhqecVR) and let everyone know about the new

README.md

@@ -0,0 +1 @@
+./packages/langchain/README.md

analysis_options.yaml

@@ -7,16 +7,12 @@ analyzer:
     missing_return: error
     todo: ignore
     sdk_version_since: ignore # TODO remove when fixed https://github.com/dart-lang/sdk/issues/52327
-  exclude:
-    - "**/generated_plugin_registrant.dart"
-    - "**/generated/**"
-    - "**/*.gen.dart"
-    - "**/*.g.dart"
 
 linter:
   rules: # https://dart-lang.github.io/linter/lints/{rule}.html
     - always_declare_return_types
     - annotate_overrides
+    - annotate_redeclares
     - avoid_bool_literals_in_conditional_expressions
     #    - avoid_catches_without_on_clauses # blocked on https://github.com/dart-lang/linter/issues/3023
     #    - avoid_catching_errors # blocked on https://github.com/dart-lang/linter/issues/3023
@@ -34,7 +30,7 @@ linter:
     - avoid_null_checks_in_equality_operators
     - avoid_positional_boolean_parameters
     - avoid_print
-    - avoid_redundant_argument_values
+    # - avoid_redundant_argument_values # Sometimes is useful to be explicit
     - avoid_relative_lib_imports
     - avoid_renaming_method_parameters
     - avoid_return_types_on_setters
@@ -141,6 +137,7 @@ linter:
     - prefer_typing_uninitialized_variables
     - prefer_void_to_null
     - provide_deprecation_message
+    - public_member_api_docs
     - recursive_getters
     - require_trailing_commas
     - secure_pubspec_urls